Core APIs
...
Google
Google Places & Maps

Reviews

3min

Google Place Reviews Results

DESKTOP TABLET MOBILE

Scale SERP parses the Place Reviews results the place_reviews_results array in the JSON output when the search_type=place_reviews request parameter is set and the data_id request parameter is set to a valid data_id as-returned by a search_type=places Places requests.

Google Place Reviews Results
Google Place Reviews Results


Below is an example of how the Place Reviews are represented in the Scale SERP result JSON:

JSON



Scale SERP returns the following properties for search_type=place_reviews requests:

Property

Type

Description

place_reviews_results

array

An array of Place Review result objects, containing each of the Place Review results returned. The Place Review Result object has the following properties:

  • position
  • number
  • The position of the review on the current page of reviews.



  • source
  • string
  • The user name of the user who left the review.



  • source_link
  • string
  • A link to the profile page of the user who left the review.



  • source_image
  • string
  • An image URL to the profile image of the user who left the review.



  • source_id
  • string
  • The ID of the user who left the review.



  • source_review_count
  • number
  • The total number of reviews, of any Place, left by this user.



  • body
  • string
  • The body text of the review.



  • body_html
  • string
  • The HTML of the review body, useful if you wish to preserve HTML formatting.



  • id
  • string
  • The ID of the review.



  • rating
  • number
  • The rating given to the Place by the review author, out of 5.



  • images
  • array
  • An array of image URL strings for each of the user-supplied images left by the reviewer, if shown.



  • date
  • string
  • The raw date of the review.



  • date_utc
  • string
  • The parsed date, in ISO 8601 format, of the review. Note that date parsing relies on the API being able to successfully parse the date and isn't guaranteed in all locales.

place_info

object

  • title
  • string
  • The title of the Place.



  • address
  • string
  • The address of the Place.



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



  • reviews
  • number
  • The number of customer reviews this Place as received.

topics

array

An array of Topic objects. You can take the id of a topic and pass it in to the topic_id parameter of a subsequent search_type=place_reviews request to retrieve place reviews related to that topic.

  • 

    Document image
    



  • keyword
  • string
  • The topic keyword.



  • id
  • string
  • The ID of the topic. Can be passed in to the topic_id parameter of a subsequent search_type=place_reviews request to retrieve place reviews related to that topic.



  • mentions
  • number
  • The number of times the topic is mention in this Places' reviews. Is a relative measure of how much reviewers discuss this topic.

pagination

object

  • next_page_token
  • string
  • A token that can be passed in a subsequent search_type=place_reviews request to provide the next page of Place Reviews results. Note Place 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 place reviews results.


Next Steps      Google Place Reviews Parameters

Updated 13 Aug 2024
Did this page help you?