Google Search API reference

Live scrape of public google.com/search. One results page per request, parsed into organic hits and every SERP section Google shows on it. Ads are dropped. Google hides result links behind redirects; Clair resolves them, so url is the real destination. Google’s page size is 10. Each page is one billed 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 Google Search API: overview, pricing, and free tier and SERP use case.

Endpoint

GET /v1/google-search · 1 request

curl -G https://api.clair.im/v1/google-search \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "q=albert einstein" \
  --data-urlencode "country=us" \
  --data-urlencode "page=1"

Parameters

Parameter	Required	Contract
`q`	yes	Search query. Supports operators such as `site:`.
`language`	no	ISO 639-1 interface language. Default `en`.
`country`	no	ISO 3166-1 alpha-2 country the search is made from. 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": "search",
  "query": { "q": "albert einstein", "language": "en", "country": "us", "page": 1 },
  "count": 9,
  "results": [
    {
      "position": 1,
      "title": "Albert Einstein",
      "url": "https://en.wikipedia.org/wiki/Albert_Einstein",
      "source": "Wikipedia",
      "displayed_url": "https://en.wikipedia.org › wiki › Albert_Einstein",
      "date": null,
      "snippet": "Albert Einstein (14 March 1879 – 18 April 1955) was a German-born theoretical physicist ...",
      "sitelinks": []
    }
  ],
  "knowledge_graph": {
    "title": "Albert Einstein",
    "type": "Theoretical physicist",
    "description": "Albert Einstein was a German-born theoretical physicist ...",
    "description_source": { "title": "Wikipedia", "url": "https://en.wikipedia.org/wiki/Albert_Einstein" },
    "facts": { "Born": "March 14, 1879, Ulm, Germany" }
  },
  "people_also_ask": ["What is Einstein famous for?"],
  "related_searches": ["Albert Einstein quotes"],
  "local_results": [],
  "videos": [
    {
      "position": 1,
      "title": "Who Was Albert Einstein? Facts for Kids",
      "url": "https://www.youtube.com/watch?v=nEaFtXEYJn0",
      "platform": "YouTube",
      "channel": "Hey! Guess What",
      "date": "Oct 17, 2022",
      "duration": "8:47"
    }
  ],
  "next_cursor": null
}

Field	Contents
`results[]`	Organic hits: `position`, `title`, `url`, `source`, `displayed_url`, `date`, `snippet`, `sitelinks[]` (`title`, `url`).
`knowledge_graph`	Entity panel: `title`, `type`, `description`, `description_source`, and `facts` (label to value). `null` when Google shows none.
`people_also_ask`	Questions in the People also ask box.
`related_searches`	Queries under “People also search for”.
`local_results[]`	Map pack: `name`, `rating`, `reviews`, `price`, `type`, `address`, `snippet`.
`videos[]`	Video carousel: `title`, `url`, `platform`, `channel`, `date`, `duration`.

position is 1-based across pages (page 2 starts at 11). next_cursor is always null — pass page=2 for the next 10 hits. A section Google does not show for the query comes back null or empty.

What this API does not do

It does not return ads or the AI overview.
It does not accept an arbitrary URL to crawl.
It does not paginate with limit / cursor.

Auth, plans, rate limits, and error codes: Authentication.

​Endpoint

​Parameters

​Response

​What this API does not do

Endpoint

Parameters

Response

What this API does not do