# Google Local API | Local Pack & Business Search SERPs (`johnvc/google-local-api`) Actor

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.

- **URL**: https://apify.com/johnvc/google-local-api.md
- **Developed by:** [John](https://apify.com/johnvc) (community)
- **Categories:** Lead generation, SEO tools, Automation
- **Stats:** 66 total users, 26 monthly users, 100.0% runs succeeded, 10 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $19.41 / 1,000 pages processeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Google Local API | Local Pack & Business Search SERPs (MCP-ready)

> **Search Google Local results - the local pack inside Google Search SERPs - and get clean JSON back. Local businesses with rating, reviews, phone, hours, place\_id, GPS coordinates, ads, and related place suggestions. Pay per page. MCP-ready for Claude, ChatGPT, Cursor, and other AI agents.**

Pass a search query (and optionally a city) to the Google Local API and it returns the same structured data Google shows in the local pack on its Search results page: titles, ratings, review counts, addresses, phone numbers, opening hours, business categories, price tiers, place IDs, GPS coordinates, action links (directions, website, order, phone, reservations), and the related-place suggestions Google surfaces under the main results. Country, language, Google domain, and device controls are all exposed.

This is the only Apify Actor focused on the **Google Local Search SERP** (the local pack inside a normal Google Search), as opposed to [scraping Google Maps directly](https://apify.com/johnvc/google-maps-places-api?fpr=9n7kx3). The result is 100% reliability (no browsers, no captchas), the exact data layout Google ships to users on the web, and per-page pricing that is predictable regardless of how many businesses appear.

***

### Use with Claude, ChatGPT, Cursor & other AI agents (MCP)

This Actor is a first-class tool on the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp). Any MCP-compatible AI agent - Claude (Desktop, Web, Code), ChatGPT (via custom GPT or MCP bridge), Cursor, VS Code, Cline, Windsurf, Kilo Code, Opencode, Glama - can discover and call this Actor in natural language.

**What an AI agent does with this:**

> User: *"Find me the highest-rated dentists in Brooklyn that take walk-ins."*
>
> Agent calls `search-actors("google local")` on the Apify MCP server, picks this Actor, calls it with `{"q": "dentists walk-ins", "location": "Brooklyn, New York, United States", "max_pages": 2}`, gets the local pack businesses back, ranks them by rating and review count, and returns a short list to the user with phone numbers.

#### Quick setup - Claude Desktop

Add this to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server"],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_API_TOKEN"
      }
    }
  }
}
```

Restart Claude Desktop. Then ask Claude something like *"Find vegan restaurants in Austin with at least 4.5 stars and 200+ reviews."* Claude will discover this Actor, ask permission to call it, and return structured results.

#### Quick setup - Cursor / VS Code / Cline / Windsurf

These editors support **dynamic tool discovery**, so after the first call this Actor is registered as a named tool for the rest of the session, and subsequent prompts skip the discovery step entirely.

Point your MCP client at:

```
https://mcp.apify.com
```

…with header `Authorization: Bearer YOUR_APIFY_API_TOKEN`. Full setup: [Apify MCP integration docs](https://docs.apify.com/platform/integrations/mcp).

#### Quick setup - ChatGPT (and other static MCP clients)

ChatGPT, Gemini CLI, and Amazon Q connect through the same `https://mcp.apify.com` endpoint and call this Actor via the generic `call-actor` tool. Same result, just no session-level tool registration.

#### Use cases for AI agents

- **Local lead-gen agents** - "Pull every plumber in {city} with under 50 reviews so I can pitch SEO services."
- **Local SEO copilots** - "Where does {brand} rank in the local pack for 'best coffee' across these 25 cities?"
- **Reservation / booking assistants** - "Find me three Italian places near Union Square with a 4.5+ rating and a phone link."
- **Competitor monitoring agents** - "Watch the top-3 local pack results for 'pediatric dentist Brooklyn' weekly."
- **Market research agents** - "How many CrossFit gyms are in each of these 100 zips, and what is the median rating?"

***

### 💸 Pay per run with crypto (x402)

