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

# search_maps

> Google Maps places for a query: name, address, rating, review count, phone, website, opening hours and place ids. ₹0.13 per call; no places is ₹0.

## What it does

The places Google Maps lists for a query, in Google's order, in `data.rows[]`: `name`, `address`, `category` and `categories`, `rating` and `review_count`, `phone`, `website`, `hours` by weekday, `latitude` and `longitude`, `place_id` and `cid`, and the Maps `url`. Put the area in the query ("cafes near Koramangala Bengaluru") or pass it as `location` ("Pune, India"); `limit` asks for more rows (default 20, up to 60 here). It returns listing data, not the reviews themselves, and it is not a web search ([`search_web`](https://parel.si/docs/tools/search_web.md)).

India: any Indian city or area works; phone numbers and opening hours come as Google shows them locally.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `q` | string | yes | what you would type in Google Maps, like coffee. e.g. "coffee" |
| `limit` | integer | no | at most 100; default 20; max 60 |
| `location` | string | no | the city or area, like Austin, TX; leave it empty to name the place in `query`. e.g. "Austin, TX" |

## What drives the cost

Nothing you can turn: the price is flat per call whatever `limit` says, and a query with no places is `class: "ok_free"`, ₹0. Usually one to three seconds; a query the source has not seen recently can take twenty while it fetches fresh pages, so the timeout is generous.

## Price today

| | |
|---|---|
| Price today | **₹0.13** per call (`cost_paise: 13`) 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 | 100 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_maps"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_maps"` |
| 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":"search_maps","input":{"q":"cafes near Koramangala Bengaluru","limit":20}}'
```

## What comes back

`data.rows[]` and `data.meta` (`pages_fetched`, `partial`, `warnings`). A real answer recorded during the live check of 2026-10-28, trimmed to two rows:

```json
{
  "meta": {
    "blocked": [],
    "elapsed_ms": 0,
    "from_cache": true,
    "llm_calls": 0,
    "pages_fetched": 0,
    "partial": false,
    "warnings": []
  },
  "recipe": "google-maps-places",
  "rows": [
    {
      "address": "KHB MIG Colony, Dyu art cafe 23, near Mangala Kalyana Mantapa, 5th Block, Koramangala, Bengaluru, Karnataka 560095, India",
      "categories": [
        "Art cafe",
        "Art gallery",
        "… 3 more item(s) truncated"
      ],
      "category": "Art cafe",
      "cid": "6698598881067739048",
      "hours": {
        "Friday": "10 AM–10:30 PM",
        "Monday": "10 AM–10:30 PM",
        "Saturday": "10 AM–10:30 PM",
        "Sunday": "10 AM–10:30 PM",
        "Thursday": "10 AM–10:30 PM",
        "Tuesday": "10 AM–10:30 PM",
        "Wednesday": "10 AM–10:30 PM"
      },
      "latitude": 12.9373404,
      "longitude": 77.6176459,
      "name": "Dyu Art Cafe",
      "phone": "+91 98765 43210",
      "place_id": "ChIJ80IECk8UrjsRqCffDjE09lw",
      "position": 1,
      "rating": 4.4,
      "review_count": 21398,
      "url": "https://www.google.com/maps/place/?q=place_id:ChIJ80IECk8UrjsRqCffDjE09lw",
      "website": "http://www.dyuartcafe.com/"
    },
    {
      "address": "3, 8th Main Rd, 4th Block, Koramangala, Bengaluru, Karnataka 560034, India",
      "categories": [
        "Cafe",
        "Breakfast restaurant",
        "… 8 more item(s) truncated"
      ],
      "category": "Cafe",
      "cid": "5900487254378742932",
      "hours": null,
      "latitude": 12.9347403,
      "longitude": 77.62546929999999,
      "name": "The Hole In The Wall Cafe",
      "phone": "+91 98765 43210",
      "place_id": "ChIJy9Ry9GcUrjsRlAT3TuW94lE",
      "position": 2,
      "rating": 4.3,
      "review_count": 21237,
      "url": "https://www.google.com/maps/place/?q=place_id:ChIJy9Ry9GcUrjsRlAT3TuW94lE",
      "website": "http://www.theholeinthewallcafe.org/"
    },
    "… 18 more item(s) truncated"
  ],
  "version": 1
}
```

## Notes

- About 20 rows per call by default; limit goes up to 60 here. No rows is free.
- Put the city or area in the query, or pass location as plain text ("Pune, India").
- Usually one to three seconds; a fresh fetch can take twenty.
- place_id and cid identify the place for later lookups.

## Siblings

- [`search_web`](https://parel.si/docs/tools/search_web.md) for Google's organic results instead of places.
- [`read_page`](https://parel.si/docs/tools/read_page.md) to read a place's website once you have it.
