SCscrapebadger
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

Request

Query parameters

qstring required

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

glstring

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

hlstring

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

numinteger

Results per page

startinteger

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

domainstring

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

devicestring

desktop or mobile

locationstring nullable

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

lrstring nullable

Language restrict (e.g. lang_en)

tbsstring nullable

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

safestring

Safe search (active/off)

uulestring nullable

Encoded location parameter (UULE)

filterinteger nullable

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

nfprinteger

Disable auto-correction (1=exact match)

crstring nullable

Country restrict (e.g. countryUS|countryGB)

ludocidstring nullable

Google My Business CID (place ID)

lsigstring nullable

Knowledge Graph map view ID

kgmidstring nullable

Knowledge Graph entity ID

sistring nullable

Cached search parameters

ibpstring nullable

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

udsstring nullable

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.

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

Successful Response

Changes

No recorded changes to this operation across all 1 revision of this API.