Google Search

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.

get/search

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/search
  • Auth: API key in header X-API-KEY

Query parameters

querystring required

Required

locationstring nullable

Geographic location for the search (e.g. "Berlin, Germany"). Cannot be combined with uule.

uulestring nullable

Encoded location (deprecated; supported)

google_domainstring nullable

Google domain (e.g., google.de)

glstring nullable

Country code (e.g., us, de, fr; default: us, or none with proxy_country)

crstring nullable

Restrict results to countries (e.g., countryUS|countryDE)

hlstring nullable

Interface language code (2 letters, e.g. en, de). Defaults to en.

lrstring nullable

Restrict results to language (e.g., lang_en)

ludocidstring nullable

Google local business identifier used to target a specific listing.

lsigstring nullable

Knowledge graph map signature

kgmidstring nullable

Knowledge graph entity ID (e.g., /g/11b6gq7c8p)

sistring nullable

Encrypted cached search parameters

ibpstring nullable

Controls rendering layouts and expansions

udsstring nullable

Google-provided filter strings

oqstring nullable

Original Google query value, passed through and encoded once in the upstream URL.

sclientstring nullable

Google search client identifier, passed through and encoded once in the upstream URL.

gs_lpstring nullable

Opaque Google SERP context value, passed through and encoded once in the upstream URL.

tbsstring nullable

Advanced Google filter string (e.g. qdr:d to restrict to the past day).

as_qdrstring nullable

Simple time range filter (e.g., d, w, m, y)

safe'active' | 'off' | 'null' nullable

Safe search mode (active, off)

nfprinteger nullable

Exclude auto-corrected results (0 or 1)

filterinteger nullable

Enable/disable similar/omitted filters (0 or 1)

tbm'isch' | 'vid' | 'nws' | 'lcl' | 'shop' | 'pts' | 'null' nullable

Search vertical: isch (images), vid (videos), nws (news), lcl (local), shop (shopping) or pts (patents). Omit for web results.

udminteger nullable

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.

startinteger nullable

Result offset for pagination (0-indexed)

include_thumbnails'0' | '1' | 'true' | 'false' | 'null' nullable

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.

pageinteger nullable

0-based page number (0-100): 0 is the first page and 1 is the second. Prefer start for new integrations.

amountinteger nullable

Results per page (1-10, may return fewer)

device'desktop' | 'tablet' | 'mobile' | 'null' nullable
proxy_country'pl' | 'null' nullable

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

knowledge_graphobject nullable required
twitter_cardobject nullable required
inline_videosobject[] required
inline_imagesobject[] required
local_mapobject nullable required
popular_productsobject[] nullable required
perspectivesobject[] nullable required
nutrition_informationobject nullable required
refine_this_searchobject[] nullable required
organic_results_countinteger required
total_resultsinteger nullable required
engine_usedstring required
service_usedstring required
cachedboolean

Changes

No recorded changes to this operation across all 3 revisions of this API.