Google Search API

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 and SERP use case.

Endpoint

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

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

{
  "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.

​Endpoint

​Parameters

​Response

​What this API does not do

Endpoint

Parameters

Response

What this API does not do