# 📧 Google Maps Scraper — Business Email & Contact Finder (`incredible_expertise/google-maps-email-finder`) Actor

LAUNCH (72h): FREE for the first 10 users — price at the platform minimum ($0.01 per 1,000). Find businesses on Google Maps in any city, worldwide, and get the contact email each publishes on its own website, plus phone and socials. Then $6 per 1,000 email leads; pay ONLY when an email is found.

- **URL**: https://apify.com/incredible_expertise/google-maps-email-finder.md
- **Developed by:** [Alex Vega](https://apify.com/incredible_expertise) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.01 / 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/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 Scraper — Business Email & Contact Finder

Find local businesses on **Google Maps in any city, in any country** — and get the **contact email each business publishes on its own website**, together with its phone, social profiles, rating and address.

**Price: $6.00 per 1,000 email leads. You pay ONLY for businesses where an email is actually found.** Businesses that don't publish an email are scanned for free and never appear in your results. No add-on fees, no surprises.

### How it works

1. **You describe the businesses**: a search term and a location (`dentists` in `Redwood City, California`), or several terms × locations, or direct Google Maps place URLs.
2. **The Actor scans Google Maps** and opens each business listing (name, category, rating, reviews, phone, website, address, coordinates).
3. **For every business with a website, it visits the site itself** — the homepage first, then the usual contact pages (`/contact`, `/contacto`, `/contact-us`, …) — and extracts the contact emails and social links **the business itself publishes there**.
4. **Only businesses with at least one published email are delivered** — and those are the only ones you pay for.

### What you get per business

| Field | Meaning |
|---|---|
| `name` | Business name |
| `email` | Primary contact email found on the business website |
| `emails` | All contact emails found on the website |
| `email_source` | The exact page where the email was found (homepage or contact page) |
| `phone` | Phone number as listed on Google Maps |
| `socials` | Social profile links found on the website (Instagram, Facebook, LinkedIn, WhatsApp, TikTok, X) |
| `website` | Business website URL |
| `category`, `rating`, `reviews_count` | Google Maps category, rating and number of reviews |
| `address`, `latitude`, `longitude`, `plus_code` | Location data |
| `opening_hours`, `is_open_now` | Hours line and open-now flag (best-effort) |
| `google_maps_url` | Link to the place on Google Maps |

Results are ready for Excel, Google Sheets, your CRM or your outreach tool.

### Example output (real)

From an actual test run over dental practices in Redwood City, California:

```json
{
  "name": "United Dental",
  "email": "uniteddentalteam@gmail.com",
  "emails": ["uniteddentalteam@gmail.com", "uniteddentalteam@yahoo.com"],
  "email_source": "https://www.unitedentaloffice.com/",
  "phone": "+1 650 367 4300",
  "website": "https://www.unitedentaloffice.com/",
  "socials": {
    "facebook": "https://www.facebook.com/…",
    "instagram": "https://www.instagram.com/…"
  },
  "category": "Dentist",
  "address": "647 Veterans Blvd, Redwood City, CA, USA"
}
```

### Honest expectations

- **Not every business publishes an email.** Many use contact forms instead. In our own test on 8 real dental practices in Redwood City, **6 of 8 (75%) published a contact email** on their website. Your hit rate will vary by niche and country — and remember: **you only pay for the businesses where an email is found**.
- `maxResults` is the number of businesses **scanned** per search, not the number delivered. Delivered results (with email) are usually fewer.
- A single Google Maps search returns at most ~120 businesses. For larger pulls, combine several search terms or locations in one run.

### Where the emails come from (privacy)

Every email in the output is one the business **itself published on its own public website**. This Actor never guesses email patterns (`name@company.com` style), never buys or merges third-party databases, and never collects emails from private sources. Each row tells you exactly where the email was found (`email_source`), so you can verify it yourself in one click.

### FAQ

**What exactly am I charged for?**
One result = one business delivered with at least one published contact email. Scanned businesses without an email cost you nothing.

**Can I filter the businesses?**
Yes: minimum rating, minimum number of reviews, category keyword, businesses with a phone number, and open-now (best-effort).

**Which languages and countries are supported?**
Any language Google Maps supports and any country. Use the `language` input (e.g. `es`) so categories and labels come back in that language.

**Google showed a captcha or the run came back partial — what now?**
Select the RESIDENTIAL group in the proxy settings and/or raise the Actor's run timeout. Residential proxy costs more per GB, so it is never forced.

### Changelog

- **0.1.0** — First release: Google Maps business scan + contact email and social extraction from each business's own website (homepage and contact pages). Pay only for businesses with a found email.

# Actor input Schema

## `categoryFilter` (type: `string`):

Optional: only return businesses whose Google Maps category contains this text (case-insensitive), e.g. 'clinic' or 'dentist'. Filtered-out businesses are not charged.

## `concurrency` (type: `integer`):

How many place pages to extract in parallel. Higher is faster but heavier and more likely to trip Google. Default 3.

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

Google Maps UI language code, e.g. 'en', 'es', 'pt-BR'. Affects field wording returned by Google. Tip: use 'es' for searches in Mexico/Spain so categories and labels come back in Spanish.

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

City/region and country to search in. The pre-filled value is just an example — replace it with your city, e.g. 'Austin, Texas', 'Madrid, Spain', 'Guadalajara, Jalisco'. Ignored if locations is provided.

## `locations` (type: `array`):

Optional: several locations in one run. Combined with every search term. If set, location is ignored.

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

Maximum businesses to SCAN per search term x location (and cap for direct URLs). You receive — and pay for — only the businesses where a published contact email is found, so results are usually fewer than scanned. 120 is the real limit of a single Google Maps search. Trying it out with 40 costs at most about $0.24 (if every business had an email); typically much less. Large values need a higher Actor run timeout.

## `minRating` (type: `number`):

Optional: only return businesses with at least this Google rating (e.g. 4.0). Businesses with no rating are excluded — except when this is 0, which means 'no minimum' and keeps them.

## `minReviews` (type: `integer`):

Optional: only return businesses with at least this many Google reviews.

## `onlyOpenNow` (type: `boolean`):

Optional: only return businesses open at the moment of extraction. Best-effort: read from the opening-hours summary line shown on the place page (English/Spanish); businesses whose line is unclear are excluded. Filtered-out businesses are not charged.

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

Standard Apify Proxy settings. Default: Apify Proxy with no groups (datacenter IPs). For large runs, or if Google shows a captcha, select the RESIDENTIAL group here — residential costs more per GB, so it is never forced. Turn Apify Proxy off to run without a proxy.

## `requirePhone` (type: `boolean`):

If enabled, only returns businesses that list a phone number on Google Maps (on top of having a published email). Filtered-out businesses are not charged.

## `searchTerm` (type: `string`):

Type of business to search for. The pre-filled value is just a ready-to-run example — replace it with what you need, e.g. 'dentists', 'roofing companies', 'auto repair shops', 'hotels'. Ignored if searchTerms is provided.

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

Optional: several search terms in one run. Combined with every location (term x location). If set, searchTerm is ignored.

## `startUrls` (type: `array`):

Optional: extract these Google Maps place URLs directly, without searching. If you provide ONLY URLs and leave the search fields at their example defaults, no search is run. Combine with a changed search term/location to run both.

## Actor input object example

```json
{
  "concurrency": 3,
  "language": "en",
  "location": "Redwood City, California",
  "maxResults": 40,
  "onlyOpenNow": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "requirePhone": false,
  "searchTerm": "dentists"
}
```

# Actor output Schema

## `dataset` (type: `string`):

Dataset of businesses with a found contact email

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("incredible_expertise/google-maps-email-finder").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("incredible_expertise/google-maps-email-finder").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 '{}' |
apify call incredible_expertise/google-maps-email-finder --silent --output-dataset

```

## MCP server setup

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

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/Ge86avsF1Wy2t6vzC/builds/GhePB3b0Id7RLK9Ye/openapi.json
