Google Maps
Google Maps
Google Maps place reviews
GET /google-maps/v1/reviewsAll of a place's Google reviews, paginated: rating, text, date, author profile, photos, the owner's reply and the guided answers (parking, seating, vegetarian options…), in Google's four sort orders. Each review also carries the other API's names (review_id, review_text, review_rating, review_datetime_utc, author_id, author_name, author_link, author_photo_url, owner_response_text…). Up to 100 reviews per call (limit); pass next_cursor back as cursor for the next page (next_cursor is null on the last page). query keeps the reviews that mention every word (a few hundred reviews are searched per call; pass next_cursor to search further). The first page also carries the 1-5 star histogram and the review topics with mention counts. Filter by star rating with rating (e.g. 1,2 for the negative reviews); rating and query scan up to several pages of reviews to fill limit.
Every response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
feature_id | string | The place's Google data id (`0x…:0x…`), from search results (`feature_id`) or a Maps URL (`!1s0x…`). Example: 0x8644ca6bc309e81b:0x1f1a903bbb66839 |
cid | string | The place's CID (the number in `?cid=` Maps links), instead of feature_id. |
url | string | A Google Maps place URL, instead of feature_id. |
place_id | string | Google place id (`ChI…`), alone (resolved through its Maps page) or with `q` (the place name and city). |
q | string | With place_id, or alone: the place name and city to look up. |
hl | string | Language (default en). |
gl | string | Country (default us). |
limit | integer | Reviews to return (default 10, max 100). Example: 20 |
cursor | string | Value of `next_cursor` from the previous page (same place and sort). |
sort | relevant | newest | highest | lowest | relevant (default), newest, highest or lowest. Example: newest |
business_id | string | The business: its `business_id` (`0x…:0x…`), `place_id` (`ChI…`) or `cid`, instead of feature_id. Example: 0x89c2598f7ff4aa09:0x313547e757cb8cea |
sort_by | most_relevant | newest | highest_ranking | lowest_ranking | Same as `sort`, with these names: most_relevant, newest, highest_ranking, lowest_ranking. |
query | string | Only reviews that mention every word of this text, e.g. `pastrami`. |
language | string | Language (same as `hl`, default en). |
region | string | Country (same as `gl`, default us). |
rating | string | Only reviews with these star ratings, comma separated (e.g. 1,2 or 5). |
Every endpoint also takes: fields、raw、fresh、output、records
{
"cached": false,
"credits_used": 1,
"place": {
"cid": "16894172895220284888",
"feature_id": "0x397c4318fd9a8927:0xea7428bd31a33dd8",
"name": "Nothing Before Coffee Cafe - Gulmohar, Bhopal",
"place_id": "ChIJJ4ma_RhDfDkR2D2jMb0odOo",
"rating": 4.5,
"review_count": 736
},
"rating_histogram": {
"1": 40,
"2": 5,
"3": 25,
"4": 116,
"5": 550
},
"reviews": [
{
"author": {
"avatar": "https://lh3.googleusercontent.com/a-/ALV-UjVRBxClW7PK_N_CSJ6yic5CXmHL75NBvqe5rI9-ssKquLKORuzb=s120-c-rp-mo-br100",
"id": "101046183710993030707",
"local_guide": false,
"name": "Das Manish",
"photos": 1,
"profile_url": "https://www.google.com/maps/contrib/101046183710993030707?hl=en-US",
"reviews": 1
},
"date": "8 months ago",
"details": {
"Can you share more about these topics": "Vegetarian options, Parking",
"How would you describe the vegetarian offerings": "Menu is all vegetarian",
"What parking options are available": "Free parking lot"
},
"id": "Ci9DQUlRQUNvZENodHljRjlvT25SS1lWSkhTa2RuVVRkcFJsZ3dXVEpXZDJrME0yYxAB",
"owner_reply": null,
"photos": [
{
"caption": null,
"height": 1367,
"id": "CIABIhCBrju2LNmiIE8BUuf1Z3Ib",
"url": "https://lh3.googleusercontent.com/grass-cs/AABkmLfJIKtqpCzKk8ZK26sD-UimId0Y5kZKPzmvwB1d_IbomeNX4wXLTnEH9Vb9r-4VgnIAv2KGYZh26SDOe3YpjkZZ-p_Ik…",
"width": 1080
}
],
"published_at": "2026-02-05T05:56:30.917Z",
"rating": 5,
"text": "I recently tried the avocado toast here and really loved it. The avocado was fresh and perfectly seasoned, and the bread was nicely toasted.…"
},
{
"author": {
"avatar": "https://lh3.googleusercontent.com/a-/ALV-UjUGBCEDwwvaoNMHtknhSWB68hfTvY0KF0NgQEqkhhmfYdXVZxtU=s120-c-rp-mo-ba12-br100",
"id": "108759098611040203736",
"local_guide": false,
"name": "S Srivastava",
"photos": 297,
"profile_url": "https://www.google.com/maps/contrib/108759098611040203736?hl=en-US",
"reviews": 31
},
"date": "6 months ago",
"details": {
"Can you share more about these topics": "Parking",
"What parking options are available": "Parking is unavailable",
"What size group is this place best suited for": "2 people"
},
"id": "Ci9DQUlRQUNvZENodHljRjlvT2t4UFprcHdkVzUxTkZVM1ZFWldiRVpNWTNCek5sRRAB",
"owner_reply": null,
"photos": [],
"published_at": "2026-04-05T11:03:36.727Z",
"rating": 5,
"text": "Nice smiling reception, good coffee but the over ambience is not effective for a regular cup of coffee. It's too mundane and ordinary for th…"
},
"… 3 more"
],
"reviews_returned": 5,
"topics": [
{
"mentions": 15,
"topic": "hazelnut shrappe"
},
{
"mentions": 13,
"topic": "shakes"
},
"… 8 more"
]
} Response fields (49)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.credits_used | integer |
$.place | object |
$.place.cid | string |
$.place.feature_id | string |
$.place.name | string |
$.place.place_id | string |
$.place.rating | number |
$.place.review_count | integer |
$.rating_histogram | object |
$.rating_histogram.1 | integer |
$.rating_histogram.2 | integer |
$.rating_histogram.3 | integer |
$.rating_histogram.4 | integer |
$.rating_histogram.5 | integer |
$.reviews | array |
$.reviews[] | object | string |
$.reviews[].author | object |
$.reviews[].author.avatar | string |
$.reviews[].author.id | string |
$.reviews[].author.local_guide | boolean |
$.reviews[].author.name | string |
$.reviews[].author.photos | integer |
$.reviews[].author.profile_url | string |
$.reviews[].author.reviews | integer |
$.reviews[].date | string |
$.reviews[].details | object |
$.reviews[].details.Can you share more about these topics | string |
$.reviews[].details.How would you describe the vegetarian offerings | string |
$.reviews[].details.What parking options are available | string |
$.reviews[].details.What size group is this place best suited for | string |
$.reviews[].id | string |
$.reviews[].owner_reply | null |
$.reviews[].photos | array |
$.reviews[].photos[] | object |
$.reviews[].photos[].caption | null |
$.reviews[].photos[].height | integer |
$.reviews[].photos[].id | string |
$.reviews[].photos[].url | string |
$.reviews[].photos[].width | integer |
$.reviews[].published_at | string |
$.reviews[].rating | integer |
$.reviews[].text | string |
$.reviews_returned | integer |
$.topics | array |
$.topics[] | object | string |
$.topics[].mentions | integer |
$.topics[].topic | string |