Search articles

Start of the date range (inclusive). Accepts natural-language and common date formats (e.g. 'YYYY/mm/dd', 'YYYY/mm/dd HH:MM:SS', '1 day ago'). Defaults to 7 days ago at midnight UTC if omitted.

End of the date range (inclusive). Accepts natural-language and common date formats (e.g. 'YYYY/mm/dd', 'YYYY/mm/dd HH:MM:SS', '1 day ago'). Defaults to now if omitted.

When true, the date range and sorting apply to the date NewsCatcher parsed/ingested the article instead of its published date.

When true, only returns articles from sources that have a known rank (excludes unranked sources).

Minimum source rank (lower rank = more authoritative/popular source). Integer between 1 and 999999.

Maximum source rank (lower rank = more authoritative/popular source). Integer between 1 and 999999.

Filter by whether the article was featured as a headline on its source's homepage at the time of parsing.

Filter by whether the article is opinion/editorial content.

Filter by whether the article is behind a paywall or marked as sponsored/paid content.

Minimum article word count. Must be non-negative, and less than word_count_max if both are set.

Maximum article word count. Must be non-negative, and greater than word_count_min if both are set.

Page number of results to return, starting at 1.

Number of articles per page. Integer between 1 and 1000.

When true, groups similar articles into clusters in the response instead of returning a flat list. A single request's date range cannot span both before and after 2026-01-01, since clustering uses different embeddings on either side of that date.

Similarity threshold for clustering, greater than 0 and up to 1 inclusive. Higher values require greater similarity to group articles into the same cluster.

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.

Excludes duplicate articles from results, keeping only the original publisher's version. Only available for English articles published on or after 2024-05-13, and non-English articles published on or after 2025-03-17.

Includes extra domain-level information (e.g. traffic/audience data) for each article's source, where available.

Filter by whether the domain is classified as a genuine news domain, as opposed to e.g. a blog, forum, or non-news site.

Includes machine-translated title/content fields (title_translated_en, content_translated_en) in the response for non-English articles. Automatically enabled if search_in includes a '_translated' field.

Filter by whether the source's robots.txt permitted content extraction: true returns only compliant articles, false returns only non-compliant ones.