Latest Headlines
Get the latest headlines given any topic, country, source or language
get
https://api.newscatcherapi.com
/v2/latest_headlines?countries=US&topic=business
Get Latest Headlines
Parameters
Query
when
string
The time period you want to get the latest headlines for.
Accepted forms:
-
7d => Dailly Form (last 7 days time period), 30d (last 30 days time period)
- 1h => Hourly Form (last hour), 24h (last 24 hours)
Default: The number of historic data available for your subscription planlang
array
Specifies the languages of the search. For example,
en.
The only accepted format is ISO 639-1 — 2 letter code.
Refer to the Allowed Languages section for more details.countries
array
Countries where the news publisher is located.
Important: This parameter is not responsible for the countries mentioned in the news article.
One or multiple countries can be used in the search.
The only acceptable format is ISO 3166-1 alpha-2
For example,
US,CA,MX or just USnot_countries
array
The inverse of the
countries parameter.topic
string
Accepted values:
news, sport,
tech, world, finance,
politics, business, economics, entertainment, beauty, travel, music, food, science, gaming, energy.
The topic to which you want to restrict the articles of your choice.
Not all news articles are assigned with a topic, therefore, we cannot guarantee that 100% of topics talking about technology will be assigned a tech label.sources
array
One or more news resources to filter your search. It should be the normal form of the URL,
For example,
nytimes.com,theguardian.com
not_sources
array
One or more sources to be excluded from the search.
Comma-separated list. For example,
wsj.comranked_only
string
Default:
True
Limit the search only for the sources which are in the top 1 million online websites. Unranked sources are assigned a rank that equals 999999page_size
integer
[1:100] How many articles to return per page.page
integer
The number of the page. Use it to scroll through the results.
This parameter is used to paginate: scroll through results because one API response cannot return more than 100 articles.
Header
x-api-key
string
Your unique authentication token
Responses
200
Success
400: Bad Request
API Call without "x-api-key" in headers
401
Invalid API Key
406: Not Acceptable
Unsupported Parameters
408: Request Timeout
Request Timeout
429: Too Many Requests
Too many API calls
post
https://api.newscatcherapi.com
/v2/latest_headlines
Get Latest Headlines
JSON format query input
Parameters
Query
when
string
The time period you want to get the latest headlines for.
Accepted forms:
-
7d => Dailly Form (last 7 days time period), 30d (last 30 days time period)
- 1h => Hourly Form (last hour), 24h (last 24 hours)
Default: The number of historic data available for your subscription planlang
array
Specifies the languages of the search. For example,
en.
The only accepted format is ISO 639-1 — 2 letter code.
Refer to the Allowed Languages section for more details.countries
array
Countries where the news publisher is located.
Important: This parameter is not responsible for the countries mentioned in the news article.
One or multiple countries can be used in the search.
The only acceptable format is ISO 3166-1 alpha-2
For example,
US,CA,MX or just USnot_countries
array
The inverse of the
countries parameter.topic
string
Accepted values:
news, sport,
tech, world, finance,
politics, business, economics, entertainment, beauty, travel, music, food, science, gaming, energy.
The topic to which you want to restrict the articles of your choice.
Not all news articles are assigned with a topic, therefore, we cannot guarantee that 100% of topics talking about technology will be assigned a tech label.sources
array
One or more news resources to filter your search. It should be the normal form of the URL,
For example,
nytimes.com,theguardian.com
not_sources
array
One or more sources to be excluded from the search.
Comma-separated list. For example,
wsj.comranked_only
string
Default:
True
Limit the search only for the sources which are in the top 1 million online websites. Unranked sources are assigned a rank that equals 999999page_size
integer
[1:100] How many articles to return per page.page
integer
The number of the page. Use it to scroll through the results.
This parameter is used to paginate: scroll through results because one API response cannot return more than 100 articles.
Header
x-api-key
string
Your unique authentication token
Responses
200
Success
400: Bad Request
API Call without "x-api-key" in headers
401
Invalid API Key
406: Not Acceptable
Unsupported Parameters
408: Request Timeout
Request Timeout
429: Too Many Requests
Too many API calls
{'status': 'ok',
'total_hits': 10000,
'page': 1,
'total_pages': 200,
'page_size': 50,
'articles': [{'title': 'BUSINESS BRIEFS: Aug. 18, 2022',
'author': 'Goshen News',
'published_date': '2022-08-18 05:30:00',
'published_date_precision': 'timezone unknown',
'link': 'https://www.mdjonline.com/tribune/georgia/business-briefs-aug-18-2022/article_58e222be-a577-5fbc-808c-726e14edae95.html',
'clean_url': 'mdjonline.com',
'excerpt': 'Aug. 18—Genesis Products to celebrate anniversary GOSHEN — Genesis Products Inc., the largest privately-held components manufacturer of OEM laminated panels, wood components, and custom-moulded…',
'summary': "Country\n\nUnited States of America US Virgin Islands United States Minor Outlying Islands Canada Mexico, United Mexican States Bahamas, Commonwealth of the Cuba, Republic of Dominican Republic Haiti, Republic of Jamaica Afghanistan Albania, People's Socialist Republic of Algeria, People's Democratic Republic of American Samoa Andorra, Principality of Angola, Republic of Anguilla Antarctica (the territory South of 60 deg S) Antigua and Barbuda Argentina, Argentine Republic Armenia Aruba Australia, Commonwealth of Austria, Republic of Azerbaijan, Republic of Bahrain, Kingdom of Bangladesh, People's Republic of Barbados Belarus Belgium, Kingdom of Belize Benin, People's Republic of Bermuda Bhutan, Kingdom of Bolivia, Republic of Bosnia and Herzegovina Botswana, Republic of Bouvet Island (Bouvetoya) Brazil, Federative Republic of British Indian Ocean Territory (Chagos Archipelago) British Virgin Islands Brunei Darussalam Bulgaria, People's Republic of Burkina Faso Burundi, Republic of Cambodia, Kingdom of Cameroon, United Republic of Cape Verde, Republic of Cayman Islands Central African Republic Chad, Republic of Chile, Republic of China, People's Republic of Christmas Island Cocos (Keeling) Islands Colombia, Republic of Comoros, Union of the Congo, Democratic Republic of Congo, People's Republic of Cook Islands Costa Rica, Republic of Cote D'Ivoire, Ivory Coast, Republic of the Cyprus, Republic of Czech Republic Denmark, Kingdom of Djibouti, Republic of Dominica, Commonwealth of Ecuador, Republic of Egypt, Arab Republic of El Salvador, Republic of Equatorial Guinea, Republic of Eritrea Estonia Ethiopia Faeroe Islands Falkland Islands (Malvinas) Fiji, Republic of the Fiji Islands Finland, Republic of France, French Republic French Guiana French Polynesia French Southern Territories Gabon, Gabonese Republic Gambia, Republic of the Georgia Germany Ghana, Republic of Gibraltar Greece, Hellenic Republic Greenland Grenada Guadaloupe Guam Guatemala, Republic of Guinea, Revolutionary People's Rep'c of Guinea-Bissau, Republic of Guyana, Republic of Heard and McDonald Islands Holy See (Vatican City State) Honduras, Republic of Hong Kong, Special Administrative Region of China Hrvatska (Croatia) Hungary, Hungarian People's Republic Iceland, Republic of India, Republic of Indonesia, Republic of Iran, Islamic Republic of Iraq, Republic of Ireland Israel, State of Italy, Italian Republic Japan Jordan, Hashemite Kingdom of Kazakhstan, Republic of Kenya, Republic of Kiribati, Republic of Korea, Democratic People's Republic of Korea, Republic of Kuwait, State of Kyrgyz Republic Lao People's Democratic Republic Latvia Lebanon, Lebanese Republic Lesotho, Kingdom of Liberia, Republic of Libyan Arab Jamahiriya Liechtenstein, Principality of Lithuania Luxembourg, Grand Duchy of Macao, Special Administrative Region of China Macedonia, the former Yugoslav Republic of Madagascar, Republic of Malawi, Republic of Malaysia Maldives, Republic of Mali, Republic of Malta, Republic of Marshall Islands Martinique Mauritania, Islamic Republic of Mauritius Mayotte Micronesia, Federated States of Moldova, Republic of Monaco, Principality of Mongolia, Mongolian People's Republic Montserrat Morocco, Kingdom of Mozambique, People's Republic of Myanmar Namibia Nauru, Republic of Nepal, Kingdom of Netherlands Antilles Netherlands, Kingdom of the New Caledonia New Zealand Nicaragua, Republic of Niger, Republic of the Nigeria, Federal Republic of Niue, Republic of Norfolk Island Northern Mariana Islands Norway, Kingdom of Oman, Sultanate of Pakistan, Islamic Republic of Palau Palestinian Territory, Occupied Panama, Republic of Papua New Guinea Paraguay, Republic of Peru, Republic of Philippines, Republic of the Pitcairn Island Poland, Polish People's Republic Portugal, Portuguese Republic Puerto Rico Qatar, State of Reunion Romania, Socialist Republic of Russian Federation Rwanda, Rwandese Republic Samoa, Independent State of San Marino, Republic of Sao Tome and Principe, Democratic Republic of Saudi Arabia, Kingdom of Senegal, Republic of Serbia and Montenegro Seychelles, Republic of Sierra Leone, Republic of Singapore, Republic of Slovakia (Slovak Republic) Slovenia Solomon Islands Somalia, Somali Republic South Africa, Republic of South Georgia and the South Sandwich Islands Spain, Spanish State Sri Lanka, Democratic Socialist Republic of St. Helena St. Kitts and Nevis St. Lucia St. Pierre and Miquelon St. Vincent and the Grenadines Sudan, Democratic Republic of the Suriname, Republic of Svalbard & Jan Mayen Islands Swaziland, Kingdom of Sweden, Kingdom of Switzerland, Swiss Confederation Syrian Arab Republic Taiwan, Province of China Tajikistan Tanzania, United Republic of Thailand, Kingdom of Timor-Leste, Democratic Republic of Togo, Togolese Republic Tokelau (Tokelau Islands) Tonga, Kingdom of Trinidad and Tobago, Republic of Tunisia, Republic of Turkey, Republic of Turkmenistan Turks and Caicos Islands Tuvalu Uganda, Republic of Ukraine United Arab Emirates United Kingdom of Great Britain & N. Ireland Uruguay, Eastern Republic of Uzbekistan Vanuatu Venezuela, Bolivarian Republic of Viet Nam, Socialist Republic of Wallis and Futuna Islands Western Sahara Yemen Zambia, Republic of Zimbabwe",
'rights': 'mdjonline.com',
'rank': 12284,
'topic': 'business',
'country': 'US',
'language': None,
'authors': 'Goshen News,Ind.',
'media': 'https://bloximages.newyork1.vip.townnews.com/mdjonline.com/content/tncms/custom/image/4df9d750-8f54-11e7-ba56-dfb3dab930d6.jpg?resize=600%2C400',
'is_opinion': False,
'twitter_account': '@mdjonline',
'_score': None,
'_id': '6dc6e2b72f5b3f1c163a95541190ab6c'},
...
],
'user_input': {'lang': None,
'not_lang': None,
'countries': ['US'],
'not_countries': None,
'page': 1,
'size': 50,
'sources': None,
'not_sources': None,
'topic': 'business',
'from': '2019-08-19 05:46:44'}}
Last modified 1mo ago