# Google Maps Email Extractor - Enrich Maps Leads with Emails (`sonic_scraper/google-maps-lead-enricher`) Actor

Google Maps email extractor for existing Maps leads: add same-domain emails, phones, social profiles, contact pages and tech stack to any Google Maps scraper dataset or CSV, with source-page evidence and a 0-100 lead score. Does not search Maps.

- **URL**: https://apify.com/sonic_scraper/google-maps-lead-enricher.md
- **Developed by:** [Group Oject](https://apify.com/sonic_scraper) (community)
- **Categories:** Lead generation, Marketing
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.90 / 1,000 enriched business leads

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 Email Extractor - Enrich Maps Leads with Emails & Socials

Already scraped businesses from Google Maps? **Add their website emails, phone numbers, social profiles, contact pages, and tech stack** - with the source page for every value and an explainable 0-100 lead score. Drop in an Apify dataset ID from any Google Maps scraper run, paste a JSON/CSV export, or just list websites. **$7.00 per 1,000 enriched businesses.**

> **This Actor enriches an existing business list. It does not search Google Maps.** Run a Maps discovery scraper first (for example Apify's Google Maps Scraper), then pass its dataset ID here.

![Apify Console screenshot of enriched website results](https://raw.githubusercontent.com/mustaphalysi/apify-actor-media/main/google-maps-lead-enricher/console.png)

### What can this Google Maps email extractor do?

- **Read Google Maps datasets directly** - pass one or more Apify dataset IDs (private datasets work with your token). Business name, category, address, city, country, phone, rating, review count, and Maps URL are mapped automatically and the full source row is kept in `originalRecord`.
- **Import JSON, JSON Lines, or CSV** exports from any Maps tool, or plain website URLs.
- **Extract same-domain business emails** - visible addresses, `mailto:` links, and `[at]` / `[dot]` obfuscations; free-mail and unrelated domains are filtered out.
- **Extract phones and social profiles** - LinkedIn, Facebook, Instagram, X/Twitter, YouTube, TikTok, Threads.
- **Scan key pages** - homepage plus contact, about, team, pricing, support, and demo pages (up to 20 per site).
- **Detect technologies** - WordPress, Shopify, Wix, Webflow, Squarespace, WooCommerce, GA4, GTM, Meta Pixel, HubSpot, Klaviyo, Stripe, Intercom, and more (29 signatures).
- **Show evidence** - every email, phone, social link, and technology comes with the `sourceUrl` where it was found.
- **Explainable lead score** - `leadScoreBreakdown` lists each signal and its points. No AI guesswork.
- **Deduplicate** businesses by place ID or website + name + address before billing.

### What data can I extract?

| Field | Description |
|---|---|
| `businessName`, `businessCategory`, `address`, `city`, `country` | From your Maps records |
| `rating`, `reviewsCount`, `mapsPhone`, `mapsUrl` | From your Maps records |
| `emails[]`, `phones[]` | Found on the business website |
| `linkedinUrl`, `facebookUrl`, `instagramUrl`, `twitterUrl`, `youtubeUrl`, `tiktokUrl`, `socialLinks[]` | Social profiles |
| `contactPageUrl`, `aboutPageUrl`, `pricingPageUrl` | Key pages |
| `technologies[]`, `cms`, `ecommercePlatform`, tool lists by category, `usesWordPress`, `usesShopify`, ... | Tech stack |
| `leadScore`, `leadScoreBreakdown[]` | 0-100 score and its signals |
| `evidence[]` | `field`, `value`, `sourceUrl` for each extracted value |
| `originalRecord`, `sourceDatasetId`, `sourceIndex` | Join keys back to your source data |
| `domain`, `finalUrl`, `title`, `metaDescription`, `matchedPages[]`, `pageWarnings[]` | Website context |

Key-value store: `SUMMARY` (leads selected, output, leads with email, failures), `ERRORS`, and `UNENRICHED` (records with no usable website or a failed fetch - not billed).

### How much does it cost?

Pay-per-event: **$0.007 per enriched business row** ($7.00 per 1,000) plus a tiny Actor-start fee. Multiple contacts on one business do not add charges. **Businesses with no website, duplicates, and failed websites are not billed** - they go to `UNENRICHED` / `ERRORS`. A successfully processed website is billable even if it publishes no email. Use `maxBusinesses` and the run's maximum charge to cap spend. Check the Pricing tab for current rates.

### How to get emails from Google Maps results

1. Run a Google Maps scraper (for example "dentists in Austin") and copy the run's **dataset ID**.
2. Paste it into **Google Maps dataset IDs** (add your API token only if the dataset is private). Clear the example URLs.
3. Set `maxBusinesses` and, optionally, `maxPagesPerSite` (default 4).
4. Click **Start**, then export to CSV/Excel or push to your CRM. Filter on `emails`, `leadScore`, or technology flags.

### Input example

```json
{
  "datasetIds": ["YOUR_GOOGLE_MAPS_DATASET_ID"],
  "urls": [],
  "maxBusinesses": 500,
  "datasetItemLimit": 1000,
  "includeLinkedPages": true,
  "maxPagesPerSite": 4,
  "extractEmails": true,
  "extractPhones": true,
  "detectTechnologies": true
}
```

### Output example

```json
{
  "businessName": "Example Dental Practice",
  "businessCategory": "Dentist",
  "city": "London",
  "rating": 4.7,
  "reviewsCount": 82,
  "domain": "your-business-website.com",
  "emails": ["contact@your-business-website.com"],
  "contactPageUrl": "https://your-business-website.com/contact",
  "technologies": ["WordPress"],
  "leadScore": 45,
  "leadScoreBreakdown": [
    { "signal": "Website fetched", "points": 10 },
    { "signal": "Business name supplied", "points": 5 },
    { "signal": "Detected technologies", "points": 4 },
    { "signal": "Same-domain email found", "points": 18 },
    { "signal": "Contact page found", "points": 8 }
  ],
  "evidence": [
    { "field": "email", "value": "contact@your-business-website.com", "sourceUrl": "https://your-business-website.com/contact" }
  ]
}
```

Illustrative example, not a real business.

#### How the lead score works

A fetched website starts at 10 points. A supplied name adds 5, a phone 8, a rating of at least 4.2 adds 4, and at least 25 reviews add 4. Each detected technology adds 4 (max 28). A same-domain email adds 18; LinkedIn, contact page, and pricing page add 8 each; ecommerce adds 10, CRM or marketing tools 10, chat 6, and ad tags 6. Capped at 100. It measures available signals, not buying intent.

### Use cases

- **Local lead generation** - add emails to Maps lists of dentists, plumbers, restaurants, agencies, and more.
- **Web design and SEO agencies** - find local businesses on Wix or old WordPress, or without analytics.
- **CRM enrichment** - add contacts and social links to existing records via `originalRecord` join keys.
- **Automations** - trigger this Actor after a Google Maps scraper run in n8n, Make, Zapier, or Apify integrations.

### Integrations and API

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("sonic_scraper/google-maps-lead-enricher").call(run_input={
    "datasetIds": ["YOUR_GOOGLE_MAPS_DATASET_ID"],
    "urls": [],
    "maxBusinesses": 100,
})
for lead in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(lead["businessName"], lead["emails"], lead["leadScore"])
```

### Use with AI agents (MCP)

Connect the Apify MCP server at `https://mcp.apify.com?tools=sonic_scraper/google-maps-lead-enricher` in Claude Desktop, Cursor, VS Code or any MCP client, and your AI assistant can call this actor as a tool. Example prompt: *"Take these Google Maps business URLs, find each business's email and social links, and give me a CSV."*

### FAQ

**Does it scrape Google Maps itself?** No. It enriches records you already have. Pair it with any Google Maps scraper.

**Are emails verified?** No. They are addresses published on the business website. Verify before large campaigns.

**Does it find personal or employee emails?** No. It only keeps addresses on the business's own website domain and does not guess or look up people.

**Does it render JavaScript?** No. It reads server-returned HTML. Contacts injected only by JavaScript or shown as images can be missed.

**Is it legal?** It reads public business websites. You are responsible for GDPR, CAN-SPAM, and other rules when storing or contacting businesses.

### Related Actors

- [Contact Details Scraper](https://apify.com/sonic_scraper/b2b-website-intelligence-scraper) - the same contact and tech-stack extraction for plain domain lists, priced per website.
- [Technical SEO Audit Crawler](https://apify.com/sonic_scraper/technical-seo-audit-crawler) - audit a local business site before pitching SEO.

# Actor input Schema

## `datasetIds` (type: `array`):

Apify dataset IDs from Google Maps scraper runs. The Actor will read business names, websites, phones, addresses, ratings, and categories, then enrich each website.

## `apifyApiToken` (type: `string`):

Optional. Required only when the Google Maps dataset is private. Create a token in Apify Settings > Integrations.

## `businessRecordsText` (type: `string`):

Paste Google Maps-style business records as JSON array, JSON lines, or CSV. Supported fields include title/name, website/url, phone, address, category, rating, reviewsCount, and placeUrl.

## `urls` (type: `array`):

Website URLs to enrich when you do not have a Google Maps dataset yet.

## `urlsText` (type: `string`):

Paste one company website per line, or comma-separated.

## `maxBusinesses` (type: `integer`):

Maximum businesses to enrich and output. Default is 100 so test runs stay predictable.

## `skipBusinessesWithoutWebsite` (type: `boolean`):

If enabled, omit missing-website records from UNENRICHED diagnostics. Missing or failed websites never produce paid dataset rows.

## `datasetItemLimit` (type: `integer`):

Maximum records to read from each input dataset.

## `includeLinkedPages` (type: `boolean`):

Also scan linked same-host contact, about, pricing, company, team, support, and demo pages. HTTP HTML only; JavaScript is not executed.

## `maxPagesPerSite` (type: `integer`):

Maximum pages to fetch per website when key-page crawling is enabled.

## `extractEmails` (type: `boolean`):

Find public email addresses on the website's registrable domain, including common obfuscated formats. Free-mail and unrelated-domain addresses are excluded. Source-page evidence is included; deliverability is not verified.

## `extractPhones` (type: `boolean`):

Find public phone numbers from the pages scanned.

## `detectTechnologies` (type: `boolean`):

Detect CMS, ecommerce, analytics, ads, chat, CRM, payment, and marketing tools.

## `requestDelayMs` (type: `integer`):

Delay after each website request.

## `maxConcurrency` (type: `integer`):

Number of websites to enrich in parallel.

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

Optional proxy configuration. Most public websites work without a proxy.

## `debugMode` (type: `boolean`):

Verbose logging.

## Actor input object example

```json
{
  "datasetIds": [],
  "urls": [
    "https://www.hubspot.com",
    "https://www.shopify.com",
    "https://zapier.com"
  ],
  "maxBusinesses": 100,
  "skipBusinessesWithoutWebsite": false,
  "datasetItemLimit": 1000,
  "includeLinkedPages": true,
  "maxPagesPerSite": 4,
  "extractEmails": true,
  "extractPhones": true,
  "detectTechnologies": true,
  "requestDelayMs": 250,
  "maxConcurrency": 5,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "debugMode": false
}
```

# Actor output Schema

## `leads` (type: `string`):

One enriched local business lead per row.

## `summary` (type: `string`):

Totals, submitted leads, output leads, and failed enrichments.

## `unenriched` (type: `string`):

Missing-website and failed-site records, excluded from the charged dataset.

## `errors` (type: `string`):

Business records or websites that failed to load or parse.

# 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 = {
    "datasetIds": [],
    "urls": [
        "https://www.hubspot.com",
        "https://www.shopify.com",
        "https://zapier.com"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("sonic_scraper/google-maps-lead-enricher").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 = {
    "datasetIds": [],
    "urls": [
        "https://www.hubspot.com",
        "https://www.shopify.com",
        "https://zapier.com",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("sonic_scraper/google-maps-lead-enricher").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 '{
  "datasetIds": [],
  "urls": [
    "https://www.hubspot.com",
    "https://www.shopify.com",
    "https://zapier.com"
  ]
}' |
apify call sonic_scraper/google-maps-lead-enricher --silent --output-dataset

```

## MCP server setup

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

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/FDxENc6sJf0zxi4gy/builds/rRbYY4DDFnbXvYxSe/openapi.json
