# Google Maps Rank Tracker - Geo-Grid Rank Changes & Competitors (`tenfoldfleet/google-maps-rank-tracker`) Actor

Check your business's Google Maps ranking for a keyword from 9 to 225 map points around it (local SEO geo-grid). Each point: rank, top 3 listings and the move since your last run. Each keyword: average rank, top-3 share and the rivals that win most points. $5 per 1,000 points; failed points free.

- **URL**: https://apify.com/tenfoldfleet/google-maps-rank-tracker.md
- **Developed by:** [Tenfold Fleet](https://apify.com/tenfoldfleet) (community)
- **Categories:** SEO tools, Agents, MCP servers
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.50 / 1,000 grid point checkeds

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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

Not affiliated with Google. This Actor reads public Google Maps search results.

### What does Google Maps Rank Tracker do?

**Google Maps Rank Tracker** shows where a business appears in **Google Maps** results for a keyword, not from one spot but from every point of a **geo-grid** laid over the area around it. A searcher three streets away often sees a different order than one in the next district, and this Actor measures that spread.

Give it a keyword such as `dentist`, the business to look for and the middle of the grid. It searches Google Maps from each grid point and returns the **local rank at every point**, the **average rank**, the share of points where the business is in the **top 3** (the map pack), the **competitors** that beat it, and the **rank change since your last run**. Use it from the Apify Console, or as a **local rank tracking API** from your own code, Make, Zapier, n8n or an AI agent.

### Why use it?

- **Local SEO reports**: show a client a colored grid of their Google Maps visibility, and how it moves month to month.
- **Weekly rank monitoring**: schedule the same grid and see which points went up, down, appeared or dropped out.
- **Competitor research**: find which businesses own the top 3 across your area and how many points each one wins.
- **Service-area planning**: see how far from the office the business stops showing up.
- **Agencies and AI agents**: one API call returns clean JSON for every point, ready for dashboards.

### What data can it extract?

![Sample output of Google Maps Rank Tracker, rows from a real run: Row type, Keyword, Grid row, Grid column, Rank, Business found](https://api.apify.com/v2/key-value-stores/4TBgG7fopkYMNWnX2/records/google-maps-rank-tracker-output.png)

| Field | Example |
|---|---|
| Keyword | `dentist` |
| Grid row / column, latitude, longitude | `1`, `3`, `30.2762`, `-97.7327` |
| Distance and direction from the center | `1.41` km, `NE` |
| Rank at this point (null = not in the results checked) | `2` |
| Matched listing, place ID, CID, rating, reviews | `Swish Dental Downtown`, `ChIJ...`, `4.5`, `985` |
| Top 3 listings at this point | title, rank, rating, reviews, website |
| Last run's rank, change, status | `4`, `+2`, `up` |
| Keyword summary | average rank, top-3 share, best and worst rank, text grid, top competitors |

### How to track Google Maps rankings on a grid

1. Enter one or more **keywords** your customers search for.
2. Enter the **business**: its name as shown on Google Maps, its website, or (most exact) its Google Maps place link.
3. Set the **grid center**: coordinates, a Google Maps link or an address. A place link as the business also gives the center.
4. Choose the **grid size** (3 x 3 up to 15 x 15) and the **radius** in km from the center to the edge.
5. Click **Start**. Open the **REPORT** record for the colored grid, or the dataset for every point.
6. Schedule the run (for example weekly) to get **changes since the last run** on each point.

### How much does it cost?

You pay **$5 per 1,000 grid points** ($0.005 per point and keyword) plus a tiny start fee. A 5 x 5 grid for one keyword is 25 points = **$0.125**; a 7 x 7 grid is $0.245. Points that fail are free, and the keyword summaries and the HTML grid are free. Set a maximum cost per run and the Actor stops there.

**Free Apify plan:** one keyword on a 3 x 3 grid per run and up to 27 points a day, because each point costs us a data fee. Any paid Apify plan removes these limits.

### Input

```json
{
    "keywords": ["dentist", "emergency dentist"],
    "business": "Swish Dental Downtown",
    "center": "30.2672, -97.7431",
    "gridSize": 5,
    "radiusKm": 2,
    "zoom": 15,
    "depth": 20,
    "trackChanges": true
}
```

### Output

Each grid point is one dataset row; each keyword also gets one free summary row. Download the results as JSON, CSV, Excel or HTML, or read them through the Apify API.

```json
{
    "type": "grid-point",
    "keyword": "dentist",
    "business": "Swish Dental Downtown",
    "row": 1,
    "column": 3,
    "latitude": 30.2761832,
    "longitude": -97.7327249,
    "distanceKm": 1.41,
    "direction": "NE",
    "rank": 2,
    "found": true,
    "inTop3": true,
    "matchedTitle": "Swish Dental Downtown",
    "rating": 4.5,
    "reviews": 985,
    "topResults": [{ "rank": 1, "title": "Enamel Dentistry Saltillo (East Austin)", "rating": 4.8, "reviews": 664 }],
    "previousRank": 4,
    "rankChange": 2,
    "changeStatus": "up"
}
```

The summary row holds `averageRank`, `averageRankAllPoints` (not-found points count as depth + 1), `top3Share`, `top10Share`, `bestRank`, `worstRank`, a text `grid` (north at the top) and `topCompetitors`.

### Tips

- Use the business's **Google Maps place link** when it has branches with similar names. With a plain name or website, the branch found most often is tracked at every point.
- Keep the **same center, grid and radius** between runs: changes are matched point by point.
- A 5 x 5 grid with a 2-3 km radius suits most city businesses; use 7 x 7 or 9 x 9 for service areas.
- Rank history is kept in a key-value store named `google-maps-rank-tracker-history` in your own account.

### FAQ

#### How is the rank counted?

The rank is the position among the organic Google Maps listings at that point (ads are skipped). If the business is not in the results checked (20 by default, up to 100), the point shows `rank: null` and `found: false`, and it is still a charged result because the search was done.

#### Can I enter an address instead of coordinates?

Yes. An address is turned into coordinates with OpenStreetMap search. If it cannot be found, use coordinates or a Google Maps link.

#### Does it work outside the US?

Yes, anywhere Google Maps works. Set the language code for the country, for example `de` or `es`.

#### Is it legal?

It reads public search results only. No login and no personal data beyond what businesses publish on their listings. Check the rules that apply to your use.

### More tools from Tenfold Fleet

| Actor | Output |
|---|---|
| [Google Maps Extractor - Business Leads, Phones & Websites](https://apify.com/tenfoldfleet/google-maps-extractor) | place |
| [Google AI Overviews Checker - Citations & Domain Tracker](https://apify.com/tenfoldfleet/google-ai-overviews-checker) | keyword checked |
| [Google Images API - Image Search Results in 90+ Countries](https://apify.com/tenfoldfleet/google-images-api) | image result |
| [Google Keyword Planner Alternative - Ideas, Bids & Volume](https://apify.com/tenfoldfleet/google-keyword-planner) | keyword idea |
| [Google Trends Scraper - Search Interest by Region and Over Time](https://apify.com/tenfoldfleet/google-trends-scraper) | keyword |
| [Google Ads Transparency Center Scraper - Competitor Ads by Site](https://apify.com/tenfoldfleet/google-ads-transparency-scraper) | ad |
| [Google Flights API & Scraper - Fares by Route and Date](https://apify.com/tenfoldfleet/google-flights-scraper) | route search |
| [Google Hotels Scraper - Nightly Prices, Stars & Booking Sites](https://apify.com/tenfoldfleet/google-hotels-scraper) | hotel |
| [Google for Jobs Scraper - Openings by City, Pay & Job Board](https://apify.com/tenfoldfleet/google-jobs-scraper) | job listing |
| [Google News Scraper - Articles, Real URLs & Full Text](https://apify.com/tenfoldfleet/google-news-scraper) | article |
| [Google Travel Hotel Rate Tracker - OTA Prices for Every Night](https://apify.com/tenfoldfleet/google-travel-hotel-rate-tracker) | offer |
| [ASO Keyword Rank Tracker: iOS & Android App Positions](https://apify.com/tenfoldfleet/aso-keyword-rank-tracker-app-store-google-play) | keyword check |

All 122 tools: [apify.com/tenfoldfleet](https://apify.com/tenfoldfleet). If this Actor saves you time, save it (the bookmark on its Store page) and leave a review: both help other people find it. Found a bug or need another field? Tell us on the Issues tab of this page.

# Changelog

This Actor's version history is a separate document: https://apify.com/tenfoldfleet/google-maps-rank-tracker/changelog.md

# Actor input Schema

## `keywords` (type: `array`):

What customers type into Google Maps, one per line, e.g. "dentist", "emergency plumber", "pizza near me". Every keyword is checked at every grid point. Up to 50 per run. Free Apify plan: the first keyword only.

## `business` (type: `string`):

The business whose rank you want: its name as shown on Google Maps ("Swish Dental Downtown"), its website (swishsmiles.com, matches every branch on that site), its Google Maps link (google.com/maps/place/...), a place ID (ChIJ...) or a CID. A Maps link or ID gives the most exact match.

## `center` (type: `string`):

Middle of the grid, usually the business location: coordinates ("30.2672, -97.7431"), a Google Maps link, or an address ("500 Congress Ave, Austin, TX"). Can be empty when the business is a Google Maps place link (its pin is used).

## `gridSize` (type: `integer`):

Points per side of the square grid: 3 = 3 x 3 = 9 points, 5 = 25, 7 = 49, 9 = 81, up to 15 = 225. Even numbers go up to the next odd number so the center is on the grid. Each point is one charged result. Free Apify plan: 3 x 3.

## `radiusKm` (type: `number`):

Distance from the center to the edge of the grid, in kilometres (1 mile = 1.61 km). Points are spread evenly inside. 1-3 km suits a city business, 5-15 km a service area.

## `zoom` (type: `integer`):

Google Maps zoom level used at each point (higher = closer). 13-15 is typical for local rank checks.

## `depth` (type: `integer`):

How many Google Maps results are read at each point. The business counts as not found at a point when it ranks below this. Same price for any value.

## `languageCode` (type: `string`):

Google interface language code, e.g. "en", "es", "de", "fr".

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

Search as a desktop or a mobile user.

## `trackChanges` (type: `boolean`):

Remember this run's ranks (in a key-value store in your own Apify account) and show the change at every point the next time you run the same business, keyword and grid. Schedule the run weekly to monitor rankings.

## Actor input object example

```json
{
  "keywords": [
    "dentist"
  ],
  "business": "Swish Dental Downtown",
  "center": "30.2672, -97.7431",
  "gridSize": 3,
  "radiusKm": 1,
  "zoom": 15,
  "depth": 20,
  "languageCode": "en",
  "device": "desktop",
  "trackChanges": true
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `report` (type: `string`):

No description

# 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 = {
    "keywords": [
        "dentist"
    ],
    "business": "Swish Dental Downtown",
    "center": "30.2672, -97.7431",
    "gridSize": 3,
    "radiusKm": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("tenfoldfleet/google-maps-rank-tracker").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 = {
    "keywords": ["dentist"],
    "business": "Swish Dental Downtown",
    "center": "30.2672, -97.7431",
    "gridSize": 3,
    "radiusKm": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("tenfoldfleet/google-maps-rank-tracker").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 '{
  "keywords": [
    "dentist"
  ],
  "business": "Swish Dental Downtown",
  "center": "30.2672, -97.7431",
  "gridSize": 3,
  "radiusKm": 1
}' |
apify call tenfoldfleet/google-maps-rank-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tenfoldfleet/google-maps-rank-tracker"
        }
    }
}
```

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/cRc73eaCBzsgS2oqH/builds/qAXTZ0WWI6iam85aR/openapi.json
