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).
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
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:
{
"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_webfor Google's organic results instead of places.read_pageto read a place's website once you have it.
This page as Markdown: /docs/tools/search_maps.md. Something wrong or missing: hello@parel.si.