# Google Maps Email Scraper (`seemuapps/google-maps-email-scraper`) Actor

Extract business emails, phone numbers, websites and social profiles from Google Maps listings — search any niche + city and export ready-to-use leads.

- **URL**: https://apify.com/seemuapps/google-maps-email-scraper.md
- **Developed by:** [Andrew](https://apify.com/seemuapps) (community)
- **Categories:** Lead generation, SEO tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$8.00 / 1,000 lead results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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 Email Scraper

Build a lead list from Google Maps in minutes: search any business type + location and get every listing's **email address, phone number, website, and social media profiles** — one flat row per business, ready for CSV/Sheets/CRM import. Emails come from Google Maps when listed, otherwise the actor visits the business website (homepage + contact page) and extracts them.

### What you get

- **Contact data**: `email` (best match) and all `emails[]` found, `emailSource` (`google_maps` or `website`), `phone` + `phoneUnformatted` (E.164), `website`, `websiteDomain`
- **Social profiles**: `facebook`, `instagram`, `linkedin`, `twitter`, `youtube`, `tiktok`, `pinterest`, `yelp` — pulled from Google Maps and the business website
- **Business info**: `name`, `category`, `categories[]`, `address` split into `street` / `city` / `postalCode` / `state` / `countryCode`, `latitude` / `longitude`, `rating`, `reviewCount`, `priceLevel`, `businessStatus`
- **Identifiers**: `placeId`, `googlePlaceId`, `googleMapsUrl`, and the `searchQuery` that found each lead
- Filters: **Only save leads with an email**, **Skip businesses without a website**
- Export to CSV, Excel, JSON, or Google Sheets from the Apify console

### Use cases

- **B2B lead generation** — plumbers, dentists, real-estate agents, gyms, restaurants… in any city, with emails for cold outreach
- **Agency prospecting** — find local businesses with weak ratings, no website, or no social presence and pitch your services
- **Local marketing & partnerships** — contact lists for event sponsors, suppliers, franchise targets
- **CRM enrichment** — refresh emails/phones/socials for an existing account list by pasting Google Maps URLs
- **Market mapping** — count and geo-locate every competitor in a region

### How to use

1. Enter **Search queries** such as `plumbers in Denver CO` or `dentists near Austin TX` (one per line; include the city/area).
2. Set **Max places per query** (default 50; Google returns at most ~120 per query — split large cities by neighborhood or zip code).
3. Optionally enable **Only save leads with an email** to pay only for leads that have one.
4. Run — leads appear in the **Dataset** tab; download as CSV or push to Google Sheets.

### Output format

```json
{
  "name": "Professional Plumbers Denver",
  "email": "info@professional-plumbers-denver.com",
  "emails": ["info@professional-plumbers-denver.com"],
  "phone": "(720) 390-2652",
  "phoneUnformatted": "+17203902652",
  "website": "https://professional-plumbers-denver.com/",
  "websiteDomain": "professional-plumbers-denver.com",
  "category": "Plumber",
  "categories": ["Plumber", "Drainage service", "Septic system service"],
  "address": "4400 S Quebec St H-208, Denver, CO 80237",
  "street": "4400 S Quebec St H-208",
  "city": "Denver",
  "postalCode": "80237",
  "state": "Colorado",
  "countryCode": "US",
  "latitude": 39.6367187,
  "longitude": -104.9009061,
  "rating": 4.8,
  "reviewCount": 224,
  "priceLevel": null,
  "businessStatus": "OPERATIONAL",
  "facebook": "https://www.facebook.com/profile.php?id=100063726835927",
  "instagram": "https://www.instagram.com/professionalplumbersdenver/",
  "linkedin": null,
  "twitter": null,
  "youtube": null,
  "tiktok": null,
  "pinterest": null,
  "yelp": null,
  "emailSource": "website",
  "placeId": "0x876c87b3d0e6d3f7:0x8f2b6c1e0d4a9c21",
  "googlePlaceId": "ChIJ99PmULOHbIcRIZxKDR5sK48",
  "googleMapsUrl": "https://maps.google.com/?cid=10316079538237172769",
  "searchQuery": "plumbers in Denver CO",
  "scrapedAt": "2026-08-16T06:40:00.000Z"
}
```

### Pricing

Pay per lead saved to the dataset. Enable **Only save leads with an email** to be charged only for leads that include an email address.

### FAQ

**What percentage of businesses have an email?** Typically 40–60% for service businesses with websites. Google Maps itself rarely lists emails; most come from the business website's homepage or contact page.

**Where do the emails come from?** First from the Google Maps listing; if absent, the actor fetches the website homepage, then up to two contact/about pages, and extracts `mailto:` addresses (or plain-text emails as a fallback). Placeholder/template addresses and asset filenames are filtered out.

**Can I enrich a list of specific businesses?** Yes — paste Google Maps URLs, short links, or Place IDs into **Place URLs or IDs**.

**Do I need a Google API key?** No.

# Actor input Schema

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

What to search on Google Maps, one query per line — e.g. "plumbers in Denver CO", "dentists near Austin TX". Include the city or area for best results.

## `placeUrls` (type: `array`):

Alternatively (or additionally) extract contacts for specific places — Google Maps place URLs, maps.app.goo.gl short links, ?cid= links, Place IDs (ChIJ…) or hex IDs (0x…:0x…).

## `maxPlacesPerQuery` (type: `integer`):

Maximum number of businesses to process per search query. Google Maps returns at most ~120 per query — use several specific queries (by neighborhood or zip code) for full city coverage. 0 = everything Google returns.

## `onlyWithEmail` (type: `boolean`):

Skip businesses where no email address could be found on Google Maps or the business website. You are only charged for saved leads.

## `skipWithoutWebsite` (type: `boolean`):

Don't process businesses that have no website listed on Google Maps (they very rarely have a findable email).

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

Language code for results, e.g. en, de, fr, es, pt-BR.

## `country` (type: `string`):

Two-letter country code that biases search results, e.g. us, gb, de, au.

## `latitude` (type: `number`):

Optional. Center the search around this latitude (use with longitude).

## `longitude` (type: `number`):

Optional. Center the search around this longitude (use with latitude).

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

Map zoom used with latitude/longitude — 3 (continent) to 21 (street). Only used when coordinates are set.

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

Optional. By default the actor connects directly and automatically falls back to Apify datacenter → residential proxies only if Google starts blocking. Set a specific proxy here to force it for all requests.

## Actor input object example

```json
{
  "searchQueries": [
    "plumbers in Denver CO"
  ],
  "placeUrls": [],
  "maxPlacesPerQuery": 50,
  "onlyWithEmail": false,
  "skipWithoutWebsite": false,
  "language": "en",
  "country": "us",
  "zoom": 13,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

One business per record: name, email, emails\[], emailSource, phone, phoneUnformatted, website, websiteDomain, category, address + street/city/postalCode/state/countryCode, latitude/longitude, rating, reviewCount, facebook, instagram, linkedin, twitter, youtube, tiktok, pinterest, yelp, placeId, googleMapsUrl.

# 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": [
        "plumbers in Denver CO"
    ],
    "placeUrls": [],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("seemuapps/google-maps-email-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 = {
    "searchQueries": ["plumbers in Denver CO"],
    "placeUrls": [],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("seemuapps/google-maps-email-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 '{
  "searchQueries": [
    "plumbers in Denver CO"
  ],
  "placeUrls": [],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call seemuapps/google-maps-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,seemuapps/google-maps-email-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/CcCcl87TNrEQtSJhG/builds/g4ECCLhg7pbsBcPDE/openapi.json