Google Shopping
GET /google/v1/shoppingGoogle Shopping product cards (title, price, original price and discount, store, delivery, returns, rating, reviews, product id and link) with price, condition, shipping, sale, rating and sort filters (applied to the page's products, as the Shopping tab ignores URL filters), plus the page's facets (price ranges, brands, stores, features, condition). Every /google/v1/search parameter (country, language, location, google_domain, device ...) also applies.
Every response includes credits_used: the credits this call cost. limit (up to 100) loads one results page per 10 results and is charged per page, like /google/v1/search.
Each call costs 6 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
qrequired | string | Search terms. Example: espresso machine |
min_price | number | Minimum price. Example: 100 |
max_price | number | Maximum price. Example: 500 |
condition | new | used | refurbished | new, used or refurbished. |
free_shipping | boolean | 1 for free shipping only. |
on_sale | boolean | 1 for discounted items only. |
rating | integer | Minimum rating, 1-4 stars. Example: 4 |
sort | relevance | price_asc | price_desc | reviews | relevance (default), price_asc, price_desc, reviews. |
country | string | Country code (gl), default us. Example: us |
language | string | Language (hl), default en. Example: en |
location | string | Location to search from. Example: Austin, Texas |
limit | integer | Products wanted. Example: 40 |
Every endpoint also takes: raw、fields、fresh、output、records
{
"ads": [],
"ai_overview": null,
"cached": false,
"credits_used": 1,
"facets": [
{
"name": "Product Rating",
"options": [
"4 and up"
]
},
{
"name": "Capacity",
"options": [
"Under 34 fl oz capacity",
"34 – 40.6 fl oz capacity",
"… 3 more"
]
},
"… 5 more"
],
"featured_snippet": null,
"knowledge_panel": null,
"local_results": [],
"next_page": null,
"next_start": null,
"page": 1,
"pages_fetched": 1,
"people_also_ask": [
"electric kettle"
],
"people_also_ask_detail": [
{
"answer": null,
"href": null,
"question": "electric kettle"
}
],
"query": "electric kettle",
"related_searches": [],
"results": [
{
"catalog_id": "17330922139326061387",
"delivery": null,
"discount": null,
"merchant_url": null,
"more_stores": false,
"offer_id": "17794720785736720487",
"original_price": null,
"original_price_value": null,
"position": 1,
"price": "$203.00",
"price_value": 203,
"product_id": "4700671967028017204",
"rating": null,
"returns": null,
"reviews": null,
"reviews_count": null,
"shelf": "Electric Kettles with Temperature Control",
"store": null,
"summary": "Electric kettle with temperature control. Current Price: $203.00. Newegg.com - westemory. Go to product viewer for this item.",
"title": "Electric kettle with temperature control",
"url": "https://www.google.com/shopping/product/4700671967028017204",
"used": false
},
{
"catalog_id": "1335101039137565609",
"delivery": null,
"discount": null,
"merchant_url": null,
"more_stores": true,
"offer_id": "",
"original_price": null,
"original_price_value": null,
"position": 2,
"price": "$190+",
"price_value": 190,
"product_id": "12639465306701577806",
"rating": 4.7,
"returns": null,
"reviews": "5K",
"reviews_count": 5000,
"shelf": "Electric Kettles with Temperature Control",
"store": "& more",
"summary": "Fellow Stagg EKG Pro Electric Kettle - Matte White w/ Maple. Current Price: $190+. & more. Rated 4.7 out of 5. 5K reviews. Go to product vie…",
"title": "Fellow Stagg EKG Pro Electric Kettle - Matte White w/ Maple",
"url": "https://www.google.com/shopping/product/12639465306701577806",
"used": false
},
"… 8 more"
],
"search_parameters": {
"autocorrect": true,
"country": "us",
"cr": null,
"device": "desktop",
"filter": true,
"google_domain": "google.com",
"language": "en",
"limit": 10,
"location": "United States",
"lr": null,
"q": "electric kettle",
"safe": null,
"start": 0,
"tbs": null,
"type": "shopping"
},
"search_url": "https://www.google.com/search?q=electric+kettle&hl=en&gl=us&uule=w%2BCAIQICINVW5pdGVkIFN0YXRlcw&udm=28",
"spelling": null,
"top_stories": [],
"total": null,
"videos": []
} Response fields (71)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.ads | array |
$.ai_overview | null |
$.cached | boolean |
$.credits_used | integer |
$.facets | array |
$.facets[] | object | string |
$.facets[].name | string |
$.facets[].options | array |
$.facets[].options[] | string |
$.featured_snippet | null |
$.knowledge_panel | null |
$.local_results | array |
$.next_page | null |
$.next_start | null |
$.page | integer |
$.pages_fetched | integer |
$.people_also_ask | array |
$.people_also_ask[] | string |
$.people_also_ask_detail | array |
$.people_also_ask_detail[] | object |
$.people_also_ask_detail[].answer | null |
$.people_also_ask_detail[].href | null |
$.people_also_ask_detail[].question | string |
$.query | string |
$.related_searches | array |
$.results | array |
$.results[] | object | string |
$.results[].catalog_id | string |
$.results[].delivery | null |
$.results[].discount | null |
$.results[].merchant_url | null |
$.results[].more_stores | boolean |
$.results[].offer_id | string |
$.results[].original_price | null |
$.results[].original_price_value | null |
$.results[].position | integer |
$.results[].price | string |
$.results[].price_value | integer |
$.results[].product_id | string |
$.results[].rating | null | number |
$.results[].returns | null |
$.results[].reviews | null | string |
$.results[].reviews_count | integer | null |
$.results[].shelf | string |
$.results[].store | null | string |
$.results[].summary | string |
$.results[].title | string |
$.results[].url | string |
$.results[].used | boolean |
$.search_parameters | object |
$.search_parameters.autocorrect | boolean |
$.search_parameters.country | string |
$.search_parameters.cr | null |
$.search_parameters.device | string |
$.search_parameters.filter | boolean |
$.search_parameters.google_domain | string |
$.search_parameters.language | string |
$.search_parameters.limit | integer |
$.search_parameters.location | string |
$.search_parameters.lr | null |
$.search_parameters.q | string |
$.search_parameters.safe | null |
$.search_parameters.start | integer |
$.search_parameters.tbs | null |
$.search_parameters.type | string |
$.search_url | string |
$.spelling | null |
$.top_stories | array |
$.total | null |
$.videos | array |