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

# 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`](https://parel.si/docs/tools/search_maps.md) lists twenty with hours and phone, [`get_maps_reviews`](https://parel.si/docs/tools/get_maps_reviews.md) 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

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

```json
{
  "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_maps`](https://parel.si/docs/tools/search_maps.md) for the fuller list.
- [`get_maps_reviews`](https://parel.si/docs/tools/get_maps_reviews.md) for a place's reviews.
