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
Serpapi Parameters
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 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
{
"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=="
}
}