# Search the Google Local Finder (local pack)

Returns the businesses in Google's Local Finder for a query, with address, rating and opening hours. Use it to check local pack rankings.

Tool `google.serp.local` on Google. Contract version 1, released 2026-10-27.

## Example call

Over REST, send the input in the body. Over MCP, pass the same input to `call_tool`.

cURL:

```bash
curl https://api.voxoria.ai/v1/tools/google.serp.local/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"coffee shops in manchester","country":"gb"}}'
```

Python:

```python
import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/google.serp.local/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={
        "input": {"query": "coffee shops in manchester", "country": "gb"},
    },
    timeout=60,
)
print(response.json())
```

TypeScript:

```ts
const response = await fetch("https://api.voxoria.ai/v1/tools/google.serp.local/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "input": {"query": "coffee shops in manchester", "country": "gb"},
  }),
});
console.log(await response.json());
```

MCP (`tools/call` params):

```json
{
  "name": "call_tool",
  "arguments": {
    "tool": "google.serp.local",
    "input": {
      "query": "coffee shops in manchester",
      "country": "gb"
    }
  }
}
```

Both return [the full response](/docs/call-response.md): the call's ID, status and cost, with this tool's result in `output`.

## Input

| Input | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `query` | string | Yes |  | What to look for among local businesses, such as "coffee shops in Austin". |
| `country` | string | No | `us` | Two-letter ISO 3166-1 country code. Case-insensitive. One of the 249 values of the `countries` list: ISO 3166-1 alpha-2 country codes, lowercase. |
| `language` | string | No | `en` | Two-letter ISO 639-1 language code. Case-insensitive. One of the 184 values of the `languages` list: ISO 639-1 two-letter language codes, lowercase. |
| `location` | string | No |  | Place to search from, by name, such as "Austin, Texas, United States". |
| `page` | integer | No | `1` | Page of results. At least 1. |
| `autocorrect` | boolean | No |  | Whether Google may correct the spelling of the query. |

## Output

A successful call returns these blocks in its `output`. A field not marked required can be `null`.

### results

A list of rows. Always present, possibly empty.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `position` | integer | Yes | Rank among local results, starting at 1. |
| `title` | string | Yes | Name of the business or place. |
| `address` | string | No |  |
| `latitude` | number | No |  |
| `longitude` | number | No |  |
| `rating` | number | No | Average review rating, out of 5. |
| `review_count` | integer | No |  |
| `price_range` | string | No | Typical spend per person as Google shows it, a range with its currency symbol. Not parsed. |
| `category` | string | No | Kind of business, such as "Coffee shop". |
| `hours` | string | No | Opening status as Google shows it, such as "Open · Closes 5 pm". Not parsed. |
| `cid` | string | No | Google's customer ID of the place, in decimal digits. |

## Example output

The `output` of a real call, each list cut to 3 items.

```json
{
  "results": [
    {
      "position": 1,
      "title": "Nomad Coffee",
      "address": "24 Lever St, Manchester M1 1DW",
      "latitude": null,
      "longitude": null,
      "rating": 4.7,
      "review_count": 259,
      "price_range": "£1–10",
      "category": "Coffee shop",
      "hours": "Open · Closes 6:30 pm",
      "cid": "3998012778709651036"
    },
    {
      "position": 2,
      "title": "Bruncho",
      "address": "270 Deansgate, Manchester M3 4JB",
      "latitude": null,
      "longitude": null,
      "rating": 4.8,
      "review_count": 5663,
      "price_range": "£10–20",
      "category": "Cafe",
      "hours": "Open · Closes 6 pm",
      "cid": "9621092582366822303"
    },
    {
      "position": 3,
      "title": "Factory Coffee",
      "address": "38 King St W, Manchester M3 2WZ",
      "latitude": null,
      "longitude": null,
      "rating": 4.7,
      "review_count": 291,
      "price_range": "£1–10",
      "category": "Coffee shop",
      "hours": "Open · Closes 6:30 pm",
      "cid": "1753513427065608281"
    }
  ]
}
```