Google Local API

Search Google Local results - the local pack inside Google Search SERPs. Extract businesses with rating, reviews, phone, hours, place_id, GPS coordinates. Country, language, and device targeting. Pay per page. MCP-ready for AI agents.

MEDIAN LAGon demand
PARAMETERS10
TOTAL USERS90
MONTHLY ACTIVE20
TOTAL RUNS12,120
SUCCESS (30D)100.0%
RATING5.0 (4)
LAST MODIFIED2026-11-15
PUBLISHED2026-05

Input parameters

PARAMETERTYPEREQDEFAULTDESCRIPTION
q string yes — The Google Local search query.
location string no — City-level location (e.g., 'Austin, Texas, United States', 'London', 'Brooklyn, New York').
uule string no — Advanced: Google-encoded location string for precise geographic targeting.
google_domain string no — Which Google domain to query (e.g., 'google.com', 'google.co.uk', 'google.fr', 'google.de').
gl string no — Two-letter country code (ISO 3166-1 alpha-2, e.g., 'us', 'uk', 'fr', 'de', 'jp').
hl string no — Two-letter language code (ISO 639-1, e.g., 'en', 'es', 'fr', 'de', 'ja').
ludocid string no — Advanced: Google customer identifier (CID) for a specific place.
tbs string no — Advanced: Google search filter string for criteria not exposed elsewhere.
device enum no desktop Which device to emulate.
max_pages integer no 1 Maximum number of result pages to fetch (1-indexed). — drives your bill

Worked examples

Basic — the required input, with the schema's own example values
{
  "q": "coffee"
}

n8n templates

Free n8n workflows that run this source. Import one, add your Apify token, and it runs on a schedule.

N8N Track competitor Google review ratings and counts in Google Sheets ↗ One row per business per week with its Google star rating and review count, for your competitors as well as your own listing.
N8N Track Google local pack rankings in Google Sheets ↗ Logs where a business ranks in the Google local pack for each keyword and location you set, once a week.

All n8n templates →

Code

curl

curl -X POST "https://api.apify.com/v2/acts/johnvc~google-local-api/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"q": "coffee"}'

Python

from apify_client import ApifyClient

client = ApifyClient("APIFY_TOKEN")
run = client.actor("johnvc/google-local-api").call(
    run_input={'q': 'coffee'}
)
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

MCP

Apify's hosted MCP server loads this source from the URL below as the tool johnvc--google-local-api. Sign in to Apify when your client asks (OAuth), or send an Apify token as an Authorization: Bearer header.

https://mcp.apify.com/?tools=johnvc/google-local-api

Setup guide for Claude Code, VS Code and Cursor, with tool names and parameters →

Questions people ask

What data does the Google Local API return for a business?

It returns the Google Local pack, the local results block inside Google Search, as structured JSON: business name, rating, review count, phone, hours, place_id and GPS coordinates for each listing.

How do I extract local business listings with the Google Local API?

Pass a query such as coffee as q, the only required input, and add a city-level location such as Austin, Texas, United States. Use google_domain, gl and hl for country and language targeting, device to choose which device to emulate (default desktop), and max_pages for more result pages.

How much does the Google Local API cost per page?

The default Pay per page edition is priced at 0.02 USD per page of local results, and max_pages (default 1) is the input that drives the total. There is also a free tier on Apify.

Can I target a precise location with the Google Local API?

Yes. Besides the plain location input, the advanced uule input takes a Google-encoded location string for precise geographic targeting, ludocid takes a Google customer identifier for a specific place, and tbs passes a Google search filter string for criteria not exposed elsewhere.

Can Claude or Cursor call the Google Local API?

Yes. The source is MCP-ready for AI agents and exposed as an MCP tool on Apify's hosted MCP server, so Claude, Cursor and other agents can call it directly. It is also available over REST with curl or the Apify Python client.

How fresh are the results from the Google Local API?

Data is fetched on demand. Each run reads the current local pack for your query and location, so ratings, review counts and hours reflect what Google shows at the time of the request.