Search APIs
Loading…
← API Store
Search & SEO

Google Maps

Google Maps

Google Maps place reviews

GET /google-maps/v1/reviews
Test this endpoint

All 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

NameTypeDescription
feature_idstringThe place's Google data id (`0x…:0x…`), from search results (`feature_id`) or a Maps URL (`!1s0x…`). Example: 0x8644ca6bc309e81b:0x1f1a903bbb66839
cidstringThe place's CID (the number in `?cid=` Maps links), instead of feature_id.
urlstringA Google Maps place URL, instead of feature_id.
place_idstringGoogle place id (`ChI…`), alone (resolved through its Maps page) or with `q` (the place name and city).
qstringWith place_id, or alone: the place name and city to look up.
hlstringLanguage (default en).
glstringCountry (default us).
limitintegerReviews to return (default 10, max 100). Example: 20
cursorstringValue of `next_cursor` from the previous page (same place and sort).
sortrelevant | newest | highest | lowestrelevant (default), newest, highest or lowest. Example: newest
business_idstringThe business: its `business_id` (`0x…:0x…`), `place_id` (`ChI…`) or `cid`, instead of feature_id. Example: 0x89c2598f7ff4aa09:0x313547e757cb8cea
sort_bymost_relevant | newest | highest_ranking | lowest_rankingSame as `sort`, with these names: most_relevant, newest, highest_ranking, lowest_ranking.
querystringOnly reviews that mention every word of this text, e.g. `pastrami`.
languagestringLanguage (same as `hl`, default en).
regionstringCountry (same as `gl`, default us).
ratingstringOnly 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
$.cachedboolean
$.credits_usedinteger
$.placeobject
$.place.cidstring
$.place.feature_idstring
$.place.namestring
$.place.place_idstring
$.place.ratingnumber
$.place.review_countinteger
$.rating_histogramobject
$.rating_histogram.1integer
$.rating_histogram.2integer
$.rating_histogram.3integer
$.rating_histogram.4integer
$.rating_histogram.5integer
$.reviewsarray
$.reviews[]object | string
$.reviews[].authorobject
$.reviews[].author.avatarstring
$.reviews[].author.idstring
$.reviews[].author.local_guideboolean
$.reviews[].author.namestring
$.reviews[].author.photosinteger
$.reviews[].author.profile_urlstring
$.reviews[].author.reviewsinteger
$.reviews[].datestring
$.reviews[].detailsobject
$.reviews[].details.Can you share more about these topicsstring
$.reviews[].details.How would you describe the vegetarian offeringsstring
$.reviews[].details.What parking options are availablestring
$.reviews[].details.What size group is this place best suited forstring
$.reviews[].idstring
$.reviews[].owner_replynull
$.reviews[].photosarray
$.reviews[].photos[]object
$.reviews[].photos[].captionnull
$.reviews[].photos[].heightinteger
$.reviews[].photos[].idstring
$.reviews[].photos[].urlstring
$.reviews[].photos[].widthinteger
$.reviews[].published_atstring
$.reviews[].ratinginteger
$.reviews[].textstring
$.reviews_returnedinteger
$.topicsarray
$.topics[]object | string
$.topics[].mentionsinteger
$.topics[].topicstring