Search APIs
Loading…
← API Store
Search & SEO

Google

Google

Google Shopping

GET /google/v1/shopping
Test this endpoint

Google 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

NameTypeDescription
qrequiredstringSearch terms. Example: espresso machine
min_pricenumberMinimum price. Example: 100
max_pricenumberMaximum price. Example: 500
conditionnew | used | refurbishednew, used or refurbished.
free_shippingboolean1 for free shipping only.
on_saleboolean1 for discounted items only.
ratingintegerMinimum rating, 1-4 stars. Example: 4
sortrelevance | price_asc | price_desc | reviewsrelevance (default), price_asc, price_desc, reviews.
countrystringCountry code (gl), default us. Example: us
languagestringLanguage (hl), default en. Example: en
locationstringLocation to search from. Example: Austin, Texas
limitintegerProducts 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
$.adsarray
$.ai_overviewnull
$.cachedboolean
$.credits_usedinteger
$.facetsarray
$.facets[]object | string
$.facets[].namestring
$.facets[].optionsarray
$.facets[].options[]string
$.featured_snippetnull
$.knowledge_panelnull
$.local_resultsarray
$.next_pagenull
$.next_startnull
$.pageinteger
$.pages_fetchedinteger
$.people_also_askarray
$.people_also_ask[]string
$.people_also_ask_detailarray
$.people_also_ask_detail[]object
$.people_also_ask_detail[].answernull
$.people_also_ask_detail[].hrefnull
$.people_also_ask_detail[].questionstring
$.querystring
$.related_searchesarray
$.resultsarray
$.results[]object | string
$.results[].catalog_idstring
$.results[].deliverynull
$.results[].discountnull
$.results[].merchant_urlnull
$.results[].more_storesboolean
$.results[].offer_idstring
$.results[].original_pricenull
$.results[].original_price_valuenull
$.results[].positioninteger
$.results[].pricestring
$.results[].price_valueinteger
$.results[].product_idstring
$.results[].ratingnull | number
$.results[].returnsnull
$.results[].reviewsnull | string
$.results[].reviews_countinteger | null
$.results[].shelfstring
$.results[].storenull | string
$.results[].summarystring
$.results[].titlestring
$.results[].urlstring
$.results[].usedboolean
$.search_parametersobject
$.search_parameters.autocorrectboolean
$.search_parameters.countrystring
$.search_parameters.crnull
$.search_parameters.devicestring
$.search_parameters.filterboolean
$.search_parameters.google_domainstring
$.search_parameters.languagestring
$.search_parameters.limitinteger
$.search_parameters.locationstring
$.search_parameters.lrnull
$.search_parameters.qstring
$.search_parameters.safenull
$.search_parameters.startinteger
$.search_parameters.tbsnull
$.search_parameters.typestring
$.search_urlstring
$.spellingnull
$.top_storiesarray
$.totalnull
$.videosarray