Sign in

v1

latestOpenAPI 3.1.02026-07-26180242448.0 KB
Google Search

Google web search

Search Google and get structured results.

Two response modes:

  • full (default, 2 credits): complete SERP with organic, ads, knowledge graph, People Also Ask, AI Overview, local pack, news, related searches, inline videos, etc. ~1.5-2s cold, ~1.5ms warm.
  • fast (1 credit, ~40% faster): lite endpoint (gbv=1) returning only organic results + related searches. Rich blocks (KG, local, AI Overview, news) are not returned — request mode=full for those. Auto-upgrades to full if ai_overview=true is set.

First request in either mode triggers a browser warmup (~15s) to solve SearchGuard. Subsequent requests reuse the sticky session.

get/v1/google/search

Query parameters

qstring required

Search query (supports Google operators like site:, inurl:, intitle:)

Search query (supports Google operators like site:, inurl:, intitle:)

glstring

Country code (e.g. us, gb, de, fr)

Country code (e.g. us, gb, de, fr)

hlstring

Language code (e.g. en, es, fr)

Language code (e.g. en, es, fr)

numinteger

Results per page

Results per page

startinteger

Pagination offset (0, 10, 20...)

Pagination offset (0, 10, 20...)

domainstring

Google domain (e.g. google.com, google.co.uk)

Google domain (e.g. google.com, google.co.uk)

devicestring

desktop or mobile

desktop or mobile

locationstring nullable

City-level geo-targeting (e.g. 'New York, USA')

City-level geo-targeting (e.g. 'New York, USA')

lrstring nullable

Language restrict (e.g. lang_en)

Language restrict (e.g. lang_en)

tbsstring nullable

Time-based search filter (e.g. qdr:d for past 24h)

Time-based search filter (e.g. qdr:d for past 24h)

safestring

Safe search (active/off)

Safe search (active/off)

uulestring nullable

Encoded location parameter (UULE)

Encoded location parameter (UULE)

filterinteger nullable

Include omitted results (0=show all, 1=filter)

Include omitted results (0=show all, 1=filter)

nfprinteger

Disable auto-correction (1=exact match)

Disable auto-correction (1=exact match)

crstring nullable

Country restrict (e.g. countryUS|countryGB)

Country restrict (e.g. countryUS|countryGB)

ludocidstring nullable

Google My Business CID (place ID)

Google My Business CID (place ID)

lsigstring nullable

Knowledge Graph map view ID

Knowledge Graph map view ID

kgmidstring nullable

Knowledge Graph entity ID

Knowledge Graph entity ID

sistring nullable

Cached search parameters

Cached search parameters

ibpstring nullable

Layout control (e.g. gwp;0,7)

Layout control (e.g. gwp;0,7)

udsstring nullable

Google filter string

Google filter string

ai_overviewboolean

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.

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.

mode'full' | 'fast'

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.

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.

Response

Successful Response