Search Google Shopping
zenserp_shopping_searchDestructive
Google Shopping listings for a query: product, price, merchant, rating, and the product_id for zenserp_shopping_product. SPENDS 1 request of the monthly quota per successful call (failed calls are not charged); do not repeat a call needlessly. GET /v2/search (tbm=shop).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | The query. | |
| gl | No | Country (gl), two letters, e.g. us, de, gb. zenserp_list_countries lists the supported codes. Default: United States. | |
| hl | No | Interface language (hl), e.g. en, de, pt-BR. zenserp_list_languages lists the supported codes. | |
| lr | No | Limit results to these languages (lr), prefixed with lang_ and joined by |, e.g. lang_fr. | |
| tbs | No | Google 'tbs' filter string for what the query field cannot express, e.g. qdr:w (past week). | |
| cache | No | true = serve a stored copy when one exists (kept 24 h, NOT charged) and store the reply when not. Default false: every call is fetched live and charged. | |
| start | No | Result offset: 0 (default) first page, 10 second page, 20 third page ... Google serves about 300 results per query. | |
| device | No | Device to emulate. | |
| fields | No | Only return these top-level keys of the reply (for example organic, paid_results, related_searches). Saves context; the call is charged the same. | |
| location | No | Geolocation of the search, in Google's canonical form, e.g. 'Manhattan,New York,United States' (see zenserp_search_locations). Set it when the result depends on place, especially ads. |