Search news
Keyword-first search and newest-first corpus traversal with source, time, revision, sort, and cursor controls.
Authorizations
Your RapidAPI subscription key. Also send X-RapidAPI-Host: clair-news-api.p.rapidapi.com.
Query Parameters
English full-text query. Supports quoted phrases, uppercase OR, and minus-prefixed exclusions. A stopword-only query returns empty_query.
1 - 300Comma-separated exact names from GET /v1/sources, at most 50. Mutually exclusive with exclude_sources.
1 - 5000Comma-separated exact names from GET /v1/sources, at most 50. Mutually exclusive with sources.
1 - 5000Inclusive RFC 3339 lower bound on publisher time.
Inclusive RFC 3339 upper bound on publisher time. Must be later than or equal to from.
Result ordering. Relevance sorting requires q.
published_at, relevance Deterministic publisher-section category. Event facets such as elections, crime, conflict, and disasters are queried through q, not represented as mutually exclusive categories.
general, world, politics, business, technology, science, health, sports, entertainment, environment Include later revisions that share a publisher URL. The default returns only canonical records.
true, 1, yes, false, 0, no Maximum items in this page.
1 <= x <= 100Opaque next_cursor from the preceding page. Reuse it only with the exact query, filters, sort, and revision mode that created it.
1 - 1024Response
A page of news items.
The supplied query, or null for a chronological corpus walk.
"\"central bank\" OR inflation -sports"
en published_at, relevance Number of items in this page.
0 <= x <= 100Opaque continuation token, or null when this traversal is complete.