Core APIs
...
Google
Shopping & Products

Search

3min

Google Shopping Results

DESKTOP TABLET MOBILE

VALUE SERP parses the Google Shopping search results when the search_type=shopping search parameter is set.

Google Shopping Results
Google Shopping Results


Below is an example of how Google Shopping results are represented in the VALUE SERP result JSON:

JSON



VALUE SERP returns the following properties for search_type=shopping requests:







shopping_results

array

An array of Shopping Result objects, containing each of the shopping results shown on the results page. The Shopping Result object has the following properties:

  • position
  • number
  • The position of the shopping result within the current page of results .



  • title
  • string
  • The title of the shopping result.



  • id
  • string
  • The ID of the shopping result. Can be used to request details from an individual product landing page by passing the id value into a subsequent search_type=product requests' product_id parameter. Note the id is only returned when Google show a product landing page link with the shopping result. Regular redirection links, without a individual product landing page, will not have an id property returned as no product landing page exists.



  • link
  • string
  • The link displayed alongside the shopping result. Will be either a link to a individual product landing page (which can be requested by passing the id value into a subsequent search_type=product requests' product_id parameter), or a redirection link directly to the merchants' website. Links to individual product landing pages will contain the string /shopping/product and have the has_product_page property will be set to true . Regular redirection links, without a individual product landing page, will contain the string /aclk and have the has_product_page property set to false .



  • has_product_page
  • boolean
  • Set to true when this shopping result links to an individual product landing page. In this instance the id property can be used in a subsequent search_type=product requests' product_id parameter to request data from the individual product landing page.



  • merchant_count
  • number
  • Shows the number of merchants you can compare prices between, as-shown in the "Compare prices from X retailers" link in the Shopping Results. Omitted if now shown on the Shopping result.



  • price
  • number
  • The price of the merchants' offer as a number.



  • price_raw
  • string
  • The raw price string of the merchants' offer as a number.



  • price_parsed
  • object
  • Price Parsed Object An object containing a parsed version of the merchants' offer price for the shopping result.
    • 
      1. symbol
      2. string
      3. The currency symbol, i.e. $ for USD.
    • 
      1. value
      2. number
      3. The price of the merchant offer.
    • 
      1. currency
      2. string
      3. The currency of the merchant offer as a ISO 4217 currency code. Set to null in the event of the currency not being identifyable on the shopping result page.
    • 
      1. raw
      2. string
      3. The raw text of the merchant offer price, from which the price_parsed object was created.



  • merchant
  • string
  • The merchant name.



  • rating
  • number
  • The customer rating, out of 5, shown next to the shopping result.



  • reviews
  • number
  • The number of customer reviews the shopping result has received.



  • delivery
  • string
  • The delivery text shown next to the shopping result.



  • image
  • string
  • The shopping result image expressed as either an image URL, or a Base-64 encoded image.



  • extensions
  • array
  • An array of strings being the extension text shown next to the shopping result.



  • is_carousel
  • boolean
  • Set to true then the shopping result is displayed in the carousel section at the top or bottom of the shopping results page.



  • carousel_position
  • string
  • When is_carousel=true , carousel_position will be set to top or bottom depending on the location of the carousel that this shopping result is displayed in.

ad_carousel

array

An array of Sponsored Shopping Result objects found within the carousel. The Sponsored Shopping Result object has the following properties:

  • position
  • number
  • The position of the shopping result within the carousel .



  • title
  • string
  • The title of the shopping result.



  • link
  • string
  • The link of the shopping result.



  • price
  • string
  • The price of the merchants' offer as a string $59.98



  • price_parsed
  • object
  • Price Parsed Object An object containing a parsed version of the merchants' offer price for the shopping result.
    • 
      1. symbol
      2. string
      3. The currency symbol, i.e. $ for USD.
    • 
      1. value
      2. number
      3. The price of the merchant offer.
    • 
      1. regular_price
      2. string
      3. The non discounted price
    • 
      1. regular_price_parsed
      2. object
      3. 
        1. 
          1. symbol
          2. string
        2. 
          1. value
          2. number



  • merchant
  • string
  • The merchant name.



  • rating
  • number
  • The customer rating, out of 5, shown next to the shopping result.



  • reviews
  • number
  • The number of customer reviews the shopping result has received.



  • block_position
  • string
  • position of ad carousel on the HTML page

filters

array

An array of filter objects containing name/value pairs for filtering subsequent search_type=shopping requests to just those results matching the given filter.

  • 

    Document image
    



A filter value can be passed into a subsequent search_type=shopping requests' shopping_filter request parameter.

  • name
  • string
  • The name of the filter i.e. Brand .



  • values
  • array
  • Filter Values Object An object containing the filter name and value.
    • 
      1. name
      2. string
      3. The name of the filter i.e. "Sony".
    • 
      1. value
      2. string
      3. The value of the filter. This value can be passed into a subsequent search_type=shopping requests' shopping_filter request parameter to limit results to just those shopping results matching the given filter value.

pagination

object

An object containing details of the pagination section of the page. Details are provided as Google links and API links (to make sending paginated requests easier):

  • current
  • number
  • The current page number, if shown.



  • next
  • string
  • The Google URL of the next page of results.



  • other_pages
  • object
  • An object containing details of the other pages shown on the results page. The object is keyed by the other page number, with the value being the Google URL to the page.



  • api_pagination
  • object
  • An object containing API links to request the next pages of results. Provided as a convenience to allow you to run subsequent requests for additional pages. Contains a next and other_pages property.


Next Steps      Google Shopping Parameters

Updated 14 Oct 2024
Did this page help you?