Google Maps Reviews API

Our Google Maps Reviews API allows you to scrape reviews from Google Maps. The API is accessed through the following endpoint: /search?engine=google_maps_reviews. A user may query the following: https://serpapi.com/search?engine=google_maps_reviews utilizing a GET request. Head to the playground for a live and interactive demo.

API Parameters

Search Query

data_id

Required

Parameter defines the Google Maps data ID. Find the data ID by using our Google Maps API.

Localization

hl

Optional

Parameter defines the language to use for the Google Maps Reviews search. It's a two-letter language code, for example, en for English (default), es for Spanish, or fr for French). Head to the Google languages page for a full list of supported Google languages.

Advanced Google Maps Reviews Parameters

sort_by

Optional

Parameter is used for sorting and refining results. Available options:

qualityScore - the most relevant reviews.
newestFirst - the most recent reviews.
ratingHigh - the highest rating reviews.
ratingLow - the lowest rating reviews.

topic_id

Optional

Parameter defines the ID of the topic you want to use for filtering reviews. You can access IDs inside our structured JSON response.

Pagination

next_page_token

Optional

Parameter defines the next page token. It is used for retrieving the next page results.
Usage of start parameter (results offset) has been deprecated by Google.

Serpapi Parameters

engine

Required

Set parameter to google_maps_reviews to use the Google Maps Reviews API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the Google Maps Reviews results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.

API Results

JSON Results

JSON output includes structured data for place information, topics, and reviews results.

A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, the error will contain an error message. search_metadata.id is the search ID inside SerpApi.

HTML Results

HTML output is useful to debug JSON results or support features not supported yet by SerpApi.
HTML output gives you the raw HTML results from Google.

API Examples

Results for: Gregorys Coffee

Results for: Gregorys Coffee

JSON Example

