search_local
Google's local results for a query: about ten places with address, rating, review count, category and website. ₹0.20 per call; an empty list is ₹0.
What it does
The local results Google shows for q (the map pack), in data.places[]: title, address, latitude, longitude, rating, ratingCount, priceLevel, category, website and cid, about ten per page; location steers it, gl and hl set country and language, page for more. Use it for the handful of businesses Google ranks first for a local query; search_maps lists twenty with hours and phone, get_maps_reviews reads a place's reviews.
India: gl: "in", hl: "en" or "hi", and the city in location or the query.
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
q | string | yes | e.g. "coffee near Times Square" |
gl | string | no | e.g. "us". default "us" |
hl | string | no | e.g. "en". default "en" |
page | integer | no | default 1; min 1 |
location | string | no | e.g. "New York, New York, United States" |
autocorrect | boolean | no | default true |
What drives the cost
Nothing: flat per call. An empty list is class: "ok_free", ₹0.
Price today
| Price today | ₹0.20 per call (cost_paise: 20) 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 | 30 s, then upstream_timeout (₹0, retryable) |
| Over MCP | run_tool with tool: "search_local" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "search_local" |
| 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_local","input":{"q":"cafes in Koramangala Bengaluru","gl":"in","hl":"en"}}'
What comes back
data.places[]. A real answer recorded during the live check of 2026-10-28, trimmed to two places:
{
"searchParameters": {
"q": "cafes in Koramangala Bengaluru",
"gl": "in",
"hl": "en",
"type": "places",
"num": 10,
"page": 1,
"engine": "google"
},
"places": [
{
"position": 1,
"title": "Dyu Art Cafe",
"address": "KHB MIG Colony, Dyu art cafe 23, near Mangala Kalyana Mantapa",
"latitude": 12.937341,
"longitude": 77.617645,
"rating": 4.4,
"ratingCount": 21000,
"priceLevel": "₹200–1,000",
"category": "Art cafe",
"website": "http://www.dyuartcafe.com/",
"cid": "6698598881067739048"
},
{
"position": 2,
"title": "The Hole In The Wall Cafe",
"address": "3, 8th Main Rd",
"latitude": 12.93474,
"longitude": 77.62547,
"rating": 4.3,
"ratingCount": 21000,
"priceLevel": "₹400–600",
"category": "Cafe",
"website": "http://www.theholeinthewallcafe.org/",
"cid": "5900487254378742932"
},
"… 8 more item(s) truncated"
]
}
Notes
- About ten places per page; search_maps for a fuller list with hours and phone.
- India: gl "in"; put the city in location or the query. Empty is free.
- Usually one to three seconds.
Siblings
search_mapsfor the fuller list.get_maps_reviewsfor a place's reviews.
This page as Markdown: /docs/tools/search_local.md. Something wrong or missing: hello@parel.si.