List reviews
One page of a Google Maps place's reviews, 10 at most, with their rating, text, author, photos and owner reply.
google_maps/reviews/list2 credits a callv1.1.0When to use it
You have a place (its id from google_maps/places/search, or its cid or feature id) and need what people wrote about it: rating, full text and its translation, date, visit, author, photos, reactions, the owner's reply, and the ratings by aspect (food, service...) when the reviewer gave them. Follow next for the following page, as far as you need.
Try it
The options on the left write the call; the answer on the right is the contract's example. With your API key, the same call returns live data.
curl https://api.lobstr.io/v2/run \ -H "Authorization: Bearer $LOBSTR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "source": "google_maps", "operation": "reviews/list", "options": { "place": "ChIJ39Y-tdg1fYcRQcZcBb499do", "sort": "newest" } }'
An example answer, from the contract. Run it on your own input with your API key.
{ "object": "run", "id": "run_x7ia6rpp7dyhvghuj3w3kg5sie", "livemode": true, "source": "google_maps", "operation": "reviews/list", "version": "1.1.0", "schema_url": "https://api.lobstr.io/v2/catalog/google_maps/reviews/list", "options": { "place": "ChIJ39Y-tdg1fYcRQcZcBb499do", "sort": "newest" }, "fields": null, "status": "succeeded", "count": 1, "has_more": true, "next": { "source": "google_maps", "operation": "reviews/list", "options": { "place": "ChIJ39Y-tdg1fYcRQcZcBb499do", "sort": "newest", "cursor": "gAAAAABpNWd0x2kQ8vZr3TfYc1LmRb7uHsE9wA4jXoKqDn6yPiGt5" } }, "cost": { "credits": 2 }, "results": [ { "object": "review", "id": "ChZDSUhNMG9nS0VBQUFBQUFBQUFBQUEQAQ", "position": 1, "place": { "cid": "15777584755905447489", "url": "https://www.google.com/maps?cid=15777584755905447489" }, "rating": { "value": 5, "scale": 5 }, "text": "The best croissant in the district.\nFriendly staff, short wait even on Sunday.", "language": "en", "translation": null, "published_at": "2026-10-25T08:12:40Z", "is_edited": false, "visit": { "month": "2026-10", "text": "Oct 2026" }, "reaction_count": 3, "author": { "name": "Jane Doe", "id": "100000000000000000000", "url": "https://www.google.com/maps/contrib/100000000000000000000/reviews", "photo_url": "https://lh3.googleusercontent.com/a/example", "review_count": 42, "photo_count": 12, "is_local_guide": true }, "photo_urls": [ "https://lh3.googleusercontent.com/grass-cs/example" ], "owner_reply": { "text": "Thank you Jane, see you soon!" }, "aspects": [ { "id": "dining_food", "label": "Food", "rating": 5, "answers": null }, { "id": "dining_meal_type", "label": "Meal type", "rating": null, "answers": [ "Breakfast" ] } ], "url": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChZDSUhNMG9nS0VBQUFBQUFBQUFBQUEQAQ", "source_url": "https://www.google.com/maps?cid=15777584755905447489", "observed_at": "2026-10-26T09:00:00Z" } ] }
Options
placestringrequiredid google_maps/places/search and places/get return), its cid (ids.cid, the number in a maps?cid= link), its feature id (ids.feature_id, 0x...:0x...), or the link of its page on Google Maps as the browser shows it. A short link (maps.app.goo.gl) is not taken: open it and copy the page's link. With only a name, get the place with google_maps/places/get first (1 credit).sort"newest" | "relevant" | "highest" | "lowest"Default newestnewest is the order that reaches every review of a place; Google stops the others after about 1,500.languagestringDefault ensort: relevant, and aspect labels are written in it. text is always as its author wrote it (its language says which); a review written in another language also comes with Google's translation into this one.cursorstringnext in an answer, as it is: opaque, and only for the place and sort it was given with (otherwise invalid_cursor).Record
Each record of results, in the envelope every call returns (Run an operation).
objectstringidstringpositionintegerplace.cidstringids.cid.place.urlstringrating.valueintegerrating.scalefloattextstringlanguage), line breaks as \n; null for a rating alone. Quote this as what the author wrote.languagestringtranslation.languagestringtranslation.textstringpublished_atdateis_edited (the first date is then not given), UTC. Tell reviews apart by id, never by date.is_editedbooleanvisit.monthstringvisit.textstringreaction_countintegerauthor.namestringauthor.idstringauthor.urlstringauthor.photo_urlstringauthor.review_countintegerauthor.photo_countintegerauthor.is_local_guidebooleanphoto_urlslistowner_reply.textstringaspectslistrating, 1 to 5), or answers to Google's questions (answers). id is stable across languages; label and the answers are in language.urlstringsource_urlstringobserved_atdateErrors
Its own, besides those of every call (Errors). A failed call is free.
| Code | Status | What it means |
|---|---|---|
invalid_place | 422 | This place id does not say which place it is on Google's side; send the place's cid (ids.cid) instead. |
invalid_cursor | 422 | This cursor was not given by an answer; send next from the last answer as it is. |
site_unavailable | 503 | Google did not answer in time or refused the call; retry later (not charged). Retryable. |
unexpected_answer | 424 | Google answered in a shape we do not read yet; we are told and fix it, and it is not charged. Retrying now gives the same. |
Price
2 credits a call, whatever the page holds: a short last page costs a whole call. An empty page (a place without reviews, or an unknown place) and a failed call are free. What a credit costs on each plan: Credits and pricing.
Changelog
1.1.02026-11-13cursor is opaque, as every cursor of the API: copy it from next as before. It holds Google's token sealed with the place and sort it continues, and is refused with another (invalid_cursor).1.0.02026-10-26