Latest headlines
Get latest headlines
Latest headlines
Get latest headlines
Retrieves the latest headlines given any topic, country, or language.
POST
/
latest_headlines
curl --request POST \
--url https://api.newscatcherapi.com/v2/latest_headlines \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"when": "12h",
"lang": "en",
"not_lang": "en",
"countries": "<string>",
"not_countries": "<string>",
"topic": "business",
"sources": "nytimes.com,theguardian.com",
"not_sources": "<string>",
"ranked_only": true,
"page_size": 100,
"page": 1
}'
{
"status": "ok",
"total_hits": 123,
"page": 123,
"total_pages": 123,
"page_size": 123,
"articles": [
{
"title": "<string>",
"author": "<string>",
"published_date": "<string>",
"published_date_precision": "<string>",
"link": "<string>",
"clean_url": "<string>",
"excerpt": "<string>",
"summary": "<string>",
"rights": "<string>",
"rank": 123,
"topic": "<string>",
"country": "<string>",
"language": "<string>",
"authors": "<string>",
"is_opinion": true,
"twitter_account": "<string>",
"_score": 123,
"_id": "<string>"
}
],
"user_input": {
"lang": [
"<string>"
],
"not_lang": [
"<string>"
],
"countries": [
"<string>"
],
"not_countries": [
"<string>"
],
"page": 123,
"size": 123,
"sources": [
"<string>"
],
"not_sources": [
"<string>"
],
"topic": "<string>"
}
}
Authorizations
Body
application/json
Response
200
application/json
OK
The response for a successful latest headlines request.
Was this page helpful?
curl --request POST \
--url https://api.newscatcherapi.com/v2/latest_headlines \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"when": "12h",
"lang": "en",
"not_lang": "en",
"countries": "<string>",
"not_countries": "<string>",
"topic": "business",
"sources": "nytimes.com,theguardian.com",
"not_sources": "<string>",
"ranked_only": true,
"page_size": 100,
"page": 1
}'
{
"status": "ok",
"total_hits": 123,
"page": 123,
"total_pages": 123,
"page_size": 123,
"articles": [
{
"title": "<string>",
"author": "<string>",
"published_date": "<string>",
"published_date_precision": "<string>",
"link": "<string>",
"clean_url": "<string>",
"excerpt": "<string>",
"summary": "<string>",
"rights": "<string>",
"rank": 123,
"topic": "<string>",
"country": "<string>",
"language": "<string>",
"authors": "<string>",
"is_opinion": true,
"twitter_account": "<string>",
"_score": 123,
"_id": "<string>"
}
],
"user_input": {
"lang": [
"<string>"
],
"not_lang": [
"<string>"
],
"countries": [
"<string>"
],
"not_countries": [
"<string>"
],
"page": 123,
"size": 123,
"sources": [
"<string>"
],
"not_sources": [
"<string>"
],
"topic": "<string>"
}
}