{
  "search_metadata": {
    "id": "6329a4d2de983400a81515c3",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/1b76cd5c6fa9d494/6329a4d2de983400a81515c3.json",
    "created_at": "2022-09-20 11:32:34 UTC",
    "processed_at": "2022-09-20 11:32:34 UTC",
    "google_maps_reviews_url": "https://www.google.com/async/reviewDialog?hl=en&async=feature_id:0x89c259af336b3341:0xa4969e07ce3108de,sort_by:,next_page_token:,associated_topic:,_fmt:pc",
    "raw_html_file": "https://serpapi.com/searches/1b76cd5c6fa9d494/6329a4d2de983400a81515c3.html",
    "total_time_taken": 1
  },
  "search_parameters": {
    "engine": "google_maps_reviews",
    "data_id": "0x89c259af336b3341:0xa4969e07ce3108de",
    "hl": "en"
  },
  "place_info": {
    "title": "Gregorys Coffee",
    "address": "874 6th Ave, New York, NY, United States",
    "rating": 4.2,
    "reviews": 999
  },
  "topics": [
    {
      "keyword": "starbucks",
      "mentions": 50,
      "id": "/m/018c_r"
    },
    {
      "keyword": "bathroom",
      "mentions": 14,
      "id": "/m/01j2bj"
    },
    {
      "keyword": "chain",
      "mentions": 11,
      "id": "/m/0269r2s"
    },
    ...
  ],
  "reviews": [
    {
      "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChZDSUhNMG9nS0VJQ0FnSUNlaXNqZ1lBEAE!2m1!1s0x0:0xa4969e07ce3108de!3m1!1s2@1:CIHM0ogKEICAgICeisjgYA%7CCgwI-MfzmAYQsO6q2AM%7C?hl=en-US",
      "user": {
        "name": "Brittany Burleson",
        "link": "https://www.google.com/maps/contrib/109085762761845000223?hl=en-US&sa=X&ved=2ahUKEwi0kIn7oqP6AhVmM1kFHd_8AQQQvvQBegQIARBB",
        "thumbnail": "https://lh3.googleusercontent.com/a/ALm5wu1t_1ZUg8H_7tV0QQBzHvrUiImxULGo6xsM_BLV=s40-c-c0x00000000-cc-rp-mo-ba4-br100",
        "local_guide": true,
        "reviews": 187,
        "photos": 150
      },
      "rating": 4,
      "date": "a week ago",
      "snippet": "Great spot to grab a cup of coffee and watch the hustle of the city. Staff is not the best nor friendliest/customer service oriented. They were busy but they definitely need someone to clean tables and spot clean throughout the day. Decor gives a fun vibe. Better than the larger chain coffee spots.",
      "likes": 1,
      "images": [
        "https://lh5.googleusercontent.com/p/AF1QipMihI09lQq-dvFlfFTrcrCITsRM55F84nbBPNzs=w100-h100-p-n-k-no",
        "https://lh5.googleusercontent.com/p/AF1QipPXZgSiK4dmfCTQeS5Q_EjLi79mc-6xY3i_AUu0=w100-h100-p-n-k-no",
        "https://lh5.googleusercontent.com/p/AF1QipNIl6Myxhwzpn8DWaOqF6p6wbbOV69PjWk4kPR4=w100-h100-p-n-k-no",
        "https://lh5.googleusercontent.com/p/AF1QipO5o5VUojMzutNA__DO5aCsLSF8FchaFqvzJjqM=w100-h100-p-n-k-no"
      ]
    },
    {
      "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChdDSUhNMG9nS0VJQ0FnSUQyd2JmWnNRRRAB!2m1!1s0x0:0xa4969e07ce3108de!3m1!1s2@1:CIHM0ogKEICAgID2wbfZsQE%7CCgwIis2KlAYQ0PXgpQE%7C?hl=en-US",
      "user": {
        "name": "Sherri Freelancer",
        "link": "https://www.google.com/maps/contrib/113512219771876809808?hl=en-US&sa=X&ved=2ahUKEwi0kIn7oqP6AhVmM1kFHd_8AQQQvvQBegQIARBd",
        "thumbnail": "https://lh3.googleusercontent.com/a-/ACNPEu-dw3ecjQxBPl3b0o7NgW0em6HlrjT4CBXLfCPXng=s40-c-c0x00000000-cc-rp-mo-ba4-br100",
        "local_guide": true,
        "reviews": 36,
        "photos": 122
      },
      "rating": 5,
      "date": "4 months ago",
      "snippet": "Gregory’s coffee was amazing. I was staying in Manhattan and wanted to try out different coffee shops other than the larger chained ones and I was glad I did! I had a small latte which was strong (not too strong) and nice. Just right!",
      "likes": 1,
      "images": [
        "https://lh5.googleusercontent.com/p/AF1QipPdJHMBIV62LViwB9VbqHcmlIWPMhUf6ExKAPsl=w100-h100-p-n-k-no"
      ]
    },
    {
      "link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChZDSUhNMG9nS0VJQ0FnSURXLWZfNExBEAE!2m1!1s0x0:0xa4969e07ce3108de!3m1!1s2@1:CIHM0ogKEICAgIDW-f_4LA%7CCgwI7_WLkgYQiKWhiAM%7C?hl=en-US",
      "user": {
        "name": "Amanda",
        "link": "https://www.google.com/maps/contrib/118134806280673395810?hl=en-US&sa=X&ved=2ahUKEwi0kIn7oqP6AhVmM1kFHd_8AQQQvvQBegQIARB1",
        "thumbnail": "https://lh3.googleusercontent.com/a/ALm5wu1C4Szhx-oBsg3dFsZo-WMsrL7ya7VAHGD5NPuQ=s40-c-c0x00000000-cc-rp-mo-ba2-br100",
        "local_guide": true,
        "reviews": 21,
        "photos": 10
      },
      "rating": 5,
      "date": "5 months ago",
      "snippet": "Was here for work and this was my go to coffee spot for the week. Their salted caramel cold brew was one of the best I’ve had. Staff was friendly and coffee came out quick. Definitely recommend. I also love the logo",
      "images": [
        "https://lh5.googleusercontent.com/p/AF1QipPySBp0GRjxzk1RvJbrxWJA4z-z5mE4WiL11Lai=w100-h100-p-n-k-no"
      ],
      "response": {
        "date": "5 months ago",
        "snippet": "Thank you so much for this amazing feedback Amanda. We are so glad to hear how much you enjoyed your Salted Caramel Cold brew. The next time you stop by for one check out one of our freshly baked pastries like our chocolate croissant. Thank you for Seeing Coffee Differently here at Gregorys."
      }
    },
    ...
  ],
  "serpapi_pagination": {
    "next": "https://serpapi.com/search.json?data_id=0x89c259af336b3341%3A0xa4969e07ce3108de&engine=google_maps_reviews&hl=en&next_page_token=CAESBkVnSUlDZw%3D%3D",
    "next_page_token": "CAESBkVnSUlDZw=="
  }
}