NEnewscatcherapi
LatestHeadlines

Get latest headlines

Returns the most recent articles ('headlines') published since a given lookback window, specified via the when parameter, up to now. Supports filtering by language, country, source, and dozens of other parameters; results can optionally be grouped into clusters of similar articles.

post/api/latest_headlines

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

whenstring

How far back to look for headlines, replacing from_/to_ for this endpoint. Format: '<N>d' for N days ago or '<N>h' for N hours ago (e.g. '7d', '24h'). Results run from this point up to now.

sort_bystring

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

langunknown
not_langunknown
countriesunknown
not_countriesunknown
sourcesunknown
predefined_sourcesunknown
not_sourcesunknown
not_author_nameunknown
parent_urlunknown
all_linksunknown
all_domain_linksunknown
all_links_textunknown
clustering_variablestring

Which article field to base clustering similarity on: 'content', 'title', or 'summary'.

include_nlp_databoolean

For NLP-enabled plans, controls whether the nlp object is included in the response for each article (excluded by default). Basic plan always includes nlp.theme regardless of this setting.

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.

iptc_tagsunknown
not_iptc_tagsunknown
iab_tagsunknown
not_iab_tagsunknown

Response

Successful Response

OR

Changes

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