# Google Maps Business Leads + Verified Emails (`mrdoe/google-maps-business-leads`) Actor

Scrapes business leads from Google Maps search results and enriches them with verified contact emails.

- **URL**: https://apify.com/mrdoe/google-maps-business-leads.md
- **Developed by:** [MrDoe](https://apify.com/mrdoe) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $1.50 / 1,000 results

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/platform/actors/running/actors-in-store#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 Maps Business Leads + Verified Emails - Scrape Local Businesses & Find Emails

Scrape business leads directly from **Google Maps search results** - name, category, address, phone, website, and rating - then automatically enrich each result with a verified contact email.

### What does this Actor do?

Give it one or more Google Maps search queries (e.g. `"dentists in Austin, TX"`) and it returns one structured lead per business, including:

- **Business details** - name, category, address (parsed into city/state/zip/country), phone, rating, website
- **Contact email** - found from the business's own website domain, with confidence score, email type, and source URLs
- **Optional email verification** - deliverability check

Only businesses with a discoverable website are looked up for an email - if no site is listed on Google Maps, the lead is still returned with all other fields, just without email data (nothing is guessed or invented).

Not affiliated with or endorsed by Google. Only publicly visible listing data is collected.

### How it works

1. Loads each search query's Google Maps results and scrolls the results feed to collect up to **Max leads per search query** businesses.
2. Visits each business's own Maps listing page to read its address, phone, website, and category.
3. If a website is found and enrichment is enabled, looks up the domain for a contact email (deduplicated per unique domain - businesses sharing a domain, e.g. chain locations, are enriched once and reused).
4. Optionally verifies the found email's deliverability.

Google Maps renders results client-side with no static HTML API, so this Actor uses a headless browser (Playwright) rather than a plain HTTP crawler - a Residential proxy is strongly recommended to avoid Google's consent/CAPTCHA wall.

### How to use

1. [Sign up](https://apify.com/sign-up) for a free Apify account.
2. Open this Actor and enter one or more **Search queries**, e.g. `"coffee shops in Dublin"`.
3. Set **Max leads per search query** and leave **Proxy configuration** on Residential.
4. Click **Start** and export results as JSON, CSV, Excel, or via API.

### Output

Each dataset item follows a standard lead shape shared across this Actor family:

| Field | Description |
|---|---|
| `companyName`, `companyUrl`, `domain`, `companyWebsite` | Business identity and website |
| `category` | Google Maps business category |
| `email`, `emailType`, `emailConfidence`, `emailVerificationStatus`, `emailSources` | Contact email data (`null` if unavailable) |
| `phone` | Business phone number, from Google Maps |
| `address`, `city`, `state`, `zipCode`, `country` | Parsed business address |
| `rating` | Google Maps star rating |
| `source`, `sourceUrl`, `profileUrl`, `scrapedAt` | Provenance metadata |

Fields with no available data are returned as `null` rather than omitted or guessed.

### Cost & performance notes

- Runs on a headless browser, so it's heavier per-item than an HTTP-only Actor - keep **Max leads per search query** reasonable for your use case.
- Email lookups are deduplicated by domain and skipped entirely for businesses with no website, minimizing overhead.
- Concurrency is kept conservative to stay reliable at scale.

# Actor input Schema

## `searchQueries` (type: `array`):

Google Maps search terms, e.g. "dentists in Austin, TX" or "coffee shops near Dublin". One query per line.

## `maxItems` (type: `integer`):

Maximum number of businesses to collect per search query. Set to 0 for unlimited.

## `proxyConfiguration` (type: `object`):

Google Maps blocks non-residential IPs with a consent/CAPTCHA wall, so a Residential proxy is used by default for reliable results.

## `enableContactEnrichment` (type: `boolean`):

When enabled, businesses with a discovered website are automatically looked up to find a contact email.

## `enableEmailVerification` (type: `boolean`):

When enabled, each found email is additionally checked for deliverability. Disabled by default.

## Actor input object example

```json
{
  "searchQueries": [
    "digital marketing agencies in Austin, TX"
  ],
  "maxItems": 2,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "enableContactEnrichment": true,
  "enableEmailVerification": false
}
```

# Actor output Schema

## `overview` (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 = {
    "searchQueries": [
        "digital marketing agencies in Austin, TX"
    ],
    "maxItems": 2,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("mrdoe/google-maps-business-leads").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 = {
    "searchQueries": ["digital marketing agencies in Austin, TX"],
    "maxItems": 2,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("mrdoe/google-maps-business-leads").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 '{
  "searchQueries": [
    "digital marketing agencies in Austin, TX"
  ],
  "maxItems": 2,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call mrdoe/google-maps-business-leads --silent --output-dataset

```

## MCP server setup

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

```

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/XQnUcKJwyW4hvWmmL/builds/eg3lqXj7NeDDwHXWV/openapi.json