google_search
Scrape Google search results including organic listings, ads, AI overview, and knowledge graph data without managing proxies or parsing. Supports pagination, location, and advanced features.
Instructions
Scrapes Google Search results (organic results, ads, AI overview, knowledge graph, local results, and every other SERP feature) for a given query, without needing to manage proxies or parsing. [Credits: 5 (standard search). 10 credits when advance_search=true OR mob_search=true.] Notes: Pagination: the 'page' request parameter is documented as 0-based sequential (0 = page 1, 1 = page 2, ...), but the response's scrapingdog_pagination.page_no map (see pagination doc) shows page values incrementing by 10 per page (page=10 for page 2, page=20 for page 3) — mirroring Google's native 'start' offset. Follow the URLs Scrapingdog returns in response.pagination.page_no / response.scrapingdog_pagination.page_no to fetch subsequent pages rather than hand-computing the page value. advance_search=true unlocks richer/advanced feature snippets (more SERP blocks populated) and doubles credit cost to 10; mob_search=true returns mobile-rendered results and also costs 10 credits; both can presumably be combined. location and uule are mutually exclusive (both control geo-targeting of the search origin). kgmid and si can override most other params (except page/results) to target Knowledge Graph entities/tabs directly. Response shape is dynamic: only the SERP feature blocks actually present on the rendered Google page for that query appear in the JSON (e.g. no ads block if Google didn't show ads). Returns: Top-level JSON containing whichever of the following blocks Google rendered for the query: search_information {time_taken, total_results, query_displayed, organic_results_state, url} — search metadata; organic_results[] {title, link, displayed_link, source, snippet, highlighted_keywords[], extended_sitelinks[]{title,link,snippet}, rank} — standard web listings; ai_overview {text_blocks[...
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cr | No | Restricts search results to specific countries, format countryFR, or multiple with countryFR|countryDE. See Scrapingdog's Supported Google Countries via cr parameter page. | |
| lr | No | Limits search to one or more languages, format lang_en, or multiple with lang_en|lang_fr. See Scrapingdog's Google LR Language Page. | |
| si | No | Cached search parameters of the Google Search to scrape. May override other parameters except page and results. Can be used to scrape Knowledge Graph tabs. | |
| ibp | No | Controls rendering of specific layouts and expansion of certain elements, e.g. gwp;0,7 expands ludocid searches. | |
| tbs | No | Advanced parameter to filter search results, e.g. time ranges or verbatim mode. | |
| uds | No | Filters search results using a filter string provided by Google. | |
| html | No | Returns the full raw HTML of the Google results page instead of/alongside parsed JSON. (default: false) | |
| lsig | No | May be required for the Knowledge Graph map view. Obtainable via the Google Local API or Google My Business redirects. | |
| nfpr | No | Excludes results from auto-corrected (spelling-corrected) queries. 1 = exclude, 0 = include. (default: 0) | |
| page | No | Page number of Google search results. 0 = first page, 1 = second page, and so on. NOTE: the pagination.md doc's example scrapingdog_pagination block instead shows page values incrementing by 10 (page=10 for page 2, page=20 for page 3), matching Google's native 'start' offset semantics — the two docs are inconsistent; treat 0-based sequential page numbers (0,1,2,...) as the documented parameter contract unless testing shows otherwise. (default: 0) | |
| safe | No | Adult-content filtering. active enables SafeSearch, off disables it. (default: off) | |
| uule | No | Encoded geographic location/locale string for tailoring results (e.g. w+CAIQIFJlbGF5IFN0YXRlcw==). Cannot be combined with location. | |
| kgmid | No | ID (KGMID) of a Google Knowledge Graph listing. May override other parameters except page and results. | |
| query | Yes | The search query to execute, exactly like a standard Google search. Supports Google search operators such as inurl:, site:, and intitle:. | |
| domain | No | Google domain to use for localized results, e.g. google.co.in (India), google.co.uk (UK). See Scrapingdog's Google Domains Page for the full list. (default: google.com) | |
| filter | No | Controls whether Google's 'Similar Results' and 'Omitted Results' filters are enabled. 1 (default) = active, 0 = off. (default: 1) | |
| country | No | Two-letter country code for the search (e.g. us, uk, fr). See Scrapingdog's Google Country Parameter page for the full list. (default: us) | |
| ludocid | No | ID (CID) of a Google My Business listing, also called the Google Place ID. | |
| results | No | Number of results to return per page. | |
| language | No | Language of the results (e.g. en, es, fr, de). See Scrapingdog's Google Language Page for the full list. (default: en) | |
| location | No | Origin location the search should be tailored to; city-level granularity recommended. Cannot be combined with uule. | |
| mob_search | No | Returns mobile Google search results instead of desktop. Costs 10 credits per request when true. (default: false) | |
| advance_search | No | Enables advanced/extra feature snippets from Google (fuller SERP feature coverage). Costs 10 credits per request instead of 5 when true. (default: false) |