NEnewscatcherapi
BreakingNews

Get breaking news

Returns articles flagged as breaking news within the last 24 hours, grouped into breaking news events: clusters of related articles covering the same story from different sources. Supports filtering by theme, named entities (organizations, people, locations, misc.), sentiment, and source rank.

post/api/breaking_news

Request

  • Base URL
    https://v3-api.newscatcherapi.com (the document declares no server; this is the origin it was published from)
  • Auth
    none declared. Required headers: x-api-token

Headers

x-api-tokenstring required

Your NewsCatcher API key, used to authenticate this request.

Request body

sort_bystring

Sort order for results: 'relevancy' (default, best text match first), 'date' (newest first), '-date' (oldest first), or 'rank' (most authoritative source first).

has_nlpboolean

When true, only returns articles that have NLP enrichment data. Requires an NLP plan.

themestring

Filter by article theme. One of: Business, Politics, Entertainment, Sports, Finance, Crime, Tech, General, Health, Economics, Science, Automotive, Weather, Travel, Lifestyle, Financial Crime. Comma-separated values are OR'd together; values joined with ' AND ' within one comma-separated group must all match the same article (e.g. 'Tech AND Finance,Sports' matches Tech-and-Finance articles, or Sports articles).

not_themestring

Exclude articles with any of the given themes. Same allowed values as theme, but does not support ' AND ' grouping - always excludes on any match.

ORG_entity_namestring

Filter articles that mention the given organization name(s) in NLP-extracted named entities. Requires an NLP plan.

PER_entity_namestring

Filter articles that mention the given person name(s) in NLP-extracted named entities. Requires an NLP plan.

LOC_entity_namestring

Filter articles that mention the given location name(s) in NLP-extracted named entities. Requires an NLP plan.

MISC_entity_namestring

Filter articles that mention the given miscellaneous entity name(s) in NLP-extracted named entities. Requires an NLP plan.

title_sentiment_minnumber

Minimum sentiment score for the article title, from -1 (most negative) to 1 (most positive), as determined by NLP analysis. Requires an NLP plan.

title_sentiment_maxnumber

Maximum sentiment score for the article title, from -1 (most negative) to 1 (most positive), as determined by NLP analysis. Requires an NLP plan.

content_sentiment_minnumber

Minimum sentiment score for the article content, from -1 (most negative) to 1 (most positive), as determined by NLP analysis. Requires an NLP plan.

content_sentiment_maxnumber

Maximum sentiment score for the article content, from -1 (most negative) to 1 (most positive), as determined by NLP analysis. Requires an NLP plan.

Response

Successful Response

statusstring

Always 'ok' for a successful breaking news search.

total_hitsinteger required

Total number of breaking news events matching the request, across all pages.

pageinteger required

Current page number returned.

total_pagesinteger required

Total number of pages available for this query, given page_size.

page_sizeinteger required

Number of breaking news events returned per page.

breaking_news_eventsobject[] required

Breaking news events matching the request, each a cluster of related articles.

user_inputobject required

Echo of the request parameters that produced this response.

Changes

No recorded changes to this operation across all 1 revision of this API.