# Google Maps Leads Tracker - New Businesses & Changes (`akhil_rajesh/google-maps-leads-tracker`) Actor

Google Maps leads for any keyword and area: phone, email and social profiles from each website, rating, reviews, lead score, online booking, unclaimed profiles. Only changes returns new businesses, closures and websites added or removed, with Slack, Discord, Teams or Telegram alerts.

- **URL**: https://apify.com/akhil_rajesh/google-maps-leads-tracker.md
- **Developed by:** [Akhil rajesh](https://apify.com/akhil_rajesh) (community)
- **Categories:** Lead generation, Automation, SEO tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 places

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

## Google Maps Leads Tracker: new businesses and changes

Find local businesses on Google Maps for any keyword and area, and track them run to run. Each place comes with its phone, its website (or the fact that it has none, or only a Facebook or Instagram page), rating, reviews, address, opening hours and whether its owner has claimed the Google Business Profile.

Schedule it with **Only changes** and every run returns only what changed in your area since the last one:

- **newPlace**: a business that just appeared (a new plumber in Austin, a new café in Shoreditch)
- **closed** / **reopened**: Google now marks it permanently closed, or no longer does
- **websiteAdded** / **websiteRemoved**: it got a website, or lost the one it had
- **phoneChanged**: a new phone number
- **renamed**: a new name

Switch on **Find emails** and each place's own website is read for its email and social profiles. Every place also gets a **lead score** (0-100) and says whether it **books online**.

Post the changes to **Slack, Discord, Microsoft Teams or Telegram** as they're found.

### What you can use it for

- **Agencies and freelancers**: businesses without a website, or with only a Facebook page, are web design leads. Unclaimed profiles and low ratings are local SEO and reputation leads.
- **Sales teams**: a weekly list of new businesses in your territory, with their phones, before anyone else calls them.
- **Suppliers and B2B services**: every new restaurant, salon, gym or clinic in your delivery area.
- **Market research**: how many dentists a city has, how many are rated under 4, how many opened this quarter.

### Input

The simplest input is a keyword and a place:

```json
{
  "searches": ["plumber"],
  "location": "Austin, TX"
}
```

| Field | What it does |
|---|---|
| Searches | Kinds of business: `plumber`, `hair salon`, `dentist`. A Google Maps search link works too (`https://www.google.com/maps/search/plumbers/@30.27,-97.74,13z`). |
| Location | A city, district or postcode with its state or country (`Austin, TX`, `Shoreditch, London`, `M5V 2T6`), or coordinates (`30.27, -97.74`). |
| More locations | More places, one per line. Each search is read in each place (up to 50 searches per run). |
| Radius (km) | How far around the location to search. Empty: the area Google gives the place (Austin: about 25 km). |
| Coverage | `fast` reads the centre only. `normal` and `thorough` search the area from a grid of centres, 6 km and 3 km apart, so a big city isn't cut at the 160 or so places Google lists per search. Austin plumbers (25 km): normal read 328 places in 4.5 minutes, thorough 371 in 8.5. |
| Max results | The most places a run returns, and charges. |
| Website | All places, only those **without a website**, or only those with one. |
| A social page counts as a website | Off by default: a place whose only link is Facebook, Instagram, Linktree or a Google business.site page counts as having no website of its own. |
| Rating, reviews | Minimum and maximum rating, minimum and maximum reviews (`Maximum reviews: 0` gives places nobody has reviewed yet). |
| Only places with a phone, Only unclaimed places | What they say. |
| Category words, Exclude words | Keep places with one of these words in a category, or leave out places with any of these words. |
| Find emails and social profiles | Read each place's own website (its homepage and up to 3 likely contact pages, robots.txt followed) for an email, Facebook, Instagram, LinkedIn, X, YouTube, TikTok and WhatsApp. Each place whose website gives one costs one more place. |
| Leave out places that book online | Keep only places with no online booking. |
| Minimum lead score | Keep only places scoring at least this (see Lead score). |
| Only places matching the search | On by default. Google's later results drift to related businesses (for `hair salon`: beauty salons, bridal shops, a marketing agency). This keeps places whose categories match those of the search's top results, or whose name holds the keyword. |
| Only changes | Return only what changed since the last run of the same search (see below). |
| Changes to return, Alert on | Which changes to return and to post. |
| New places: most reviews | A place this search hasn't seen before counts as new only with at most this many reviews (default 10). Google's lists vary a little between reads, so an established business met for the first time is recorded quietly rather than reported as new. |
| Alert webhook URL | A Slack, Discord or Teams incoming webhook, or any HTTPS URL that takes JSON. |
| Telegram bot token, Telegram chat id | Post to Telegram instead (see Alerts). |
| History name | Where the tracker remembers what earlier runs saw. Leave empty to share one history across your runs. |

The input of the most used Google Maps Actors works too (`searchStringsArray`, `locationQuery`, `maxCrawledPlacesPerSearch`, `placeMinimumStars`, `website: "withoutWebsite"`, `skipClosedPlaces`, `categoryFilterWords`), so you can switch with the same JSON.

### Output

One row per place:

```json
{
  "type": "place",
  "search": "plumber in Austin, TX",
  "name": "Acme Plumbing",
  "category": "Plumber",
  "categories": ["Plumber", "Water heater installation service"],
  "phone": "(512) 555-0123",
  "phoneInternational": "+15125550123",
  "website": null,
  "websiteType": "none",
  "rating": 4.8,
  "reviewCount": 12,
  "unclaimed": true,
  "permanentlyClosed": false,
  "address": "1200 E 6th St, Austin, TX 78702",
  "city": "Austin",
  "postalCode": "78702",
  "state": "Texas",
  "countryCode": "US",
  "latitude": 30.2641,
  "longitude": -97.7283,
  "distanceKm": 1.9,
  "openingHours": {"Monday": "7 AM-6 PM", "Sunday": "Closed"},
  "onlineBooking": true,
  "bookingProvider": "Housecall Pro",
  "bookingUrl": "https://book.housecallpro.com/book/Acme-Plumbing/...",
  "leadScore": 72,
  "leadTier": "hot",
  "googleMapsUrl": "https://www.google.com/maps/search/?api=1&query=Acme%20Plumbing&query_place_id=ChIJ...",
  "placeId": "ChIJ...",
  "cid": "1234567890123456789"
}
```

`websiteType` is `own` (a site of its own, with `websiteDomain`), `social` (only a social or booking page, with `socialProfile`) or `none`. `serviceAreaBusiness` is true for a business that hides its address and goes to its customers (plumbers, cleaners, movers): it has no address, and Google places it at an approximate point, often its town's centre, so its distance is approximate too. In a whole-city read of Austin plumbers, 119 of 315 were such businesses. `onlineBooking` is true when Google shows a way to book the place online: a booking link it lists (OpenTable, Resy, Fresha, Housecall Pro, Calendly and the like, in `bookingProvider` with `bookingUrl`), Reserve with Google, or a booking page on its own site. **Leave out places that book online** keeps the ones that still take bookings by phone, a pitch for booking software. With Only changes each row also has `change`, `firstSeenDate` and, for the change kinds that have one, the value before (`previousWebsiteDomain`, `previousPhone`, `previousName`).

The output tabs: **Places**, **Leads** (phone, website type, claimed or not), **Changes** and **Not found** (a location or link the Actor couldn't search, with the reason). The run summary (`RUN_SUMMARY` in the key-value store) says what each search read and what didn't load.

With **Find emails** on, a place with a website of its own also has `email` (the best one), `emails`, `facebook`, `instagram`, `linkedin`, `x`, `youtube`, `tiktok`, `whatsapp`, `contactPage` and `contactForm` when its site gives them, and `contactsStatus`: `found`, `nothingFound`, `robotsDisallowed` (the site asks not to be read), `refused` (the site turned the request away), `unreachable`, `parked`, `notAWebsite` (the link leads to another domain), `noWebsite` (no site of its own to read) or `notRead` (the run stopped first). Only `found` is charged. The emails are the ones the business publishes on its own site; names of people aren't collected.

The rows carry no reviews or reviewer names and no photos: this Actor reads Google Maps' search lists only, not place pages.

### Lead score

Every place gets a `leadScore` from 0 to 100 and a `leadTier` (`hot` 70+, `warm` 45-69, `cold` below 45), worked out from its own fields only, so the same place always scores the same:

| What | Points |
|---|---|
| A phone | 25 |
| An email or a social profile found on its website (Find emails) | 10 |
| Reviews, on a log scale (1 review 5, 10 reviews 13, 100 reviews 21, 400+ 25) | up to 25 |
| Opening hours listed, a description written | 5 each |
| Rating, with 3+ reviews (3.0 stars and below 0, 5.0 stars 15) | up to 15 |
| No website (10), or only a social page (7) | up to 10 |
| Unclaimed on Google | 5 |

A permanently closed place scores 0. **Minimum lead score** keeps only places at or above it.

### Tracking changes

1. Run it once with **Only changes** on. The first run returns every place it finds and remembers them.
2. Schedule it (daily or weekly) with the same input. Each run returns only the changes.

Things worth knowing:

- **No "gone" rows.** Two reads of the same area a minute apart share only 70-80% of their places, because Google varies its lists. A place missing from one read hasn't left, so the tracker never reports one as gone. Closures come from Google's own "Permanently closed" mark.
- **New means new to this search.** A business that has been on Google for years can still be met for the first time on a later run, when Google happens to list it. New places: most reviews (default 10) keeps those out; set it empty to report every first sighting.
- **One history per search.** The search's keyword, area, radius, language and coverage make its key. Change any of them and the next run is a first run.

### Alerts

Paste a webhook URL into **Alert webhook URL** and each run posts its changes there. The first run posts one "alerts are set up" message instead of every place, which also proves the webhook works.

- Slack: an [incoming webhook](https://api.slack.com/messaging/webhooks) (`https://hooks.slack.com/services/...`)
- Discord: channel settings → Integrations → Webhooks
- Microsoft Teams: a Workflows "post to a channel when a webhook request is received" URL
- Telegram: create a bot with [@BotFather](https://t.me/BotFather), add it to your group or channel, and put its token in **Telegram bot token** and the chat in **Telegram chat id** (`-1001234567890`, or `@mychannel` for a public one)
- Anything else: a JSON POST with the rows

Each alert names the place, its change, phone, rating, lead score and, with Find emails, its email. The URL and the bot token are kept secret, and masked in logs and messages.

### How much does it cost?

**$1.00 per 1,000 places** on Apify's Free plan, $0.90 on Starter, $0.80 on Scale and $0.70 from Business up, with platform usage included. A run's start costs $0.00005. Places Google doesn't find and searches that don't load are free.

| Places returned | You pay on the Free plan | A run takes about |
|---|---|---|
| 100 | $0.10 | 20 seconds |
| 1,000 | $1.00 | several minutes, for a large city or several searches |
| 10,000 | $10.00 | depends on the areas |

With **Only changes** on, you pay only for the changes returned. The first run of a search returns its places as the baseline (`firstRun`) and is charged like a normal run; after that, a run where nothing changed costs nothing but the start. Plumbers in Austin read twice four minutes apart: 97 places, then 0 changes.

**Find emails** adds one place's price for each place whose website gives an email or a social profile ($1.00 per 1,000 on the Free plan). Websites that give nothing, ask not to be read or don't load are free. A website shared by several places is read once per run. With a maximum cost per run, websites are read only while the budget covers them.

Set a **maximum cost per run** and the run stops there and says so.

### How it works, and its limits

- It reads Google Maps' search lists, the answers the map itself loads, about one request every 1.5 seconds. It needs no proxy: Google Maps answers Apify's servers directly. Residential and SERP proxy groups aren't accepted.
- Google lists up to about 160 places per search. For a city, `normal` and `thorough` coverage search from many centres and keep the places within the area. A Shoreditch hair salon search read 137 places in 14 seconds.
- A state or a country is too big an area: name a city, or give coordinates and a radius.
- Each run checks every answer, and names what didn't load rather than reporting an empty area.
- Find emails reads up to 4 pages per website, 10 websites at a time, and follows each site's robots.txt, so a run with it takes longer than the map search alone.

### Related Actors

- [Google Maps No-Website Leads](https://apify.com/akhil_rajesh/google-maps-no-website-leads): this Actor's code, set up to return only businesses without a website
- [Website Contact Finder](https://apify.com/akhil_rajesh/contact-details-scraper): emails, phones and social links from websites

### Other Actors by this developer

- [Google Flights Scraper & Price Tracker API - Fare Alerts](https://apify.com/akhil_rajesh/google-flights-scraper): Google Flights fares for any route and dates without a login: the cheapest day to fly, stops, airlines, CO2 and price history, plus price drop alerts in Slack, Discord, Teams or Telegram
- [Shopify Scraper & Price Tracker - Products, Stock, Alerts](https://apify.com/akhil_rajesh/shopify-scraper): products of any Shopify store, collection or product link with variants, prices per country and stock, plus price drop, restock and new product alerts in Slack, Discord or Teams
- [Indeed Jobs MCP Server & API - 62 Countries](https://apify.com/akhil_rajesh/indeed-jobs-mcp-server): Indeed job search for AI agents and apps: a live MCP server and HTTP API over Indeed's 62 country sites, answering in seconds with pay, full descriptions, employer details and apply links
- [Pinterest Trends Scraper & API](https://apify.com/akhil_rajesh/pinterest-trends-scraper): Pinterest's own trend data without a login: keyword research with weekly interest, forecast and audience, the fastest-growing, top and seasonal searches in 31 regions, shopping trends and moments, plus Slack, Discord or Telegram alerts for new trends
- [Google Trends Scraper & API - Trending Now, Pinterest Trends](https://apify.com/akhil_rajesh/google-trends-scraper): Trending Now in 125 countries, interest over time, by region and rising searches without a login or API key, plus Pinterest Trends and Slack, Discord, Telegram or Teams alerts for new trends
- [YouTube Channel Scraper & Tracker](https://apify.com/akhil_rajesh/youtube-channel-scraper): exact subscribers, total views and video counts of YouTube channels without a login or API key, channels found by topic, plus new videos and growth with Slack, Discord or Teams alerts
- [Telegram Channel Scraper & Monitor](https://apify.com/akhil_rajesh/telegram-channel-scraper): posts, views, reactions, comments and exact subscriber counts of public Telegram channels without a login, plus new, edited and deleted posts with Slack, Discord or Teams alerts
- [Google Ads Transparency Scraper & Monitor](https://apify.com/akhil_rajesh/google-ads-transparency-scraper): every ad a brand runs on Google Search, YouTube, Shopping and Maps, with ad copy and targeting, political ad spend and ads Google removed, plus Slack, Discord or Teams alerts for new and stopped ads
- [Craigslist Scraper & Tracker](https://apify.com/akhil_rajesh/craigslist-scraper): Craigslist listings by keyword, city, state or link with prices, cars and rentals, plus new listings, price drops and Slack, Discord or Teams alerts
- [Kijiji Scraper & Tracker](https://apify.com/akhil_rajesh/kijiji-scraper): Kijiji listings by keyword, city and category with prices and price drops, cars and rentals, plus Slack, Discord or Teams alerts for new listings
- [Zillow Price Tracker & Scraper](https://apify.com/akhil_rajesh/zillow-price-tracker): Zillow homes for sale, sold and for rent, with price-drop tracking, Slack alerts and an MCP server
- [App Store Reviews Scraper & API](https://apify.com/akhil_rajesh/app-store-reviews-scraper): App Store reviews from 175 countries with developer replies, filters, ratings and keyword rankings, plus Slack, Discord or Teams alerts for new reviews
- [Google Play Reviews Scraper & API](https://apify.com/akhil_rajesh/google-play-reviews-scraper): Google Play reviews with app versions, developer replies and filters, plus installs, rankings and Slack, Discord or Teams alerts for new reviews
- [Yahoo Finance Scraper](https://apify.com/akhil_rajesh/yahoo-finance-scraper): quotes, history, financials, options and news, with an MCP server
- [AliExpress Price Tracker & Scraper](https://apify.com/akhil_rajesh/aliexpress-price-tracker): AliExpress search results with store prices, units sold and price history
- [Amazon.ca Product & Trending Tracker](https://apify.com/akhil_rajesh/amazon-ca-product-trending-tracker): Amazon Best Sellers, prices, search positions and reviews on 23 marketplaces, with change tracking
- [Sports API - Live Scores, Stats & Odds (Soccer, NBA, NHL, NFL)](https://apify.com/akhil_rajesh/sports-scraper): scores, statistics and odds for seven sports
- [Tennis API - Live Scores, Stats & Odds (ATP, WTA, ITF)](https://apify.com/akhil_rajesh/tennis-scraper): live scores, results, match statistics, point-by-point and bookmaker odds for ATP, WTA, Challenger and ITF
- [Google Hotels Scraper - Hotel Price Tracker & Comparison](https://apify.com/akhil_rajesh/google-hotels-scraper): hotel prices from Google Hotels, with price tracking
- [Price Tracker Canada - Best Buy, Walmart, Canada Computers](https://apify.com/akhil_rajesh/bot-wall-price-scraper): live price comparison across major Canadian retailers
- [AutoTrader Canada Scraper - Used Cars & Prices](https://apify.com/akhil_rajesh/autotrader-canada-scraper): Canadian vehicle listings with price, mileage, trim and dealer
- [Indeed Jobs Scraper - Canada, US, UK & More, Job Alerts](https://apify.com/akhil_rajesh/indeed-jobs-scraper): job listings from Indeed in 62 countries, with full descriptions, pay and the employer, plus only new jobs with Slack, Discord, Teams or Telegram alerts
- [SEEK, JobStreet & JobsDB Jobs Scraper](https://apify.com/akhil_rajesh/seek-jobstreet-jobsdb-scraper): jobs from SEEK, JobStreet and JobsDB in Australia, New Zealand and six Asian markets, with pay as numbers, applicant counts and change tracking
- [Wellfound (AngelList) Jobs Scraper - Salary & Equity](https://apify.com/akhil_rajesh/wellfound-jobs-scraper): startup jobs from Wellfound (formerly AngelList Talent) with salary and equity ranges and an exact Y Combinator flag
- [Job Bank Scraper - Canada Jobs, Salary & NOC Codes](https://apify.com/akhil_rajesh/canadian-jobs-scraper): Canadian job postings with salary, employer, location and NOC code

# Actor input Schema

## `searches` (type: `array`):

Kinds of business to find ('plumber', 'hair salon', 'dentist', 'roofing contractor'), as you would type them into Google Maps. A Google Maps search link (google.com/maps/search/plumbers/@30.27,-97.74,13z) searches its own map area. Each search is read in every location below.

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

Where to search: a city, district or postcode with its state or country ('Austin, TX', 'Shoreditch, London', 'M5V 2T6', '90210, USA'), or coordinates ('30.27, -97.74'). The whole area is covered with a grid of searches, as far as Google Maps draws it (Austin: about 25 km around its centre). States and provinces are too large: list their cities in Locations.

## `locations` (type: `array`):

More places to search, one per line (each search is read in each). Up to 50 searches in all.

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

How far around the location's centre to search. Leave empty for the area Google Maps draws for the place (a district about 2 km, a city 20-30 km); coordinates and postcodes get 5 km.

## `coverage` (type: `string`):

How densely the area is searched. Google Maps lists up to about 160 places per search point, so a city needs many points. Austin plumbers (25 km): normal read 328 in 4.5 minutes, thorough 371 in 8.5 minutes.

## `maxResults` (type: `integer`):

The most places a run returns (and charges), shared between the searches. With Only changes, the most changes a run returns.

## `maxPlacesPerSearch` (type: `integer`):

The most places a search reads in its area (before the filters). Raise it for big cities with many businesses of the kind.

## `onlyChanges` (type: `boolean`):

Return only what changed since the last run of the same search: new businesses, places Google marks closed or open again, websites added or removed, new phones and names. The first run returns every place as its baseline. Schedule it to watch an area.

## `changeTypes` (type: `array`):

Which changes to return. Leave empty for all of them.

## `newPlaceMaxReviews` (type: `integer`):

A place this search hasn't seen before counts as new only with at most this many reviews (a new business has few). Others were there already, and are recorded without a row. Leave empty for 10.

## `websiteFilter` (type: `string`):

Keep all places, only those without a website of their own, or only those with one.

## `socialMediaCountsAsWebsite` (type: `boolean`):

Off: a place whose only link is a Facebook, Instagram, Linktree, Yelp or booking page has no website of its own. On: such a page counts as a website.

## `minRating` (type: `number`):

Keep places rated at least this (1-5). Places without a rating are left out.

## `maxRating` (type: `number`):

Keep places rated at most this, for businesses that need help with reviews.

## `minReviews` (type: `integer`):

Keep places with at least this many reviews.

## `maxReviews` (type: `integer`):

Keep places with at most this many reviews (0: only places without reviews).

## `withPhoneOnly` (type: `boolean`):

Leave out places that show no phone.

## `onlyUnclaimed` (type: `boolean`):

Keep only places whose owner hasn't claimed the Google Business Profile (Google shows 'Own this business?').

## `categoryWords` (type: `array`):

Keep only places with one of these words in a category ('dentist', 'clinic').

## `excludeWords` (type: `array`):

Leave out places with any of these words in their name or categories ('franchise', 'supply').

## `onlyMatching` (type: `boolean`):

Google's later results drift to related businesses (for 'hair salon': spas, bridal shops, an office). On: keep places in the categories of the search's top results, or with the keyword in their name or categories. Off: keep everything Google lists.

## `excludeOnlineBooking` (type: `boolean`):

Leave out places that already take bookings online (OpenTable, Resy, Doctolib, Fresha, Calendly, Reserve with Google, or a booking page). Every row says onlineBooking either way.

## `minLeadScore` (type: `integer`):

Keep places scoring at least this (0-100; hot is 70+, warm 45+). The score is checked before the website is read for emails, which can only raise it.

## `includeClosed` (type: `boolean`):

Keep places Google marks permanently closed (left out by default).

## `language` (type: `string`):

The language of categories and hours (en, de, es, fr, pt-BR...).

## `findContacts` (type: `boolean`):

Read each place's own website (its homepage and up to 3 contact pages, following its robots.txt) for emails, Facebook, Instagram, LinkedIn, X, YouTube and TikTok, a contact page and form. A place whose website gives an email or a social profile costs one more place; others cost nothing more. Slower: about 10 websites at a time.

## `alertWebhookUrl` (type: `string`):

A Slack, Discord or Microsoft Teams incoming webhook, or any HTTPS address that takes JSON (Zapier, Make, n8n). Each run posts its changes there; the first run posts a set-up message. Turns on Only changes.

## `telegramBotToken` (type: `string`):

To post alerts to Telegram instead: your bot's token from @BotFather (123456789:AAH...). Add the bot to the chat (to a channel as an admin that can post). Turns on Only changes.

## `telegramChatId` (type: `string`):

The chat the bot posts to: a chat id (-1001234567890, 123456789) or a public channel or group (@mychannel).

## `alertChangeTypes` (type: `array`):

Which changes to post. Leave empty for new places, closures and websites removed.

## `historyName` (type: `string`):

The store that remembers what earlier runs saw. Leave empty to share one store between all your runs (each search and filter set keeps its own record); give a name to keep a schedule's history apart.

## `proxy` (type: `object`):

Not needed: Google Maps answers Apify's servers directly. Residential and SERP proxies aren't available (they are billed per GB or request).

## Actor input object example

```json
{
  "searches": [
    "plumber"
  ],
  "location": "Austin, TX",
  "coverage": "normal",
  "maxResults": 100,
  "maxPlacesPerSearch": 500,
  "onlyMatching": true,
  "language": "en"
}
```

# Actor output Schema

## `places` (type: `string`):

No description

## `leads` (type: `string`):

No description

## `changes` (type: `string`):

No description

## `notFound` (type: `string`):

No description

## `allData` (type: `string`):

No description

## `runSummary` (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 = {
    "searches": [
        "plumber"
    ],
    "location": "Austin, TX",
    "maxResults": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("akhil_rajesh/google-maps-leads-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 = {
    "searches": ["plumber"],
    "location": "Austin, TX",
    "maxResults": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("akhil_rajesh/google-maps-leads-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 '{
  "searches": [
    "plumber"
  ],
  "location": "Austin, TX",
  "maxResults": 100
}' |
apify call akhil_rajesh/google-maps-leads-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,akhil_rajesh/google-maps-leads-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/4nmKfnbIJmJH0h2Is/builds/S1om4UUsVc2OoK5nO/openapi.json
