Core APIs
...
Google
Shopping & Products

Reviews

3min

Google Product Reviews Results

DESKTOP TABLET MOBILE

The Google Product Reviews results are returned when making a request with search_type=product and product_type=reviews to retrieve product reviews results for a given product ID. The product ID is specified in the product_id parameter and you should also specify a location parameter to geo-locate the request (locations can be retrieved via the Locations API).

Google Product IDs are returned by Google Shopping search requests.

Google Product Reviews Results
Google Product Reviews Results


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

JSON



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

Property

Type

Description

product_results

object

  • product_id
  • string
  • The product ID.



  • reviews
  • array
  • Reviews Array An array of objects containing the product reviews.
    • 
      1. position
      2. string
      3. The position of the review on the current page.
    • 
      1. title
      2. string
      3. The title of the review.
    • 
      1. rating
      2. number
      3. The customer rating, out of 5, given alongside the review.
    • 
      1. date
      2. string
      3. The date of the review, as a locale-specific string.
    • 
      1. source
      2. string
      3. The source name of the source of the review.
    • 
      1. provided_by
      2. string
      3. Who the review was provided by, if shown.
    • 
      1. body
      2. object
      3. The body text of the review.



  • overview
  • object
  • Overview Object An object containing overview details of the product to whom the reviews belong.
    • 
      1. rating
      2. number
      3. The customer rating of this product, out of 5.
    • 
      1. review_count
      2. number
      3. The number of customer reviews this product has received.
    • 
      1. per_star
      2. object
      3. 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 .
      4. 

        Document image
        



  • pagination
  • object
  • Pagination Object An object containing pagination details for the product reviews.
    • 
      1. next_page_token
      2. number
      3. A token that can be passed in a subsequent product_type=reviews request to provide the next page of Product Reviews results. Note Product Review results do not contain a traditional pagination section where a specific page of results is uniquely addressable. Instead the next_page_token can be passed in to the next_page_token request parameter to retrieve the next page of Product Reviews results.


Next Steps      Google Product Reviews Parameters

Updated 13 Aug 2024
Did this page help you?