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.
Input parameters
| PARAMETER | TYPE | REQ | DEFAULT | DESCRIPTION |
|---|---|---|---|---|
| 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
{
"q": "coffee"
}
n8n templates
Free n8n workflows that run this source. Import one, add your Apify token, and it runs on a schedule.
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.