Google web search
Search Google and get structured results (organic, ads, KG, AI overview, PAA).
Authorizations
Query Parameters
Search query (supports Google operators like site:, inurl:, intitle:)
Country code (e.g. us, gb, de, fr)
Language code (e.g. en, es, fr)
Results per page
1 <= x <= 100Pagination offset (0, 10, 20...)
x >= 0Google domain (e.g. google.com, google.co.uk)
desktop or mobile
City-level geo-targeting (e.g. 'New York, USA')
Language restrict (e.g. lang_en)
Time-based search filter (e.g. qdr:d for past 24h)
Safe search (active/off)
Encoded location parameter (UULE)
Include omitted results (0=show all, 1=filter)
0 <= x <= 1Disable auto-correction (1=exact match)
0 <= x <= 1Country restrict (e.g. countryUS|countryGB)
Google My Business CID (place ID)
Knowledge Graph map view ID
Knowledge Graph entity ID
Cached search parameters
Layout control (e.g. gwp;0,7)
Google filter string
When true, chase Google's deferred AI Overview page_token with a follow-up fetch and merge the result into ai_overview. Adds ~1s and 1 credit when the SERP actually defers the overview.
Response mode. full (default): complete SERP with all blocks (organic, ads, knowledge graph, local pack, AI overview, news, related questions, etc). fast: lite endpoint via gbv=1 that returns ONLY organic results + related searches in ~0.6-1s cold (vs 1.5-2s full). Use when you only need organic results and can skip rich features.
full, fast Response
Successful Response
Response for GET /api/v1/search.
Metadata about the search query.
Pagination metadata.
Google AI Overview (AI-generated summary).
Google increasingly serves the AI Overview as a deferred block — the
initial SERP HTML contains only a placeholder plus a page_token that
the client has to POST back to retrieve the actual content. When that
happens, the SERP parser populates page_token and leaves
text_blocks/references empty. Callers of /v1/google/search can pass
ai_overview=true to have the scraper chase the token automatically and
merge the result back into this object.
Knowledge Graph panel.

