> ## Documentation Index
> Fetch the complete documentation index at: https://clair.im/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google News API

> Google News API for live headlines from news.google.com. Optional q searches the edition. language and country select hl/gl. One listing page per call.

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](/docs/news-api/introduction). For a single
publisher with body, use [Reuters](/docs/news-api/reuters),
[Bloomberg](/docs/news-api/bloomberg), or [Associated Press](/docs/news-api/ap).

See the [product page](https://clair.im/dashboard/apis/google-news).

## Endpoint

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

```sh theme={null}
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](/docs/authentication).