Skip to main content
GET
Search news or walk the corpus

Authorizations

X-RapidAPI-Key
string
header
required

Your RapidAPI subscription key. Also send X-RapidAPI-Host: clair-news-api.p.rapidapi.com.

Query Parameters

q
string

English full-text query. Supports quoted phrases, uppercase OR, and minus-prefixed exclusions. A stopword-only query returns empty_query.

Required string length: 1 - 300
sources
string

Comma-separated exact names from GET /v1/sources, at most 50. Mutually exclusive with exclude_sources.

Required string length: 1 - 5000
exclude_sources
string

Comma-separated exact names from GET /v1/sources, at most 50. Mutually exclusive with sources.

Required string length: 1 - 5000
from
string<date-time>

Inclusive RFC 3339 lower bound on publisher time.

to
string<date-time>

Inclusive RFC 3339 upper bound on publisher time. Must be later than or equal to from.

sort_by
enum<string>
default:published_at

Result ordering. Relevance sorting requires q.

Available options:
published_at,
relevance
category
enum<string>

Deterministic publisher-section category. Event facets such as elections, crime, conflict, and disasters are queried through q, not represented as mutually exclusive categories.

Available options:
general,
world,
politics,
business,
technology,
science,
health,
sports,
entertainment,
environment
include_edits
enum<string>
default:false

Include later revisions that share a publisher URL. The default returns only canonical records.

Available options:
true,
1,
yes,
false,
0,
no
limit
integer
default:25

Maximum items in this page.

Required range: 1 <= x <= 100
cursor
string

Opaque next_cursor from the preceding page. Reuse it only with the exact query, filters, sort, and revision mode that created it.

Required string length: 1 - 1024

Response

A page of news items.

query
string | null
required

The supplied query, or null for a chronological corpus walk.

Example:

"\"central bank\" OR inflation -sports"

language
enum<string>
required
Available options:
en
sort_by
enum<string>
required
Available options:
published_at,
relevance
count
integer
required

Number of items in this page.

Required range: 0 <= x <= 100
items
object[]
required
next_cursor
string | null
required

Opaque continuation token, or null when this traversal is complete.