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.

FieldTypeRequiredDescription
qstringyese.g. "coffee near Times Square"
glstringnoe.g. "us". default "us"
hlstringnoe.g. "en". default "en"
pageintegernodefault 1; min 1
locationstringnoe.g. "New York, New York, United States"
autocorrectbooleannodefault 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "search_local"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_local"
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":"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

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