News search, cleaned

Search the news. Keep the useful parts.

One read-only endpoint over a curated English-language corpus. Search title and cleaned snippets, filter by category, publisher and time, or walk the latest articles with a cursor bound to your exact request.

zshclair API
$ curl -G https://clair-news-api.p.rapidapi.com/v1/news \
-H 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
-H 'X-RapidAPI-Host: clair-news-api.p.rapidapi.com' \
--data-urlencode 'q="central bank" OR inflation -sports' \
--data-urlencode 'sort_by=relevance' \
--data-urlencode 'limit=25'
{
"query": "\"central bank\" OR inflation -sports",
"language": "en",
"sort_by": "relevance",
"count": 1,
"items": [
{
"id": "8cbabdf6-31cc-4677-8cf3-a39f8152aa08",
"title": "Central bank signals a slower path for rate cuts",
"url": "https://publisher.example/article",
"source": { "name": "Publisher" },
"description": "Policymakers kept rates unchanged and signaled a slower path for cuts.",
"image_url": "https://publisher.example/rates.jpg",
"authors": ["Reporter Name"],
"language": "en",
"category": "business",
"published_at": "2026-07-29T10:15:30.123456Z",
"collected_at": "2026-07-29T10:16:04.654321Z",
"content": "Policymakers kept rates unchanged and said future moves would depend on incoming inflation data.",
"content_available": true,
"content_truncated": false,
"is_update": false,
"relevance_score": 0.42
}
],
"next_cursor": "eyJ2IjoxLC4uLi"
}
Sources
BBC NewsThe GuardianAl Jazeera EnglishThe New York TimesThe Washington PostBloombergFinancial TimesThe Wall Street JournalThe EconomistCNBCNPRPoliticoAxiosDeutsche Welle (English)France 24 (English)South China Morning PostThe Japan TimesProPublicaArs TechnicaWired

Get started

View docs →
$curl -G https://clair-news-api.p.rapidapi.com/v1/news -H 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' -H 'X-RapidAPI-Host: clair-news-api.p.rapidapi.com' --data-urlencode 'q="central bank" OR inflation -sports' --data-urlencode 'sort_by=relevance' --data-urlencode 'limit=25'

Search title and cleaned content with familiar web-search syntax. Quoted phrases, uppercase OR, and -excluded terms are supported.

Built for production reads

Search behavior you can reason about.

Useful query syntax

Search the way developers already expect: quoted phrases, uppercase OR, minus exclusions, exact source lists, and inclusive RFC 3339 time windows.

Stable synchronization

Opaque cursors preserve database timestamp precision and are fingerprinted to the query, filters, and sort. A cursor from another search is rejected.

Explicit content states

Each item includes description, image, bylines, language and category, plus explicit snippet, publication, collection and revision states.

Access

Call it, understand it, ask for what is missing.

API

Search the corpus

One bounded GET endpoint for both search and chronological sync, metered through the Clair News API listing.

Explore the API →

Documentation

Read the contract

See every query parameter, response field, cursor rule, and stable error code before you integrate.

Read the docs →

Requests

Shape what comes next

Need another publisher, a different field, or a focused data product that is not in the catalog yet? Tell us what you are building.

Get in touch →

Put a clean news feed behind your product.

Search when you need a topic. Walk the cursor when you need everything new.