Search Google
Perform a Google search and get structured results including organic results, related searches, knowledge graphs, and more.
Identical searches repeated within one hour are served from cache for free and carry cached: true; add no_cache=true to force a fresh search.
Request
- Base URL: https://scrappa.co/api
- URL: https://scrappa.co/api/search
- Auth: API key in header X-API-KEY
Query parameters
Required
Geographic location for the search (e.g. "Berlin, Germany"). Cannot be combined with uule.
Encoded location (deprecated; supported)
Google domain (e.g., google.de)
Country code (e.g., us, de, fr; default: us, or none with proxy_country)
Restrict results to countries (e.g., countryUS|countryDE)
Interface language code (2 letters, e.g. en, de). Defaults to en.
Restrict results to language (e.g., lang_en)
Google local business identifier used to target a specific listing.
Knowledge graph map signature
Knowledge graph entity ID (e.g., /g/11b6gq7c8p)
Encrypted cached search parameters
Controls rendering layouts and expansions
Google-provided filter strings
Original Google query value, passed through and encoded once in the upstream URL.
Google search client identifier, passed through and encoded once in the upstream URL.
Opaque Google SERP context value, passed through and encoded once in the upstream URL.
Advanced Google filter string (e.g. qdr:d to restrict to the past day).
Simple time range filter (e.g., d, w, m, y)
Safe search mode (active, off)
Exclude auto-corrected results (0 or 1)
Enable/disable similar/omitted filters (0 or 1)
Search vertical: isch (images), vid (videos), nws (news), lcl (local), shop (shopping) or pts (patents). Omit for web results.
Set 14 to request Google's Web tab: plain web results without AI overview, related questions and other modules. Use it for site: searches, where the default tab can mix in other sites on later pages. Cannot be combined with tbm.
Result offset for pagination (0-indexed)
Set 1 to add each news card image (tbm=nws) as a base64 data: URI in thumbnail_base64 (about 2-6 KB per article). Off by default; Google only ships these images inline, so thumbnail stays null.
0-based page number (0-100): 0 is the first page and 1 is the second. Prefer start for new integrations.
Results per page (1-10, may return fewer)
Run the search from an exit IP in this country. Only pl (Poland) is supported; any other value returns 422. The search uses Polish IPs only and never falls back to another country: when no Polish route is available the request fails with 503 and is not charged. Without gl, Google picks the country from the IP (no default gl=us is added). Requests with this parameter use more credits than a standard search. Available on request, contact support to enable it for your account.
Response
Changes
No recorded changes to this operation across all 3 revisions of this API.