Google Search

Search Google Advanced

The ranked response keeps existing result collections and adds a canonical DOM-ordered reference list for paid cards, local modules, and organic cards. Shopping modules are additive: shops lists the shop cards of a shops block and price_comparison_sites the comparison sites (name, domain, link) of a price comparison block; both get a serp_results entry (shops, price_comparison, popular_products) so rank_absolute shows their place on the page. An organic result can carry products (offers with title, link, rating, reviews, price, extracted_price), rating, reviews and extensions (short lines such as return terms) when Google shows them. related_searches also covers the related block at the bottom of the page. Text ads are detected by their markup, so ads is filled on every Google language (for example "Wyniki sponsorowane" or "Gesponsert"). Each ad has block (top or bottom: above or below the organic results), link (the advertiser landing page without Google click-tracking parameters; the site root when Google hides the landing page), tracking_link (the Google click URL), displayed_link, domain, source (advertiser name as shown), snippet and sitelinks (title and link; a sitelink whose destination Google hides has tracking_link instead of link) when shown. shopping_ads lists the product listing ads of the shopping carousel (title, link, price, extracted_price, old_price, merchant, source, rating, reviews, extensions such as shipping costs); the carousel gets one serp_results entry of type shopping_ads. link is the merchant URL when Google exposes it, otherwise the Google click URL. Local places expose external business URLs as website, or a sanitized Google /searchviewer URL as detail_url when no business website is available. Resolve detail_url with GET /api/search-advanced/place (separately billed).

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-advanced

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/search-advanced
  • 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

Google local listing signature, used with ludocid to target one listing.

kgmidstring nullable

Google Knowledge Graph machine ID of the entity to target (e.g. /m/0dr90d).

sistring nullable

Opaque Google search context token, passed through unchanged.

ibpstring nullable

Opaque Google interface parameter, passed through unchanged.

udsstring nullable

Opaque Google filter token from a previous result page, passed through unchanged.

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 (default: 1). Set 0 to allow auto-correction; results for a different query are rejected.

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

Device used to fetch results: desktop (default), tablet, or mobile.

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

search_informationobject required
search_urlstring required
related_searchesobject[] required
people_also_search_forobject[] required
related_questionsobject[] required
things_to_knowobject[] required
knowledge_graphobject nullable required
see_results_aboutobject 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
answer_boxobject nullable required
ai_overviewobject nullable required
top_storiesobject[] required
videosobject[] required
shopping_resultsobject[] required
events_resultsobject[] required
recipes_resultsobject[] required
immersive_productsobject[] required
filtersobject[] required
paginationobject[] 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 4 revisions of this API.