get_maps_reviews

The reviews Google Maps shows for one place: stars, text, date, reviewer and the owner's reply. ₹0.12 per call; no reviews is ₹0.

What it does

The reviews Google Maps shows for one place (the place_id from a search_maps row), in data.rows[]: rating, text, date, likes, author (name, reviews), owner_reply and url. sort newest or relevant (default); limit up to 100 (default 5). Use it to read what customers say about a store or a competitor's outlet.

India: any place on Google Maps; reviews come in the language they were written in.

Inputs

Generated from the contract captured from staging on 2026-11-05.

FieldTypeRequiredDescription
sortstringnorelevant (Google's order) or newest; default relevant. e.g. "newest"
limitintegernopast the first 5 to 8 reviews, an owner reply carries no date; default 5, at most 100; max 100
placestringyesthe place's Google Maps link, its place id (ChIJ...) or its cid (the number in a maps?cid= link). e.g. "ChIJG-gJw2vKRIYROWi2uwOp8QE"

What drives the cost

Nothing: flat per call whatever limit says, so ask for 50 or 100 at once. No reviews is class: "ok_free", ₹0. Usually one to three seconds, up to thirty on a cold fetch.

Price today

Price today₹0.12 per call (cost_paise: 12) at ₹93.93 per US dollar on 17 November 2026
Hold before the call₹0.38 (hold_paise: 38); when the call settles the real price is charged and the unused part is released
₹0 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout180 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "get_maps_reviews"
Over RESTPOST https://api.parel.si/v1/run with "tool": "get_maps_reviews"
Confirmationnot needed (the estimate is under the ₹200 threshold)

Request

curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_maps_reviews","input":{"sort":"newest","limit":20,"place":"ChIJ80IECk8UrjsRqCffDjE09lw"}}'

What comes back

data.rows[] and data.meta. A real answer recorded during the live check of 2026-10-28, trimmed to two reviews:

{
  "meta": {
    "blocked": [],
    "elapsed_ms": 541,
    "from_cache": false,
    "llm_calls": 0,
    "pages_fetched": 2,
    "partial": false,
    "warnings": []
  },
  "recipe": "google-maps-reviews",
  "rows": [
    {
      "author": {
        "name": "Jane Example",
        "reviews": 9,
        "url": "https://www.google.com/maps/contrib/100000000000000000001?hl=en-US"
      },
      "date": "2026-07-23T08:33:25Z",
      "likes": 0,
      "owner_reply": null,
      "place_id": "ChIJ80IECk8UrjsRqCffDjE09lw",
      "rating": 5,
      "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xkRmQwMUxWVGt4V0RneVV6ZE9jREpWV210RVdFRRAB",
      "text": "Had a wonderful time at DYU Art Cafe! We tried their filter coffee, hot chocolate, cheesy fries, and pizza—the pizza was absolutely ultimate and definitely the highlight of our meal. We ended it on a sweet note with their chocolate cake, which was equally delicious.\n\nThe place has such a good vibe—calm, cozy, and perfect to unwind. I went there with my siste…",
      "url": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xkRmQwMUxWVGt4V0RneVV6ZE9jREpWV210RVdFRRAB!2m1!1s0x0:0x5cf634310edf27a8!3m1!1s2@1:CAIQACodChtycF9oOldFd01LVTkxWDgyUzdOcDJVWmtEWEE%7C%7C?hl=en-US"
    },
    {
      "author": {
        "name": "Sam Example",
        "reviews": 47,
        "url": "https://www.google.com/maps/contrib/100000000000000000001?hl=en-US"
      },
      "date": "2026-09-25T10:20:30Z",
      "likes": 0,
      "owner_reply": {
        "date": "2026-10-28T09:09:18Z",
        "text": "Thank you, Sam! We’re glad your first visit was so pleasant. Glad you enjoyed the Kerala-style architecture, greenery, bookshelf, French Toast and Peri Peri Fries. That calm, homely feel is a big part of our Koramangala cafe ambience."
      },
      "place_id": "ChIJ80IECk8UrjsRqCffDjE09lw",
      "rating": 4,
      "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2xsbVIxVnFkRUV4UmxsUFNFTjVhRkY0ZVhWdFJtYxAB",
      "text": "A lovely cafe with a beautiful Kerala-style traditional home architecture. The ambience is peaceful, the place is well maintained, and the staff are very welcoming.\n\nThis was my first visit, and I ordered Peri Peri Fries and French Toast. Both were served hot and tasted good. I especially loved the greenery surrounding the cafe, which gives it a calm and ref…",
      "url": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2xsbVIxVnFkRUV4UmxsUFNFTjVhRkY0ZVhWdFJtYxAB!2m1!1s0x0:0x5cf634310edf27a8!3m1!1s2@1:CAIQACodChtycF9oOllmR1VqdEExRllPSEN5aFF4eXVtRmc%7C%7C?hl=en-US"
    },
    "… 3 more item(s) truncated"
  ],
  "version": 1
}

Notes

  • place is the place_id from search_maps (ChIJ...). Flat per call: ask for limit 50 or 100 in one go.
  • No reviews is free. Usually one to three seconds, up to thirty on a cold fetch.
  • sort newest for what changed lately; relevant (default) for Google's pick.

Siblings

This page as Markdown: /docs/tools/get_maps_reviews.md. Something wrong or missing: hello@parel.si.