# Google Maps Scraper: Business Leads with Emails & Phones (`earlytern/google-maps-leads-scraper`) Actor

Google Maps business leads: name, category, address, phone, website, rating, reviews, coordinates and hours, plus emails, phones and social links from each business's own website. From $1.40 per 1,000 places.

- **URL**: https://apify.com/earlytern/google-maps-leads-scraper.md
- **Developed by:** [earlytern](https://apify.com/earlytern) (community)
- **Categories:** Lead generation, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.40 / 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 Scraper: Business Leads with Emails & Phones

Get **business leads from Google Maps**: name, category, address, phone, website, rating, review count, coordinates,
place ID and opening hours for every place Google Maps lists for your search, in any city or country. Then the Actor
reads each business's **own website** and adds the **email addresses, extra phone numbers and social profile links**
it finds there. One row per place, ready for a spreadsheet or a CRM. No Google account and no proxies to manage.

### What does Google Maps Scraper do?

- **Google Maps places**: name, main and other categories, full address (street, city, postal code, region, country),
  phone, website, rating, review count, latitude and longitude, place ID, CID, Google Maps link, opening hours, open
  now or not, claimed or not, price level and main photo.
- **Emails from the website**: addresses on the business's own domain, role addresses (`info@`, `sales@`) first, each
  marked `role` or `personal`. Free mail addresses (Gmail and the like) are left out.
- **More phone numbers and social links**: phone numbers on the website other than the one on Google Maps, and links
  to Facebook, Instagram, LinkedIn, X, YouTube, TikTok, Pinterest, Threads and GitHub.
- **Polite website reading**: the home page plus the contact and about pages, at most 5 pages per website, following
  robots.txt. Social networks are never opened.
- **Any location**: `City, Region, Country` (`Austin, Texas, United States`) or coordinates with a zoom level
  (`30.2672,-97.7431,14z`).
- **No duplicates**: a place found by two search terms is saved and charged once.
- **Fair billing**: you pay per place saved, and for website contacts only when something was found.

### Who uses it?

- **Sales and lead generation teams**: build lists of local businesses with emails and phone numbers for outreach.
- **Agencies**: find businesses with no website, low ratings or few reviews to offer web, SEO or review services.
- **Market researchers**: count and map competitors, chains and categories in a city.
- **Local SEO**: see who ranks on Google Maps for a search in a place.
- **Developers and AI agents**: feed local business data into apps, dashboards and workflows.

### How to use it

1. Click **Try for free**.
2. In **Search terms**, add one per line, for example `dentist` or `coffee shop`.
3. Set **Location**, for example `Austin, Texas, United States`.
4. Choose **Places per search term** (1 to 500; Google Maps often lists fewer than 200).
5. Keep **Find emails and social links on websites** on to read each website, or turn it off for Google Maps data only.
6. Click **Start**. Download the results as JSON, CSV or Excel.

Runs of up to 10 search terms usually finish within a few minutes. Larger runs wait for Google Maps results in a queue
and take a few minutes more: give them a timeout of at least 10 minutes in Run options (the run tells you if it is
shorter).

### Use with AI agents (MCP)

AI assistants and AI agents can call this Actor through Apify's MCP server at [mcp.apify.com](https://mcp.apify.com).
Questions it answers well:

- "Find plumbers in Denver, Colorado with their emails." Search `plumber`, location `Denver, Colorado, United States`.
- "Which dentists in Austin have no website?" Read the rows with `websiteStatus: no_website`.
- "List the best rated coffee shops near these coordinates." Use `latitude,longitude,15z` and sort by `rating`.

Only `searchTerms` and `location` are needed.

### Input example

```json
{
  "searchTerms": ["dentist", "orthodontist"],
  "location": "Austin, Texas, United States",
  "maxPlacesPerSearch": 100,
  "enrichContacts": true,
  "language": "en"
}
```

### Output example

```json
{
  "searchTerm": "dentist",
  "location": "Austin, Texas, United States",
  "status": "ok",
  "message": null,
  "rank": 1,
  "name": "Smile Dental Austin",
  "category": "Dentist",
  "additionalCategories": ["Cosmetic dentist", "Emergency dental service"],
  "address": "100 Congress Ave, Austin, TX 78701",
  "street": "100 Congress Ave",
  "city": "Austin",
  "postalCode": "78701",
  "region": "Texas",
  "countryCode": "US",
  "phone": "+1 512-555-0100",
  "website": "https://smile-dental.example.com/",
  "rating": 4.8,
  "reviewsCount": 312,
  "latitude": 30.2638,
  "longitude": -97.7446,
  "placeId": "ChIJexampleexampleexample",
  "cid": "1234567890123456789",
  "googleMapsUrl": "https://www.google.com/maps?cid=1234567890123456789",
  "openingHours": { "monday": ["08:00-17:00"], "saturday": [], "sunday": [] },
  "currentStatus": "open",
  "isClaimed": true,
  "priceLevel": null,
  "imageUrl": "https://lh5.googleusercontent.com/p/example",
  "websiteStatus": "contacts_found",
  "emails": [
    { "address": "info@smile-dental.example.com", "kind": "role" },
    { "address": "jane.doe@smile-dental.example.com", "kind": "personal" }
  ],
  "websitePhones": ["+15125550142"],
  "socials": { "linkedin": null, "facebook": "https://www.facebook.com/smiledentalaustin", "x": null, "instagram": "https://www.instagram.com/smiledentalaustin", "youtube": null, "tiktok": null, "github": null, "threads": null, "pinterest": null },
  "contactPageUrl": "https://smile-dental.example.com/contact-us",
  "scrapedAt": "2026-11-16T10:00:00.000Z"
}
```

| Field | What it is |
|---|---|
| `searchTerm`, `location` | What was searched |
| `status` | `ok`, `no_results`, `invalid`, `skipped` or `error` (see below) |
| `message` | Why a row has no place, or why the website was not read |
| `rank` | Position on Google Maps for the search term |
| `name`, `category`, `additionalCategories` | Business name and Google Maps categories |
| `address`, `street`, `city`, `postalCode`, `region`, `countryCode` | Address |
| `phone`, `website` | Phone and website on Google Maps |
| `rating`, `reviewsCount` | Average rating (1 to 5) and number of reviews |
| `latitude`, `longitude` | Coordinates |
| `placeId`, `cid`, `googleMapsUrl` | Google place ID, Google Maps CID and a link to the place |
| `openingHours`, `currentStatus` | Opening hours per day (`00:00-24:00` is open all day) and open now or not |
| `isClaimed`, `priceLevel`, `imageUrl` | Claimed by the owner, price level, main photo |
| `websiteStatus` | What reading the website gave (see below) |
| `emails` | Addresses on the business's own domain: `address` and `kind` (`role` or `personal`) |
| `websitePhones` | Phone numbers on the website, in international form |
| `socials` | Social profile links on the website |
| `contactPageUrl` | The website's contact page |
| `scrapedAt` | When the row was saved |

| Status | Meaning | Charged |
|---|---|---|
| `ok` | A place Google Maps listed | Yes |
| `no_results` | Google Maps listed no places for the search | No |
| `invalid` | Not searched: the search term and location are longer than 700 characters | No |
| `skipped` | Not searched or not saved: the run reached your maximum cost per run, the Free plan trial limit, the most one run can search (split the list into smaller runs), or every place was already saved for an earlier search term | No |
| `error` | The search failed or was not ready before the run's time limit (`message` says which) | No |

| Website status | Meaning |
|---|---|
| `contacts_found` | At least one email on the business's domain, a phone number other than the one on Google Maps, or a social link (charged as website contacts) |
| `no_contacts` | The website was read and shows none of those |
| `no_website` | Google Maps lists no website for the place |
| `not_checked` | Website reading is off, or the run ran out of time |
| `needs_browser` | The website only shows its content in a browser |
| `blocked`, `robots_txt`, `not_allowed` | The website refused the visit, asks robots not to read it, or is a social network page (its link is in `socials`) |
| `unreachable`, `not_found` | The website did not answer, or is gone or parked |

The **OUTPUT** record of each run sums up the counts and why a run stopped early.

### How much does it cost?

You pay for each **place** saved and, when website reading is on, for each place whose website gave **website
contacts**. No start fee. Prices per 1,000 by Apify plan:

| Event, per 1,000 | Free | Bronze | Silver | Gold and up |
|---|---|---|---|---|
| Place | $3.00 | $2.50 | $1.80 | $1.40 |
| Website contacts | $1.50 | $1.50 | $1.20 | $0.90 |

- **Free**: searches without places, rejected, skipped and failed searches; places without a website, or whose website
  shows no contacts, are charged as places only.
- Set a **maximum cost per run** and the Actor plans the run to stay under it. Search terms it could not pay for are
  listed as `skipped`, free.

Examples on Bronze:

- **1,000 places** without website reading: 1,000 × $0.0025 = **$2.50**.
- **1,000 places** with website reading, 600 of them with contacts: $2.50 + 600 × $0.0015 = **$3.40**.

**Apify Free plan**: each run returns up to 10 places in all, then stops and says so. The other search terms are listed
as `skipped`, free. Any paid Apify plan searches the full list.

**Personal data:** `emails` can hold a person's work email (`kind: personal`), and for one-person businesses the phone
number or the business itself may belong to a person. That is personal data under laws such as the GDPR: you need a
lawful basis (for example legitimate interest, with a balancing test) to store and use it, you must tell people where
you got their data and let them object, and you must follow the anti-spam rules for cold email and calls where you
contact them.

### FAQ

**Why did I get fewer places than I asked for?** Google Maps lists a limited number of places for each search, often
fewer than 200. Use more specific search terms (`emergency dentist`, `pediatric dentist`) or several nearby locations
to collect more.

**Why does a place have no emails?** Many small businesses show only a contact form or a phone number. Look at
`websiteStatus` and `message` for what happened. Some websites only show their content in a browser
(`needs_browser`).

**Are Gmail addresses included?** No: only addresses on the business's own website domain, which are far more likely to
be current and to belong to the business.

**Which locations work?** `City, Region, Country` (`Manchester, England, United Kingdom`), a country, or coordinates
with a zoom level (`53.4808,-2.2426,13z`; a lower zoom covers a bigger area). Add the country for best results.

**How fresh is the data?** Each search runs on Google Maps when the run runs, and each website is read at that time.

### Limits

- Up to 1,000 search terms per run; duplicates (any case) are removed.
- Up to 500 places per search term.
- At most 5 pages of each website are read.
- Runs of more than 10 search terms need a timeout of at least 10 minutes.

### Related

- [Company Enrichment by Domain](https://apify.com/earlytern/company-enrichment-by-domain): company details, emails,
  phones and social links from a list of websites.

### Questions and feedback

Open an issue on the **Issues** tab.

# Actor input Schema

## `searchTerms` (type: `array`):

What to search on Google Maps, one per line, such as dentist or coffee shop. Up to 1,000 per run.

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

Where to search: City, Region, Country (Austin, Texas, United States), or latitude,longitude with an optional zoom (30.2672,-97.7431,14z).

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

The most places to collect for each search term, 1 to 500. Google Maps often lists fewer.

## `enrichContacts` (type: `boolean`):

Read each place's own website (home, contact and about pages) for email addresses, more phone numbers and social profile links. Charged per place where something is found.

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

Language of place names and categories: a code (en, de, pt-BR) or a name (English).

## Actor input object example

```json
{
  "searchTerms": [
    "dentist"
  ],
  "location": "Austin, Texas, United States",
  "maxPlacesPerSearch": 10,
  "enrichContacts": true,
  "language": "en"
}
```

# Actor output Schema

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

No description

## `summary` (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 = {
    "searchTerms": [
        "dentist"
    ],
    "location": "Austin, Texas, United States",
    "maxPlacesPerSearch": 10,
    "enrichContacts": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("earlytern/google-maps-leads-scraper").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 = {
    "searchTerms": ["dentist"],
    "location": "Austin, Texas, United States",
    "maxPlacesPerSearch": 10,
    "enrichContacts": True,
}

# Run the Actor and wait for it to finish
run = client.actor("earlytern/google-maps-leads-scraper").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 '{
  "searchTerms": [
    "dentist"
  ],
  "location": "Austin, Texas, United States",
  "maxPlacesPerSearch": 10,
  "enrichContacts": true
}' |
apify call earlytern/google-maps-leads-scraper --silent --output-dataset

```

## MCP server setup

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

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/8H4qP9IuDQLWa5gca/builds/pdcZ7v1y26XVHOIsG/openapi.json
