# 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:** [Seemu Scraping](https://apify.com/seemuapps) (community)
- **Categories:** Lead generation, SEO tools, Automation
- **Features:** Limited permissions
- **Stats:** 24 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/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 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/VpdKAJ2edwoql2Mgv/openapi.json