The Google Local API supports agentic payments via the [x402 protocol](https://docs.apify.com/platform/integrations/x402).
AI agents and MCP clients can pay for runs in USDC (on Base) with no Apify account or API token needed:
point your agent at the [Apify MCP server](https://mcp.apify.com/?tools=actors,docs,johnvc/google-local-api) and it can
discover, pay for, and run this Actor autonomously. Read the
[Apify x402 announcement](https://apify.com/change-log/pay-for-apify-actors-with-x402?fpr=9n7kx3) for details.

### What this Actor does

A Google Local search wrapper that takes a query and returns the local pack businesses Google would show on the Search results page, plus the local ads and the related-place suggestions Google adds beneath them. Localize by country, language, Google domain, and device. Set `max_pages` to walk through more results. Each page is one billable event.

Whether you are powering an AI agent through MCP, building a local-business directory, running local SEO rank tracking, or generating outreach lists, this Actor produces the structured local pack data you need.

**SEO benefit**: Local pack data lets agencies and in-house teams measure visibility for geo-targeted keywords, benchmark competitors, and prioritize Google Business Profile optimization.

***

### What data you get

| Field | Description |
|---|---|
| **Business details** | Title, type/category, description, price tier ($, $$, $$$, $$$$) |
| **Ratings & reviews** | Average star rating, total review count, raw review text label |
| **Contact** | Address, phone number, opening hours, "Open 24 hours" labels |
| **Identifiers** | `place_id` (Google CID), `provider_id`, `lsig` signature, place-search URL |
| **Geo** | `gps_coordinates` (latitude + longitude) for every listing |
| **Action links** | Directions, website, order, schedule, phone (when available) |
| **Media** | Thumbnail image, large thumbnail |
| **Service options** | Dine-in, takeout, delivery, in-store shopping, curbside pickup, no-contact delivery, etc. |
| **Ads** | Paid local placements (Google Local Ads) with the same business fields plus an ad title |
| **Related places** | "Discover more places" suggestions Google appends under the main results |
| **Pagination** | `pagination.current` (page index). Use the `max_pages` input to fetch more pages. |
| **Metadata** | Pages processed, total results estimate, pagination status |

***

### Key features

**Comprehensive coverage** - Every public local pack field Google returns: rating, reviews, phone, hours, GPS, place\_id, service options, ad placements, related places.

**Country, language, and Google domain controls** - `gl` (200+ country codes), `hl` (200+ languages), `google_domain` (regional google.\* domains). Localize the search exactly the way a real user in that market would see it.

**Device emulation** - `device` switches between desktop (about 20 results per page) and mobile (about 10 results per page) layouts.

**Smart pagination** - Set `max_pages` to fetch as many pages as you need, or `0` for unlimited (bounded by a 20-page safety cap). The Actor walks pages automatically; you do not need to manage offsets.

**Transparent pay-per-page pricing** - $0.02 setup + $0.02 per page. No subscriptions, no result-count surprises, no per-business markup.

**Production-grade reliability** - API-backed instead of browser-based, so no captchas, no proxies, no rate-limit gymnastics. Schema-validated output. Structured error records for invalid input.

**Pre-flight budget check** - Before any work is done, the Actor compares the projected cost against your remaining spending limit and exits cleanly with an `InsufficientFunds` error record if there is not enough headroom.

**MCP-ready** - First-class tool on the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp) for Claude, ChatGPT, Cursor, and any other MCP-compatible agent.

***

### Usage examples

#### Example 1: Basic search

```json
{
  "q": "coffee",
  "location": "Austin, Texas, United States",
  "max_pages": 1
}
```

#### Example 2: Local SEO rank tracking

```json
{
  "q": "best pizza",
  "location": "Brooklyn, New York, United States",
  "gl": "us",
  "hl": "en",
  "max_pages": 3
}
```

#### Example 3: International market

```json
{
  "q": "boulangerie",
  "location": "Paris, France",
  "google_domain": "google.fr",
  "gl": "fr",
  "hl": "fr",
  "max_pages": 2
}
```

#### Example 4: Mobile layout

```json
{
  "q": "gym near me",
  "location": "San Francisco, California, United States",
  "device": "mobile",
  "max_pages": 2
}
```

#### Example 5: Specific place by Google CID

```json
{
  "q": "the standard hotel",
  "ludocid": "14414772292044717666",
  "max_pages": 1
}
```

***

### Example output

Each dataset item is one page of Google Local results. Excerpt:

```json
{
  "page_number": 1,
  "search_timestamp": "2026-05-12T10:30:00.123456",
  "search_parameters": {
    "q": "coffee",
    "location": "Austin, Texas, United States",
    "gl": "us",
    "hl": "en",
    "device": "desktop",
    "max_pages": 1
  },
  "search_metadata": {
    "pages_processed": 1,
    "max_pages_set": 1,
    "pagination_limit_reached": false,
    "total_results_estimate": null
  },
  "local_results": [
    {
      "position": 1,
      "title": "Houndstooth Coffee",
      "rating": 4.6,
      "reviews_original": "(1.2K)",
      "reviews": 1200,
      "price": "$$",
      "type": "Coffee shop",
      "address": "401 Congress Ave Suite 100C, Austin, TX",
      "hours": "Open until 7 PM",
      "place_id": "1234567890123456789",
      "gps_coordinates": {"latitude": 30.2672, "longitude": -97.7431},
      "service_options": {"dine_in": true, "takeout": true, "delivery": false},
      "links": {
        "directions": "https://www.google.com/maps/dir/?...",
        "website": "https://houndstoothcoffee.com/",
        "order": "https://order.example.com/houndstooth"
      },
      "thumbnail": "https://lh3.googleusercontent.com/...",
      "thumbnail_large": "https://lh3.googleusercontent.com/...",
      "place_id_search": "https://www.google.com/maps?cid=1234567890123456789"
    }
  ],
  "ads_results": [],
  "local_map": {"image": "https://.../"},
  "discover_more_places": [
    {"title": "Best coffee", "places": "Mozart's, Cafe Medici, Houndstooth..."}
  ],
  "pagination": {"current": 1}
}
```

***

### Input parameters

| Parameter | Type | Required | Default | Notes |
|---|---|---|---|---|
| `q` | string | yes | `coffee` | Search query |
| `location` | string | no | `Austin, Texas, United States` | City-level location; cannot combine with `uule` |
| `uule` | string | no | - | Google-encoded location for precise targeting |
| `google_domain` | string | no | `google.com` | Regional Google domain |
| `gl` | string | no | `us` | 2-letter country code |
| `hl` | string | no | `en` | 2-letter language code |
| `ludocid` | string | no | - | Google CID for a specific place |
| `tbs` | string | no | - | Advanced filter string |
| `device` | enum | no | `desktop` | `desktop`, `tablet`, or `mobile` |
| `max_pages` | integer | no | `1` | 0 = unlimited (safety cap 20) |

***

### Pricing

This Actor uses Apify's **pay-per-event** model:

| Event | Cost | When charged |
|---|---|---|
| `setup` | $0.02 | Once per run |
| `page_processed` | $0.02 | Per page of results |

**Worked example**: a 10-page run costs `$0.02 (setup) + 10 x $0.02 (pages) = $0.22`. A single-page run costs `$0.04`. Failed validation (missing `q`, conflicting `location` + `uule`) writes a structured error record to the dataset and exits **without charging** anything beyond setup.

You always know your maximum cost up front: `setup + (max_pages x page_processed)`.

***

### How to get started

1. Click **Try for free** at the top of this Actor's Apify Store page.
2. Set a `q` (search query) and, if you want geo-targeted results, a `location`.
3. Run the Actor. Each page is pushed as its own dataset item; you can export to JSON, CSV, or Excel.
4. (Optional) Wire this Actor into Claude, ChatGPT, or Cursor through the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp) - see the MCP section above.

For a Python quick-start and an MCP setup walkthrough, see the [example repo on GitHub](https://github.com/johnisanerd/Apify-Google-Local-API).

***

### 🔌 Integrations: Automate Local Pack Monitoring with the Google Local API

A single run answers one question: who ranks in the Austin coffee local pack today. The real value of the Google Local API comes from running it on a schedule, so local pack rankings, new competitors, and review counts land in your stack automatically. See the full list of [Apify platform integrations](https://docs.apify.com/platform/integrations).

**Tasks and Schedules (the core recipe).** Save one [task](https://docs.apify.com/platform/actors/running/tasks) per query and city you track, for example "plumber" in Phoenix, then attach a [schedule](https://docs.apify.com/platform/schedules) from the Actor's Actions, then Schedule menu. Useful cron strings: `0 7 * * *` (daily at 7 AM), `0 */6 * * *` (every six hours), `0 9 * * 1` (Mondays). One schedule can trigger many tasks at once, so an agency can refresh every client keyword in a single nightly run. The [Google local pack rank tracker for SEO agencies](https://apify.com/johnvc/google-local-api/examples/google-local-pack-rank-tracker-seo-agencies?fpr=9n7kx3) task is a ready-made starting point.

**n8n.** This API ships an n8n community node (see the n8n integration section below). A four-step monitor: Schedule Trigger, then the Google Local API node, then a Filter on `rating` or `position`, then Slack or email with the day's local pack.

**Make and Zapier.** The same pattern works no-code with [Make](https://docs.apify.com/platform/integrations/make) and [Zapier](https://docs.apify.com/platform/integrations/zapier): trigger on a schedule, run the Actor, then route the results where you need them.

**Store the history (Supabase).** Send each run's businesses into a table so a local pack ranking history accumulates over time. No-code: the n8n Actor node, then a Supabase node. Or in Python, using the real Actor id `johnvc/google-local-api` and the output fields (each dataset item is one page with a `local_results` array; each business carries `title`, `rating`, `reviews`, `place_id`, and `gps_coordinates`):

```python
from apify_client import ApifyClient
from supabase import create_client

apify = ApifyClient("YOUR_APIFY_TOKEN")
supabase = create_client("YOUR_SUPABASE_URL", "YOUR_SUPABASE_KEY")

run = apify.actor("johnvc/google-local-api").call(run_input={
    "q": "plumber",
    "location": "Phoenix, Arizona, United States",
    "max_pages": 2,
})

rows = []
for page in apify.dataset(run["defaultDatasetId"]).iterate_items():
    for biz in page.get("local_results", []):
        rows.append({
            "query": "plumber",
            "city": "Phoenix",
            "position": biz.get("position"),
            "title": biz.get("title"),
            "rating": biz.get("rating"),
            "reviews": biz.get("reviews"),
            "place_id": biz.get("place_id"),
        })

supabase.table("local_pack_rankings").upsert(rows).execute()
```

**MCP and AI agents.** Add the Google Local API as a tool in Claude or Cursor through the [Apify MCP server](https://mcp.apify.com/) so an agent can pull the live local pack on demand (see the MCP section near the top). In [Claude Code](https://claude.ai/referral/uIlpa7nPLg) (free trial) or [Claude Cowork](https://claude.ai/referral/uIlpa7nPLg) (free trial), an agent can answer "which three plumbers rank in the Phoenix local pack, and what are their ratings?" with structured data.

**Webhooks.** For anything custom, fire an [Apify webhook](https://docs.apify.com/platform/integrations/webhooks) on `ACTOR.RUN.SUCCEEDED` to push each run's dataset into your own service.

***

### 🔗 Related Tools

Building a local search or lead-generation pipeline? These tools from the same catalog pair well with the Google Local API:

- [Google Maps Places Scraper](https://apify.com/johnvc/google-maps-places-api?fpr=9n7kx3): pull the full place profile (photos, complete hours, popular times, and more) for any business you find in the local pack, by `place_id`.
- [Google Maps Directions API](https://apify.com/johnvc/google-maps-directions-api?fpr=9n7kx3): compute routes and travel times between the local businesses this Actor returns.
- [Google Local Services API](https://apify.com/johnvc/google-local-services-api?fpr=9n7kx3): the companion for Local Services Ads and Google Guaranteed pros, a different local surface from the organic local pack.
- [Yelp Search API](https://apify.com/johnvc/yelp-search-api?fpr=9n7kx3): cross-reference the same businesses on Yelp for extra reviews and category data.

Alternatives such as the [Google SERP Scraper](https://apify.com/alizarin_refrigerator-owner/google-serp-scraper?fpr=9n7kx3) fold the local pack into a general search-results scraper: it carries no user rating and returns the local pack as one nested array among organic results, ads, and snippets. This API is purpose-built for the local pack and returns clean, per-business records with rating, reviews, phone, hours, `place_id`, and GPS coordinates.

***

### FAQ

#### Is this a Google Maps scraper?

No. This Actor targets the **Google Local Search SERP** - the local pack inside a normal Google Search results page. The data layout, ranking, and ad behavior differ from Google Maps. Use this when you care about the SERP surface (local SEO rank tracking, snippet-style results, ad presence inside Search) rather than the Maps app.

#### How many businesses are returned per page?

Roughly 20 on desktop and 10 on mobile, matching what Google ships. Set `device` and `max_pages` to control.

#### Will my cost spike if Google returns more results than I expected?

No. You pay per page fetched, not per business. The cost of a single-page run is fixed at `$0.04` regardless of how many local results that page contains.

#### Why are there both a `location` and a `uule` input?

`location` is the easy path (just a city name). `uule` is for advanced users who want sub-city or coordinate-level precision via Google's encoded-location format. They cannot be used together.

#### What happens if I supply an invalid input?

The Actor exits with a structured `error` record before doing any billable work. No setup or page charges are applied.

#### Does this work with AI agents through MCP?

Yes. See the **Use with Claude, ChatGPT, Cursor & other AI agents (MCP)** section near the top. MCP-compatible clients can discover and call this Actor natively.

#### Where do I see results?

In the Apify console under your run's **Dataset** tab. Export as JSON, CSV, or Excel from there. Each dataset item is one page; iterate them to walk all results.

#### What data does the Google Local API return?

Each dataset item is one page of the local pack. Every business in `local_results` carries a `title`, `rating`, `reviews` count, `price` tier, `type` (category), `address`, `hours`, `place_id`, `gps_coordinates`, `service_options` (dine-in, takeout, delivery), and action `links` (directions, website, order, phone). The record also includes `ads_results` (paid local placements) and `discover_more_places` (the related-place suggestions Google appends). See the What data you get section above for the full field list.

#### Can I schedule the Google Local API?

Yes, and this is where most of the value is. Any run can be automated on a [schedule](https://docs.apify.com/platform/schedules): save a [task](https://docs.apify.com/platform/actors/running/tasks) with your query and city, then attach a schedule from the Actor's Actions, then Schedule menu. Concrete cron strings: `0 7 * * *` for daily at 7 AM, `0 */6 * * *` for every six hours, and `0 9 * * 1` for Mondays. One schedule can trigger many tasks at once, so an agency can refresh every client keyword in a single run. See the Integrations section above for the full local pack monitoring recipe.

#### Should I use an API or a Web Scraper?

Both, and this Actor is both. An official [API](https://en.wikipedia.org/wiki/API) for local search is usually rate limited, quota bound, and often missing fields, while a hand-rolled [web scraper](https://en.wikipedia.org/wiki/Web_scraping) fights captchas and breaks when the page changes. This Actor gives you the clean, structured result of a purpose-built API you call yourself, with no quotas and no browser to babysit, over the same local pack a real user sees.

#### Can I integrate this local search Scraper with other apps?

Yes. It connects to almost any cloud service through [Apify integrations](https://docs.apify.com/platform/integrations): [Make](https://docs.apify.com/platform/integrations/make), [Zapier](https://docs.apify.com/platform/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), the n8n community node, and [webhooks](https://docs.apify.com/platform/integrations/webhooks) on `ACTOR.RUN.SUCCEEDED` for custom actions. See the Integrations section above for full recipes.

#### Can I use the Google Local API with the API?

Yes. The Apify API runs the Actor, schedules it, and fetches datasets, and the `apify-client` package exists for both Node.js and Python. See the Actor's [API tab](https://apify.com/johnvc/google-local-api/api?fpr=9n7kx3) for ready-made snippets in each language.

#### Can I use the Google Local API through an MCP server?

Yes. Add it as a tool in any MCP client (Claude, Cursor, and others) through the hosted [Apify MCP server](https://mcp.apify.com/) with the Actor-specific URL `https://mcp.apify.com/?tools=actors,docs,johnvc/google-local-api`. In [Claude Code](https://claude.ai/referral/uIlpa7nPLg) (free trial) or [Claude Cowork](https://claude.ai/referral/uIlpa7nPLg) (free trial) your agent can then answer questions like "who ranks in the Chicago dentist local pack?" with live data. See the [Apify MCP docs](https://docs.apify.com/platform/integrations/mcp).

#### Will AI replace Google for local business discovery?

AI assistants increasingly answer "find me a highly rated business near me" directly, but they still pull from the same underlying local results Google ranks. That makes the local pack more important to monitor, not less: feeding an agent live local pack data through MCP is how you keep AI answers grounded in current rankings, reviews, and contact details.

#### How do I track visibility in Google's AI Overviews for local businesses?

This Actor covers the organic local pack. To monitor how a local business shows up in Google's AI-generated answers, pair it with the [Google AI Overview API](https://apify.com/johnvc/Google-AI-Overview-API?fpr=9n7kx3), then compare the two surfaces for the same query and city.

#### How else can I collect local business data?

Pair the Google Local API with related tools in the same catalog: the [Google Maps Places Scraper](https://apify.com/johnvc/google-maps-places-api?fpr=9n7kx3) for full place profiles by `place_id`, the [Google Maps Directions API](https://apify.com/johnvc/google-maps-directions-api?fpr=9n7kx3) for routing between businesses, the [Google Local Services API](https://apify.com/johnvc/google-local-services-api?fpr=9n7kx3) for Local Services Ads, and the [Yelp Search API](https://apify.com/johnvc/yelp-search-api?fpr=9n7kx3) for a second review source. The local pack itself comes from [Google](https://www.google.com/); for background see [local search](https://en.wikipedia.org/wiki/Local_search_\(Internet\)).

***

Whether you are wiring this up as an MCP tool for Claude, ChatGPT, or Cursor - or pulling Google Local data directly through Apify's API - you will have clean, structured local pack results in minutes. Click **Try for free** to run your first search.

### n8n integration

There is a free, ready-made n8n template built on this API: **[Track Google local pack rankings in Google Sheets](https://n8n.io/workflows/17523-track-google-local-pack-rankings-in-google-sheets-with-apify/)**. Put your keywords, city, and business name in one node, and every week it appends the full local pack for each keyword to a sheet: position, business, category, rating, review count, and address, with your own listing flagged. Because it logs the whole pack rather than just your rank, the sheet doubles as a competitor watch. No rank tracker subscription and no SERP API key. It uses the official Apify node, so it runs on n8n Cloud and self-hosted.

A second free template covers reputation instead of rank: **[Track competitor Google review ratings and counts in Google Sheets](https://n8n.io/workflows/17596-track-competitor-google-review-ratings-and-counts-with-apify-and-google-sheets/)**. Give it your business name, a search term, and a city, and every week it records the star rating and review count of every business in that local pack, with the gap between you and each rival worked out for you. Because it reads Google's public local results rather than a listing you own, it picks up competitors as easily as your own business, which a Google Business Profile integration cannot do. Note that it records rating and review count, not the text of individual reviews.

Also available as an n8n community node, **[n8n-nodes-google-local-api](https://www.npmjs.com/package/n8n-nodes-google-local-api)**. In n8n: Settings, Community Nodes, install `n8n-nodes-google-local-api`, then use it in any workflow (it also works as an AI Agent tool).

### Featured Tasks

Ready-to-run examples that show this API solving a specific problem. Each opens its own setup so you can run it on your account in one click.

- [Track local pack rankings for plumbers in Phoenix](https://apify.com/johnvc/google-local-api/examples/track-local-pack-rankings-plumbers-phoenix?fpr=9n7kx3) - which plumbers rank in the Phoenix local pack, with rating, reviews, phone, and address.

- [Find HVAC contractor leads in Dallas](https://apify.com/johnvc/google-local-api/examples/find-hvac-contractor-leads-dallas?fpr=9n7kx3) - HVAC contractors in Dallas from the local pack, with contact details for outreach.

- [Check the Google local pack for dentists in Chicago](https://apify.com/johnvc/google-local-api/examples/check-local-pack-dentists-chicago?fpr=9n7kx3) - who ranks in the Chicago dentist local pack, with rating, reviews, and rank.

- [Google local pack rank tracker for SEO agencies](https://apify.com/johnvc/google-local-api/examples/google-local-pack-rank-tracker-seo-agencies?fpr=9n7kx3) - track local pack rankings across keywords and cities for SEO clients.

- [Check Google local pack rankings for restaurants in Miami](https://apify.com/johnvc/google-local-api/examples/check-local-pack-rankings-restaurants-miami?fpr=9n7kx3) - which restaurants rank in the Miami local pack, with rating, reviews, and rank.

- [Track plumber near me local pack rankings](https://apify.com/johnvc/google-local-api/examples/track-plumber-near-me-local-pack-rankings?fpr=9n7kx3) - track which plumbers rank in Google's local pack for 'plumber near me' in any city.

- [Monitor local SERP visibility for dentist SEO](https://apify.com/johnvc/google-local-api/examples/monitor-local-serp-visibility-for-dentist-seo?fpr=9n7kx3) - monitor a dentist's visibility in Google's local SERP for any city.

- [Find local plumber leads in Tampa Florida](https://apify.com/johnvc/google-local-api/examples/find-local-plumber-leads-in-tampa-florida?fpr=9n7kx3) - build a plumber lead list for Tampa, Florida from Google's local results.

- [Find HVAC contractor leads in Phoenix Arizona](https://apify.com/johnvc/google-local-api/examples/find-hvac-contractor-leads-in-phoenix-arizona?fpr=9n7kx3) - build an HVAC contractor lead list for Phoenix, Arizona from Google's local results.

- [Build a roofer contact list for Dallas Texas](https://apify.com/johnvc/google-local-api/examples/build-a-roofer-contact-list-for-dallas-texas?fpr=9n7kx3) - get every roofer in Google's local results for Dallas, Texas as structured data.

- [List water damage restoration companies in Houston](https://apify.com/johnvc/google-local-api/examples/list-water-damage-restoration-companies-in-houston?fpr=9n7kx3) - list water damage restoration companies in Houston from Google's local results, with phone, address, rating, review count, and GPS for each business..

- [Find med spas in Scottsdale with ratings](https://apify.com/johnvc/google-local-api/examples/find-med-spas-in-scottsdale-with-ratings?fpr=9n7kx3) - find every med spa in Google's local results for Scottsdale, Arizona.

- [Find water damage restoration leads in Dallas](https://apify.com/johnvc/google-local-api/examples/find-water-damage-restoration-leads-dallas?fpr=9n7kx3) - find water damage restoration companies in Dallas from the Google local pack.

- [Find water damage restoration leads in Phoenix](https://apify.com/johnvc/google-local-api/examples/find-water-damage-restoration-leads-phoenix?fpr=9n7kx3) - find water damage restoration companies in Phoenix from the Google local pack.

- [Find dental implant leads in Phoenix](https://apify.com/johnvc/google-local-api/examples/find-dental-implant-leads-phoenix?fpr=9n7kx3) - find dental implant providers in Phoenix from the Google local pack.

- [Find assisted living facility leads in Phoenix](https://apify.com/johnvc/google-local-api/examples/find-assisted-living-leads-phoenix?fpr=9n7kx3) - find assisted living facilities in Phoenix from the Google local pack.

- [Find financial advisor leads in Denver](https://apify.com/johnvc/google-local-api/examples/find-financial-advisor-leads-denver?fpr=9n7kx3) - find financial advisors in Denver from the Google local pack.

- [Find med spa leads in Dallas](https://apify.com/johnvc/google-local-api/examples/find-med-spa-leads-dallas?fpr=9n7kx3) - find med spas in Dallas from the Google local pack.

- [Find home care agency leads in Philadelphia](https://apify.com/johnvc/google-local-api/examples/find-home-care-agency-leads-philadelphia?fpr=9n7kx3) - find home care agencies in Philadelphia from the Google local pack.

- [Find immigration lawyer leads in New York](https://apify.com/johnvc/google-local-api/examples/find-immigration-lawyer-leads-new-york?fpr=9n7kx3) - find immigration lawyers in New York from the Google local pack.

- [Find tree service leads in Houston](https://apify.com/johnvc/google-local-api/examples/find-tree-service-leads-houston?fpr=9n7kx3) - find tree service companies in Houston from the Google local pack.

- [Find pest control leads in Tampa](https://apify.com/johnvc/google-local-api/examples/find-pest-control-leads-tampa?fpr=9n7kx3) - find pest control companies in Tampa from the Google local pack.

- [Find junk removal leads in Houston](https://apify.com/johnvc/google-local-api/examples/find-junk-removal-leads-houston?fpr=9n7kx3) - find junk removal companies in Houston from the Google local pack.

- [Find appliance repair leads in Chicago](https://apify.com/johnvc/google-local-api/examples/find-appliance-repair-leads-chicago?fpr=9n7kx3) - find appliance repair companies in Chicago from the Google local pack.

- [Find concrete contractor leads in Dallas](https://apify.com/johnvc/google-local-api/examples/find-concrete-contractor-leads-dallas?fpr=9n7kx3) - find concrete contractors in Dallas from the Google local pack.

- [Find solar installer leads in San Diego](https://apify.com/johnvc/google-local-api/examples/find-solar-installer-leads-san-diego?fpr=9n7kx3) - find solar installers in San Diego from the Google local pack.

- [Find Medicare insurance agent leads in Houston](https://apify.com/johnvc/google-local-api/examples/find-medicare-agent-leads-houston?fpr=9n7kx3) - find Medicare insurance agents in Houston from the Google local pack.

- [Find mortgage broker leads in Chicago](https://apify.com/johnvc/google-local-api/examples/find-mortgage-broker-leads-chicago?fpr=9n7kx3) - find mortgage brokers in Chicago from the Google local pack.

- [Find painting contractor leads in Denver](https://apify.com/johnvc/google-local-api/examples/find-painting-contractor-leads-denver?fpr=9n7kx3) - find painting contractors in Denver from the Google local pack.

- [Find water damage restoration leads](https://apify.com/johnvc/google-local-api/examples/find-water-damage-restoration-leads?fpr=9n7kx3) - find water damage restoration companies in any city from the Google local pack.

- [Find dental implant leads](https://apify.com/johnvc/google-local-api/examples/find-dental-implant-leads?fpr=9n7kx3) - find dental implant providers in any city from the Google local pack.

- [Find assisted living facility leads](https://apify.com/johnvc/google-local-api/examples/find-assisted-living-leads?fpr=9n7kx3) - find assisted living facilities in any city from the Google local pack.

- [Find financial advisor leads](https://apify.com/johnvc/google-local-api/examples/find-financial-advisor-leads?fpr=9n7kx3) - find financial advisors in any city from the Google local pack.

- [Find med spa leads](https://apify.com/johnvc/google-local-api/examples/find-med-spa-leads?fpr=9n7kx3) - find med spas in any city from the Google local pack.

- [Find home care agency leads](https://apify.com/johnvc/google-local-api/examples/find-home-care-agency-leads?fpr=9n7kx3) - find home care agencies in any city from the Google local pack.

- [Find immigration lawyer leads](https://apify.com/johnvc/google-local-api/examples/find-immigration-lawyer-leads?fpr=9n7kx3) - find immigration lawyers in any city from the Google local pack.

- [Find tree service leads](https://apify.com/johnvc/google-local-api/examples/find-tree-service-leads?fpr=9n7kx3) - find tree service companies in any city from the Google local pack.

- [Find pest control leads](https://apify.com/johnvc/google-local-api/examples/find-pest-control-leads?fpr=9n7kx3) - find pest control companies in any city from the Google local pack.

- [Find junk removal leads](https://apify.com/johnvc/google-local-api/examples/find-junk-removal-leads?fpr=9n7kx3) - find junk removal companies in any city from the Google local pack.

- [Find appliance repair leads](https://apify.com/johnvc/google-local-api/examples/find-appliance-repair-leads?fpr=9n7kx3) - find appliance repair companies in any city from the Google local pack.

- [Find concrete contractor leads](https://apify.com/johnvc/google-local-api/examples/find-concrete-contractor-leads?fpr=9n7kx3) - find concrete contractors in any city from the Google local pack.

- [Find solar installer leads](https://apify.com/johnvc/google-local-api/examples/find-solar-installer-leads?fpr=9n7kx3) - find solar installers in any city from the Google local pack.

- [Find Medicare insurance agent leads](https://apify.com/johnvc/google-local-api/examples/find-medicare-insurance-agent-leads?fpr=9n7kx3) - find Medicare insurance agents in any city from the Google local pack.

- [Find mortgage broker leads](https://apify.com/johnvc/google-local-api/examples/find-mortgage-broker-leads?fpr=9n7kx3) - find mortgage brokers in any city from the Google local pack.

- [Find painting contractor leads](https://apify.com/johnvc/google-local-api/examples/find-painting-contractor-leads?fpr=9n7kx3) - find painting contractors in any city from the Google local pack.

- [Export Google Local Results to CSV](https://apify.com/johnvc/google-local-api/examples/export-google-local-results-to-csv?fpr=9n7kx3)

***

### 🌐 About Alpha OSINT

This Actor is part of [Alpha OSINT](https://www.alphaosint.com), toolset of financial and operations data sources and APIs.
See the [Google Local API source page](https://www.alphaosint.com/sources/google-local-api/) for related tools and use cases.
For support or requests for this actor, please start a ticket [directly on our support page](https://apify.com/johnvc/google-local-api/issues/open?fpr=9n7kx3).

Last Updated: 2026.09.10

# Actor input Schema

## `q` (type: `string`):

The Google Local search query. Examples: 'coffee', 'dentists near me', 'plumbers in Brooklyn', 'best pizza'. Combine with the 'location' field for city-level targeting. Any term valid in Google Local search is accepted.

## `location` (type: `string`):

City-level location (e.g., 'Austin, Texas, United States', 'London', 'Brooklyn, New York'). Optional but recommended. Cannot be combined with 'uule'. If both are omitted, results use the API's default origin.

## `uule` (type: `string`):

Advanced: Google-encoded location string for precise geographic targeting. Use instead of 'location' for fine-grained control. Cannot be combined with 'location'.

## `google_domain` (type: `string`):

Which Google domain to query (e.g., 'google.com', 'google.co.uk', 'google.fr', 'google.de'). Defaults to 'google.com'. Use the regional domain for localized result formatting.

## `gl` (type: `string`):

Two-letter country code (ISO 3166-1 alpha-2, e.g., 'us', 'uk', 'fr', 'de', 'jp'). Localizes search results to that country. Defaults to 'us'.

## `hl` (type: `string`):

Two-letter language code (ISO 639-1, e.g., 'en', 'es', 'fr', 'de', 'ja'). Sets the language for the interface and result content. Defaults to 'en'.

## `ludocid` (type: `string`):

Advanced: Google customer identifier (CID) for a specific place. When provided, narrows results around that single business.

## `tbs` (type: `string`):

Advanced: Google search filter string for criteria not exposed elsewhere. See Google's filter documentation for valid syntax.

## `device` (type: `string`):

Which device to emulate. Affects results-per-page count (desktop returns about 20 per page, mobile about 10) and result formatting. Defaults to 'desktop'.

## `max_pages` (type: `integer`):

Maximum number of result pages to fetch (1-indexed). Set 0 for unlimited, bounded by a safety cap of 20 pages. Default: 1. Each fetched page is billed separately under pay-per-event.

## Actor input object example

```json
{
  "q": "coffee",
  "location": "Austin, Texas, United States",
  "google_domain": "google.com",
  "gl": "us",
  "hl": "en",
  "device": "desktop",
  "max_pages": 1
}
```

# Actor output Schema

## `allResults` (type: `string`):

Complete dataset with every page returned by the run. Each item is one page and contains local\_results, ads\_results, local\_map, discover\_more\_places, and search metadata.

## `localResults` (type: `string`):

Filtered view focused on the local\_results array - the organic local pack businesses Google returns for the query, with rating, reviews, phone, hours, GPS, and place\_id.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "q": "coffee",
    "location": "Austin, Texas, United States",
    "google_domain": "google.com",
    "gl": "us",
    "hl": "en"
};

// Run the Actor and wait for it to finish
const run = await client.actor("johnvc/google-local-api").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "q": "coffee",
    "location": "Austin, Texas, United States",
    "google_domain": "google.com",
    "gl": "us",
    "hl": "en",
}

# Run the Actor and wait for it to finish
run = client.actor("johnvc/google-local-api").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "q": "coffee",
  "location": "Austin, Texas, United States",
  "google_domain": "google.com",
  "gl": "us",
  "hl": "en"
}' |
apify call johnvc/google-local-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,johnvc/google-local-api"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/bZ3PtlNaHVObbbR4O/builds/STm5nCZddPE9aqGyJ/openapi.json