# Google Maps Leads Extractor + Email & Phone Enrichment (`hichemdev/google-maps-leads-extractor`) Actor

Scrape local business leads from Google Maps and enrich each with email, phone, and social profiles crawled from their website. Search any niche in any city and export a ready-to-use B2B prospect list for cold outreach, sales, and lead generation.

- **URL**: https://apify.com/hichemdev/google-maps-leads-extractor.md
- **Developed by:** [Hichem Ben Moussa](https://apify.com/hichemdev) (community)
- **Categories:** Lead generation, Business, Marketing
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use 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 Leads Extractor + Email & Phone Enrichment

**Turn Google Maps into a ready-to-use B2B lead list — complete with emails, phone numbers, and social profiles.**

Search any type of business in any city and get back clean, structured leads. Unlike a plain Google Maps scraper, this Actor then **visits each business's website and extracts real contact details** — so you get an outreach-ready list, not just names on a map.

---

### ✨ What you get for every business

| Field | Example |
|---|---|
| **Name** | Austin Dental Works |
| **Category** | Dentist |
| **Address** | 221 W N Loop Blvd, Austin, TX 78751 |
| **Rating & reviews** | 4.5 ★ · 2,497 reviews |
| **Phone** | +1 512-877-9822 |
| **Website** | https://www.austindentalworks.com/ |
| **Emails** 📧 | info@austindentalworks.com |
| **Social profiles** | Facebook, Instagram, LinkedIn, X, YouTube, TikTok |
| **Google Maps URL** | direct link to the listing |

---

### 🚀 How to use it

1. Enter one or more **search terms** (e.g. `dentists`, `plumbers`, `coffee shop`).
2. Enter a **location** (e.g. `Austin, TX` or `London, UK`).
3. Set **max results** per search term.
4. Keep **contact enrichment** on to pull emails, phones, and socials from each website.
5. Click **Start** — and export your leads as CSV, Excel, JSON, or Google Sheets.

No setup, no accounts, no cookies to paste.

---

### 🎯 Who it's for

- **Lead-gen & marketing agencies** building targeted local prospect lists
- **Sales / SDR teams** feeding cold email and calling campaigns
- **Local service businesses** finding partners and clients nearby
- **Market researchers** mapping a niche in any city

---

### 📥 Input

| Field | Type | Description |
|---|---|---|
| `searchTerms` | array | What to search on Google Maps, e.g. `["dentists", "coffee shop"]`. **Required.** |
| `location` | string | City / area, combined with each term, e.g. `"Austin, TX"`. **Required.** |
| `maxResults` | integer | Businesses per search term. Default `20`. |
| `enrichContacts` | boolean | Visit each website for email / phone / socials. Default `true`. |
| `language` | string | Google Maps language code (e.g. `en`). |
| `proxyConfiguration` | object | Apify Proxy — residential recommended. |

#### Example input

```json
{
  "searchTerms": ["dentists"],
  "location": "Austin, TX",
  "maxResults": 20,
  "enrichContacts": true,
  "language": "en",
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}
````

***

### 📤 Output

Each result is one clean, structured lead:

```json
{
  "searchTerm": "dentists",
  "name": "Austin Dental Works",
  "category": "Dentist",
  "address": "221 W N Loop Blvd, Austin, TX 78751",
  "rating": 4.5,
  "reviews": 2497,
  "phone": "+15128779822",
  "website": "https://www.austindentalworks.com/",
  "emails": ["info@austindentalworks.com"],
  "socials": {
    "facebook": "https://facebook.com/austindentalworks",
    "instagram": "https://instagram.com/austindentalworks"
  },
  "plusCode": "879G+C5 Austin, Texas",
  "googleMapsUrl": "https://www.google.com/maps/place/..."
}
```

Export in one click to **CSV, Excel, JSON, XML, or Google Sheets**, or pull results via the **Apify API**.

***

### 🔌 Integrations & scheduling

- **Schedule** the Actor to keep your lead lists fresh (daily / weekly).
- Push results straight into your **CRM** or **cold-email tool**.
- Combine with the **Email, Phone & Social Enricher** Actor to enrich any external list of domains.

***

### 💰 Pricing

Pay per result — you're only charged for the leads you actually get. No monthly subscription, no seat fees. Run a small test first, then scale up when you're happy with the data.

***

### ❓ FAQ

**Do I need a Google account or API key?**
No. Just enter a search term and location.

**Why is a proxy needed?**
Google Maps blocks datacenter traffic, so a proxy is required for reliable results. Residential proxy is recommended and included in your Apify plan.

**Will every business have an email?**
No — email enrichment depends on the business publishing contact details on its website. Expect strong coverage for service businesses (dentists, lawyers, agencies) and lower coverage for chains and franchises. You'll always get name, address, rating, phone (when listed), and website.

**Can I scrape multiple cities or niches at once?**
Yes — add multiple search terms, and run separate inputs per city.

**Is scraping Google Maps legal?**
This Actor collects publicly available business information. You are responsible for using the data in line with applicable laws (e.g. GDPR/CAN-SPAM) and Google's terms. Use it for legitimate B2B outreach and research.

***

### 🗺️ Roadmap

- SMTP email verification
- De-duplication across runs (only new businesses)
- Owner / decision-maker name detection
- "No website" and "high rating" lead filters

***

*Built and maintained by [hichemdev](https://apify.com/hichemdev). Found a bug or want a feature? Open an issue on the Actor's **Issues** tab.*

# Actor input Schema

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

What to search for on Google Maps, e.g. "restaurants", "dentists", "plumbers".

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

City / area to search in, e.g. "Austin, TX" or "London, UK". Combined with each search term.

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

Maximum number of businesses to collect per search term.

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

Visit each business website to extract email addresses, phone numbers, and social profile links.

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

Google Maps interface language code, e.g. en, es, fr.

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

Google Maps needs a proxy to run reliably. Apify Proxy (residential recommended) is included in your plan.

## Actor input object example

```json
{
  "searchTerms": [
    "coffee shop"
  ],
  "location": "Austin, TX",
  "maxResults": 3,
  "enrichContacts": true,
  "language": "en",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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": [
        "coffee shop"
    ],
    "location": "Austin, TX",
    "maxResults": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("hichemdev/google-maps-leads-extractor").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": ["coffee shop"],
    "location": "Austin, TX",
    "maxResults": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("hichemdev/google-maps-leads-extractor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": [
    "coffee shop"
  ],
  "location": "Austin, TX",
  "maxResults": 3
}' |
apify call hichemdev/google-maps-leads-extractor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=hichemdev/google-maps-leads-extractor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Maps Leads Extractor + Email & Phone Enrichment",
        "description": "Scrape local business leads from Google Maps and enrich each with email, phone, and social profiles crawled from their website. Search any niche in any city and export a ready-to-use B2B prospect list for cold outreach, sales, and lead generation.",
        "version": "0.1",
        "x-build-id": "l05qcFi9yiNwkfEth"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/hichemdev~google-maps-leads-extractor/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-hichemdev-google-maps-leads-extractor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/hichemdev~google-maps-leads-extractor/runs": {
            "post": {
                "operationId": "runs-sync-hichemdev-google-maps-leads-extractor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/hichemdev~google-maps-leads-extractor/run-sync": {
            "post": {
                "operationId": "run-sync-hichemdev-google-maps-leads-extractor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "searchTerms",
                    "location"
                ],
                "properties": {
                    "searchTerms": {
                        "title": "Search terms",
                        "type": "array",
                        "description": "What to search for on Google Maps, e.g. \"restaurants\", \"dentists\", \"plumbers\".",
                        "items": {
                            "type": "string"
                        }
                    },
                    "location": {
                        "title": "Location",
                        "type": "string",
                        "description": "City / area to search in, e.g. \"Austin, TX\" or \"London, UK\". Combined with each search term."
                    },
                    "maxResults": {
                        "title": "Max results per search term",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of businesses to collect per search term.",
                        "default": 20
                    },
                    "enrichContacts": {
                        "title": "Enrich email / phone / socials from website",
                        "type": "boolean",
                        "description": "Visit each business website to extract email addresses, phone numbers, and social profile links.",
                        "default": true
                    },
                    "language": {
                        "title": "Language",
                        "type": "string",
                        "description": "Google Maps interface language code, e.g. en, es, fr.",
                        "default": "en"
                    },
                    "proxyConfiguration": {
                        "title": "Proxy",
                        "type": "object",
                        "description": "Google Maps needs a proxy to run reliably. Apify Proxy (residential recommended) is included in your plan.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
