Search the Google Local Finder (local pack)

POST/v1/tools/google.serp.local/callsNeeds an API key

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.

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

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

querystringRequired

What to look for among local businesses, such as "coffee shops in Austin".

countrystring· default 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.

languagestring· default 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.

locationstring

Place to search from, by name, such as "Austin, Texas, United States".

pageinteger· default 1

Page of results.

At least 1.

autocorrectboolean

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.

positionintegerRequired

Rank among local results, starting at 1.

titlestringRequired

Name of the business or place.

addressstring

latitudenumber

longitudenumber

ratingnumber

Average review rating, out of 5.

review_countinteger

price_rangestring

Typical spend per person as Google shows it, a range with its currency symbol. Not parsed.

categorystring

Kind of business, such as "Coffee shop".

hoursstring

Opening status as Google shows it, such as "Open · Closes 5 pm". Not parsed.

cidstring

Google's customer ID of the place, in decimal digits.

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"}}'

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())

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());

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

200 OKoutputapplication/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"
    }
  ]
}

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