> ## 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 Search API

> Organic Google Search API for developers. Live scrape of google.com/search with 10 results per page. Ads and /url?q= wrappers stripped. Pass page for the next SERP.

Live scrape of public **google.com/search**. Returns organic hits only — ads,
chrome, and `/url?q=` wrappers are stripped. Google's reliable page size is
**10**. Each page is a billed 5-credit request.

This is not Google's official Custom Search API, and it is not a full SERP
archive. Use it for retrieval, monitoring, and research over the current
public listing.

See the [product page](https://clair.im/dashboard/apis/google-search) and
[SERP use case](https://clair.im/resources/use-cases/serp-search).

## Endpoint

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

```sh theme={null}
curl -G https://api.clair.im/v1/search \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "engine=google_search" \
  --data-urlencode "q=site:imf.org inflation" \
  --data-urlencode "country=us" \
  --data-urlencode "page=1"
```

## Parameters

| Parameter  | Required | Contract                                                               |
| ---------- | -------- | ---------------------------------------------------------------------- |
| `engine`   | yes      | Must be `google_search`.                                               |
| `q`        | yes      | Search query. Supports operators such as `site:`.                      |
| `language` | no       | ISO 639-1 interface language (`hl`). Default `en`.                     |
| `country`  | no       | ISO 3166-1 alpha-2 results country (`gl`). Default `us`.               |
| `page`     | no       | 1-based SERP page. Default 1, max 10. Do not send `limit` or `cursor`. |

`page=10` is Google `start=90`. Sending `limit` or `cursor` returns
`locked_parameter`.

## Response

```json theme={null}
{
  "engine": "google_search",
  "family": "news",
  "query": {
    "q": "inflation",
    "language": "en",
    "country": "us",
    "page": 1
  },
  "count": 1,
  "results": [
    {
      "position": 1,
      "title": "CPI Inflation Calculator",
      "url": "https://www.bls.gov/data/inflation_calculator.htm",
      "displayed_url": "www.bls.gov › data › inflation_calculator",
      "snippet": "The CPI inflation calculator uses the Consumer Price Index to adjust dollar values."
    }
  ],
  "next_cursor": null
}
```

`position` is 1-based across pages (page 2 starts at 11). `next_cursor` is
always null — pass `page=2` for the next 10 hits.

## What this API does not do

* It does not return ads, People Also Ask, or knowledge panels.
* It does not accept an arbitrary URL to crawl.
* It does not paginate with `limit` / `cursor`.

Auth, credits, and error codes: [Authentication](/docs/authentication).