google_shopping
Scrape Google Shopping search results for ads, product listings, prices, and filter facets. Supports pagination and product filtering via helper IDs.
Instructions
Scrapes Google Shopping search results including ads, shopping listings, and available price/filter facets. Each successful request costs 10 credits. [Credits: 10 credits per successful request] Notes: Pagination via page (0-indexed). Product filtering is a two-step flow: read filters[].options[].scrapingdog_link from a response and reuse the shoprs/updated query values it encodes to apply/stack/remove filters. Each shopping result item includes scrapingdog_immersive_product_link, a ready-to-call URL for the Google Immersive Product API (contains the page_token). Returns: { filters: [{type, options: [{text, tbs}]}], ads: [{title, link, source, price, thumbnail}], shopping_results: [{title, product_link, product_id, scrapingdog_immersive_product_link, source, price, extracted_price, old_price_extracted, rating, reviews, extensions[], thumbnail, position}] }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lr | No | Limit search to one or multiple languages, formatted as lang_{language code}, e.g. lang_us. | |
| tbs | No | Advanced parameter ('to be searched') to filter search results. | |
| html | No | Return the response as raw HTML instead of JSON. (default: false) | |
| nfpr | No | Set 1 to exclude auto-corrected/misspelled-query results, 0 to include them. (default: 0) | |
| page | No | Page number of Google search results. 0 = first page, 1 = second page, etc. (default: 0) | |
| safe | No | Adult content filter. Allowed values: active, off. (default: off) | |
| uule | No | Encoded parameter specifying the geographic location/locale to tailor results to, e.g. w+CAIQIFJlbGF5IFN0YXRlcw==. | |
| query | Yes | Any Google query or a complete Google URL. Example: query=shoes | |
| domain | No | Google domain to obtain local results, e.g. google.co.in for India, google.co.uk for the UK. (default: google.com) | |
| shoprs | No | Helper ID used to apply search filters. Must be used together with an updated query (q) that includes the selected filter name alongside the original query, e.g. 'sugar free Coffee'. Obtain the value from filters[index].options[index].scrapingdog_link in the JSON response. Apply multiple filters by following each scrapingdog_link in sequence; each new request retains previously applied filters. Remove a filter by using its associated scrapingdog_link. | |
| country | No | Two-letter country code for the Google Shopping search (e.g. us, uk, fr). (default: us) | |
| language | No | Language of the results, e.g. en, es, fr, de. (default: en) |