Google News API

Live scrape of news.google.com. Omit q for the home edition, or pass q to search. Thumbnails come from the listing card. Article bodies are not hydrated. This is not Google’s official News API. For cleaned article text across many publishers, use the indexed News API. For a single publisher with body, use Reuters, Bloomberg, or Associated Press. See the product page.

Endpoint

GET /v1/search?engine=google_news · 5 credits

curl -G https://api.clair.im/v1/search \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "engine=google_news" \
  --data-urlencode "q=inflation OR rates" \
  --data-urlencode "language=en" \
  --data-urlencode "country=us"

Parameters

Parameter	Required	Contract
`engine`	yes	Must be `google_news`.
`q`	no	Search query. Omit for the home edition.
`language`	no	ISO 639-1. Default `en`. Maps to Google News `hl`.
`country`	no	ISO 3166-1 alpha-2. Default US edition. Maps to `gl` / `ceid`.
`page`	no	Must be 1. Google News returns one listing page.

Do not send limit, cursor, sources, or exclude_sources.

Response

News items with title, Google News url, source.name, optional image_url, and timestamps. content is null — listing scrape only. next_cursor is always null. Auth, credits, and error codes: Authentication.

Indexed news

Live publishers

Google News API

Endpoint

Parameters

Response

​Endpoint

​Parameters

​Response

Endpoint

Parameters

Response