Skip to content
Google Maps

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.0

When 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.

1Request
The place: its Google place id (ChIJ..., the id 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.
The order Google Maps offers: newest first, most relevant (its own), highest rating first, lowest first. newest is the order that reaches every review of a place; Google stops the others after about 1,500.
An ISO 639-1 code (a regional form such as pt-BR is not taken yet).
Where to continue, from next in an answer, as it is: opaque, and only for the place and sort it was given with (otherwise invalid_cursor).
2 credits a call
Code, from the fields above
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"
    }
  }'
2Response

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

placestringrequired
The place: its Google place id (ChIJ..., the id 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 newest
The order Google Maps offers: newest first, most relevant (its own), highest rating first, lowest first. newest is the order that reaches every review of a place; Google stops the others after about 1,500.
languagestringDefault en
An ISO 639-1 code (a regional form such as pt-BR is not taken yet). Reviews written in it come first with sort: 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.
cursorstring
Where to continue, from next 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).

objectstring
The kind of record: a review, whichever site it comes from.
idstring
Google's id of the review, stable across languages and sorts.
positioninteger
Its rank in this order, across pages: 11 is the first of page 2.
place.cidstring
The place's cid, as google_maps/places/search gives it in ids.cid.
place.urlstring
The place on Google Maps.
rating.valueinteger
rating.scalefloat
The best possible value.
textstring
The author's own words, whole, in their language (language), line breaks as \n; null for a rating alone. Quote this as what the author wrote.
languagestring
The text's language, ISO 639-1, as Google detects it.
translation.languagestring
translation.textstring
Google's machine translation, not the author's words: say so when you quote it.
published_atdate
When the review was posted, or last edited when is_edited (the first date is then not given), UTC. Tell reviews apart by id, never by date.
is_editedboolean
visit.monthstring
YYYY-MM; null in a language we do not read yet.
visit.textstring
As Google writes it, in the call's language.
reaction_countinteger
People who reacted to the review (likes and other reactions).
author.namestring
author.idstring
The author's Google Maps contributor id.
author.urlstring
The author's reviews on Google Maps.
author.photo_urlstring
author.review_countinteger
Reviews the author has written, all places.
author.photo_countinteger
Photos the author has posted, all places.
author.is_local_guideboolean
photo_urlslist
The photos posted with the review.
owner_reply.textstring
aspectslist
What the reviewer added beyond the text: a rating of an aspect (rating, 1 to 5), or answers to Google's questions (answers). id is stable across languages; label and the answers are in language.
urlstring
The review on Google Maps.
source_urlstring
The place whose reviews these values were read from.
observed_atdate
When they were read

Errors

Its own, besides those of every call (Errors). A failed call is free.

CodeStatusWhat it means
invalid_place422This place id does not say which place it is on Google's side; send the place's cid (ids.cid) instead.
invalid_cursor422This cursor was not given by an answer; send next from the last answer as it is.
site_unavailable503Google did not answer in time or refused the call; retry later (not charged). Retryable.
unexpected_answer424Google 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-13
cursor 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
First version on the API v2.