Core APIs
...
Google
Shopping & Products

Product

3min

Google Product Results

DESKTOP TABLET MOBILE

VALUE SERP parses Google Product results in the JSON output when search_type=product and a Google Product ID is supplied in the product_id request parameter.

Google Product IDs are returned by Google Shopping search requests.

Google Product Results
Google Product Results


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

JSON



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

Property

Type

Description

product_results

object

An object representing the product returned from the Google Product page:

  • product_id
  • string
  • The product ID of the product. In most cases this will match the product_id request parameter, but in the case of Google redirecting to another product it may differ.



  • title
  • string
  • The title of the product.



  • rating
  • number
  • The customer rating of the product, out of 5.



  • reviews
  • number
  • The number of customer reviews the product has received. To retrieve customer product reviews use a Product Reviews request.



  • per_star
  • object
  • An object showing the number of customer reviews at each star rating this product has received. Contains the following properties one_star , two_star , three_star , four_star and five_star .
    • 

      Document image
      



  • highlights
  • array
  • An array of strings containing the bulletpoint highlights shown next to the product result.
    • 

      Document image
      



  • description
  • string
  • The description of the product.



  • primary_image
  • string
  • An image URL to the primary product image.



  • images
  • array
  • An array of strings containing all of the product image URLs shown on the product page.



  • image
  • string
  • The thumbnail image of the video result, either returned as a URL to the image, or as a Base64-encoded image string.



  • specifications
  • array
  • Specifications Array An array of objects containing the product specifications shown on the product page. Further specifications are available on the dedicated product specifications page which can be accessed by making a Product Specifications request.
    • 
      1. id
      2. string
      3. The ID of the product specification. Note that this is a language-specific ID.
    • 
      1. name
      2. string
      3. The name of the product specification.
    • 
      1. id
      2. string
      3. The value of the product specification.



  • features
  • array
  • Feature Array An array of objects containing the product features.
    • 
      1. name
      2. string
      3. The name of the product feature.
    • 
      1. id
      2. string
      3. The value of the product feature.



  • related_products
  • array
  • Related Products Array An array of objects containing the related products shown at the bottom of the product page.
    • 
      1. title
      2. string
      3. The name of the related product.
    • 
      1. image
      2. string
      3. An image URL to the primary image of the related product.
    • 
      1. link
      2. string
      3. A link to the Google product landing page for the related product, if shown.
    • 
      1. product_id
      2. string
      3. The product ID of the related product.
    • 
      1. rating
      2. number
      3. The customer rating of the related product, out of 5.
    • 
      1. reviews
      2. number
      3. The number of reviews the related product has received.
    • 
      1. price_raw
      2. string
      3. The raw price of the related product.
    • 
      1. price_parsed
      2. object
      3. An object showing the parsed price of the related product. Parsing is locale-specific and may not be universal or available across all locales. Contains the following properties: currency (the 3-letter currency code), symbol (the currency symbol), value (the parsed number-value of the price), raw (the raw string representation of the price).



  • sellers_online
  • array
  • Online Sellers Object An array of objects containing the online seller offers as-shown on the product page. Further online seller offers are available on the dedicated product online sellers page which can be accessed by making a Product Online Sellers request.
    • 
      1. position
      2. string
      3. The position of the online seller offer on the current page.
    • 
      1. merchant
      2. string
      3. The merchant name of the merchant.
    • 
      1. link
      2. string
      3. A link to the website of the merchant, note that this is typically shown as a tracking link (instead of a direct link to the merchant website).
    • 
      1. base_price_raw
      2. string
      3. The raw base price string as shown next to the seller offer. The base price is typically the price before shipping and tax.
    • 
      1. base_price_parsed
      2. object
      3. An object showing the parsed base price. Parsing is locale-specific and may not be universal or available across all locales. Contains the following properties: currency (the 3-letter currency code), symbol (the currency symbol), value (the parsed number-value of the price), raw (the raw string representation of the price).
    • 
      1. shipping_price_raw
      2. string
      3. The raw shipping price string as shown next to the seller offer.
    • 
      1. shipping_price_parsed
      2. object
      3. An object showing the parsed shipping price.
    • 
      1. tax_price_raw
      2. string
      3. The raw tax price string as shown next to the seller offer.
    • 
      1. tax_price_parsed
      2. object
      3. An object showing the parsed tax price.
    • 
      1. total_price_raw
      2. string
      3. The raw total price string as shown next to the seller offer.
    • 
      1. total_price_parsed
      2. object
      3. An object showing the parsed total price.



  • typical_prices_across_web
  • array
  • 
    • 

      Document image
      
    • 
      1. low_price
      2. string
      3. The low price of the Typical Prices Across the Web section.
    • 
      1. low_price_parsed
      2. object
      3. An object showing the parsed price of the low value from the Typical Prices Across the Web section.
    • 
      1. high_price
      2. string
      3. The high price of the Typical Prices Across the Web section.
    • 
      1. high_price_parsed
      2. object
      3. An object showing the parsed price of the high value from the Typical Prices Across the Web section.


Next Steps      Google Product Parameters

Updated 13 Aug 2024
Did this page help you?