> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_maps_reviews

# 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`](https://parel.si/docs/tools/search_maps.md) 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.

| Field | Type | Required | Description |
|---|---|---|---|
| `sort` | string | no | relevant (Google's order) or newest; default relevant. e.g. "newest" |
| `limit` | integer | no | past the first 5 to 8 reviews, an owner reply carries no date; default 5, at most 100; max 100 |
| `place` | string | yes | the 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 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 180 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_maps_reviews"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_maps_reviews"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
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:

```json
{
  "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

- [`search_maps`](https://parel.si/docs/tools/search_maps.md) to get the place id.
- [`search_reddit`](https://parel.si/docs/tools/search_reddit.md) for what people say elsewhere.
