# Google Maps Scraper $0.03/1K Places: Leads, Emails & Reviews (`zaiq/google-maps-leads-scraper`) Actor

Find businesses on Google Maps by search, location, Maps link or place ID. Get phones, websites, ratings, hours and optional top reviews. Enrich leads with emails, website phones and social profiles, with source pages. Deduplicated across searches. No login. $0.03 per 1,000 places.

- **URL**: https://apify.com/zaiq/google-maps-leads-scraper.md
- **Developed by:** [Zaiq](https://apify.com/zaiq) (community)
- **Categories:** Lead generation, Business, Marketing
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.03 / 1,000 places

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 with Emails: Leads, Phones & Reviews

Find **business leads on Google Maps** by business type and location, complete search, Maps link or place ID. Each unique business becomes one row with its available phone, website, rating, review count, hours, categories, address and coordinates.

**Website contacts are on by default.** The Actor reads public HTML on the business website and contact pages, returning emails and phones with source URLs, plus linked social profiles. Top reviews are optional and included in the place price. No Google login or AI model is required.

### What you get

| Field | What it holds |
|---|---|
| Business details | `name`, `placeId`, `cid`, `mapsUrl`, `categories`, `address`, `addressParts`, `phone`, `phoneInternational`, `website`, `rating`, `reviewsCount`, `priceLevel`, `openingHours`, `coordinates`, `businessStatus`, `attributes`, `thumbnail` |
| Search provenance | `searchQuery`, original `rank`, and `searchMatches` containing the searches that found the same business. One place row across the run. |
| Website contacts | `primaryEmail`, `emails` with `sourceUrl`, `websitePhones` with E.164 numbers and source URLs, `socials`, `contactPage`, `contactPages`, `contactFormPages`, `contactsStatus`, `contactsNote` |
| Optional top reviews | `topReviews`: available review text, stars, publication date, author, owner response, visit details and photo URLs; `reviewsNote` explains coverage. |
| SUMMARY | Per-input pages, candidates, matched places, filters, duplicates, status notes, contact outcomes, traffic and actual charged event counts. |

### What people use it for

- **Local business lists:** Build a list by service and area, with identifiers for joining it to your existing records.
- **Lead qualification:** Keep businesses with a website or phone, and apply minimum rating and review-count filters.
- **Business research:** Review opening hours, amenities, publicly listed contact information and the small review sample Google exposes.
- **Coverage checks:** Combine adjacent areas or related search terms and keep one row per business.

### How to use it

1. Enter **Searches**, such as `plumbers in Austin, TX`, or enter `plumbers` with a **Location**. You can also supply Maps links or place IDs.
2. Choose **Most places per search** (default 100). Website contacts are on; turn on **Top reviews** if useful. Set filters and the run spending limit.
3. Start the run, then open **Business leads**, **Website contacts** or **Top reviews**. Download JSON for nested fields, or CSV/Excel for a flat lead list. Read `SUMMARY` for any coverage limits.

### Input

| Field | Example | Notes |
|---|---|---|
| searches | `["plumbers in Austin, TX"]` | Complete searches, or business types combined with locations. |
| locations | `["Austin, TX", "Cape Town, South Africa"]` | Optional: each search is combined with every location. Leave empty for complete searches. |
| mapsUrls | `["https://www.google.com/maps/search/dentists+in+Cape+Town/"]` | Search links are paged; a place link requests one place. |
| placeIds | `["EXAMPLE_PLACE_ID"]` | Replace the placeholder with an actual ID from a prior Maps row. |
| maxPlacesPerSearch | `100` | 1–500 matching places per search; cross-search duplicates do not create extra rows. |
| language / country | `en` / `us` | Google language and two-letter regional setting. The named location controls the area; country does not change the connection location. |
| contacts | on | Read public website contacts. |
| topReviews | off | Small signed-out review sample; included in place pricing. |
| maxContactPages | `4` | 1–8 website pages. Robots requests and redirects also count as network requests. |
| hasWebsite / hasPhone | off | Require these fields in the Google result, before website enrichment. |
| minRating / minReviews | `0` / `0` | Positive values exclude unknown values as well as values below the threshold. |
| skipPermanentlyClosed | on | Temporarily closed businesses remain, with their status. |

### Output

Each result is one row in the run's dataset (download it as JSON, CSV, Excel, XML or HTML, or read it through the API). An example row (values shortened):

```json
{
  "kind": "place",
  "rank": 1,
  "searchQuery": "plumbers in Cape Town, South Africa",
  "rating": 4.8,
  "reviewsCount": 263,
  "categories": [
    "Plumber"
  ],
  "businessStatus": "open",
  "openingHours": {
    "Saturday": "Open 24 hours",
    "Sunday": "Open 24 hours",
    "Monday": "Open 24 hours",
    "Tuesday": "Open 24 hours",
    "Wednesday": "Open 24 hours",
    "Thursday": "Open 24 hours",
    "Friday": "Open 24 hours"
  },
  "name": "Example Plumbing Services",
  "placeId": "EXAMPLE_PLACE_ID",
  "cid": "EXAMPLE_CID",
  "mapsUrl": "https://www.google.com/maps/place/?q=place_id:EXAMPLE_PLACE_ID",
  "address": "37 Example Street, Example Suburb, Cape Town, 7405, South Africa",
  "addressParts": {
    "street": "37 Example Street",
    "city": "Cape Town",
    "postalCode": "7405",
    "region": null,
    "countryCode": "ZA"
  },
  "phone": "+27 21 555 0100",
  "website": "https://business.example/",
  "emails": [
    {
      "email": "info@business.example",
      "source": "text",
      "sourceUrl": "https://business.example/"
    }
  ],
  "websitePhones": [
    {
      "e164": "+27215550100",
      "source": "tel-link",
      "sourceUrl": "https://business.example/"
    }
  ],
  "socials": {
    "facebook": [
      "https://www.facebook.com/example.business"
    ]
  },
  "contactPage": "https://business.example/contact.html",
  "contactsStatus": "found",
  "topReviews": [
    {
      "stars": 5,
      "publishedAt": "2026-05-02T09:04:51.164643Z",
      "author": "Example Reviewer",
      "text": "Absolutely amazing service! The plumbers were professional, punctual, and knew exactly what they were doing. [excerpt]"
    }
  ],
  "reviewsNote": "5 top reviews shown to a signed-out visitor; not the full review history",
  "chargedEvents": [
    "place",
    "contacts"
  ]
}
```

This shortened example comes from the final 20-place Cape Town test on 17 October 2026: 100 top reviews and website emails or phones for 17 businesses. Names, handles, identifiers, site addresses, street details and phone numbers have been replaced; the review text is a shortened excerpt. Ratings, counts and hours come from the original row. The other three places had no website, an HTTP error or no extractable contacts; no contacts event was charged for them. `SUMMARY` records coverage, notes and charged event counts for each run.

### Pricing

- **$0.00003 per unique place** ($0.03 per 1,000) delivered. Available Maps details and optional top reviews are included.
- **An additional $0.0002 per contact-enriched place** ($0.20 per 1,000), only when the website provides an email or a non-fax phone. The same phone as on Maps still qualifies if independently found on the website.
- Duplicates, filtered places and failed lookups are free. A place without a website, a blocked website or social links alone does not trigger the contacts event. A valid Maps place remains chargeable even when its website cannot be read.
- No extra review event, model bill, setup fee or per-request event. Website contacts reused for another branch are charged per enriched place.
- Launch price. It may rise later; Apify emails every user 14 days before any price increase takes effect, and a rise can happen at most once a month.
- Measured on Apify on 17 October 2026: 40 places in 9 seconds; 20 places with website contacts for 17 of them in 149 seconds.

What typical jobs cost at the list price:

| Job | Cost |
|---|---|
| 100 places, contacts off | $0.003 |
| 100 places, website contacts found for 50 | $0.013 |
| 100 places, website contacts found for all 100 | $0.023 |
| One place with top reviews and website contacts | $0.00023 |

On Apify's Scale and Business plans the per-event prices are lower (Store discounts). Set **Maximum cost per run** and the Actor stops cleanly when it is reached: you never pay more than that.

### Tips

- For more coverage, split a large city into neighborhoods and use related business terms. Google search is a ranked list, not an exhaustive business registry.
- Keep locations empty when each search already contains its location. Multiple searches and locations create every combination.
- Use `placeId` or `cid` to match results to earlier exports. Deduplication applies within one run, not across scheduled runs.
- Check `contactsStatus` and source URLs before using a lead. Public websites can list central-office contacts shared by branches.
- Use JSON to retain arrays of emails, opening hours and review objects. Flat exports can serialize nested fields.

### Use it through the API

**Python**

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("zaiq/google-maps-leads-scraper").call(run_input={"searches": ["plumbers in Cape Town, South Africa"], "maxPlacesPerSearch": 20, "country": "za"})
for row in client.dataset(run.default_dataset_id).iterate_items():
    print(row)
```

**JavaScript**

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('zaiq/google-maps-leads-scraper').call({"searches": ["plumbers in Cape Town, South Africa"], "maxPlacesPerSearch": 20, "country": "za"});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

**HTTP (one call, results back)**

```bash
curl -X POST 'https://api.apify.com/v2/acts/zaiq~google-maps-leads-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"searches": ["plumbers in Cape Town, South Africa"], "maxPlacesPerSearch": 20, "country": "za"}'
```

### Integrations and schedules

- **Schedules:** run it every hour, day or week from the Apify Console (Schedules) and keep a history of results.
- **Make, Zapier, n8n, Google Sheets, Slack, Airtable:** connect it through Apify's integrations, or send each finished run to a **webhook**.
- **Datasets:** results stay in the run's dataset; export them or read them by API whenever you need them.

### Use it with AI agents (MCP)

Add Apify's MCP server with this Actor already pinned (`https://mcp.apify.com?tools=zaiq/google-maps-leads-scraper`) to Claude, ChatGPT, Cursor, VS Code or any MCP client. The agent can find this Actor and run it for you: ask it for "find plumbers in Cape Town with a website and at least 50 reviews, including their publicly listed contact details". AI agents can also pay for runs directly through Apify's agentic payments.

### Limits

- The Actor reads public, signed-out data. Google Maps is read through a direct connection first; if Google refuses it, the run moves to Apify Proxy (datacenter, then residential) at no extra charge to you. Business websites are always read directly. It never uses logins, CAPTCHA solving or browser rendering. If every route is refused, the affected searches are listed as free notes, not forced through. Top reviews are skipped in a run that has to use residential addresses.
- Google often exposes only part of an area’s businesses. Paging ends on an empty page, a repeated page, the requested result count or a safety limit. This is not a promise of every business in a city.
- At most 50 search/location combinations and links, 600 candidates per search and 150 requests per site per run. Large review-heavy jobs may hit the Maps request limit; already found places remain available with review notes.
- Top reviews are the limited most-relevant sample in the place page, commonly five in testing. There is no full review pagination, newest-first sorting or guarantee that every place exposes reviews.
- Website extraction respects robots.txt. Each site has a 40-second crawl deadline, a page limit and bounded response sizes. JavaScript-only contacts, blocked sites and login pages may yield no contacts. Emails are extracted from source pages, not guessed or mailbox-verified.
- Fields Google does not provide stay null or empty. `businessStatus: open` means not marked temporarily or permanently closed; `openNow` carries the current hours label, not a live availability guarantee.
- The spending limit covers the two event types together. When a place fits but contacts do not, its website is skipped and the place is delivered with `contactsStatus: budget-skipped`. Discovery may stop early to reserve the remaining budget.
- Unavailable inputs produce free `kind: diagnostic` rows alongside the place rows. Downstream workflows can filter on `kind: place`.

### FAQ

**Does this return email addresses from Google Maps?**

Email addresses come from the business website, with the source page recorded. Google supplies the website, phone and place details.

**What counts as a successful contacts event?**

At least one email or non-fax phone from the website. A social profile alone is not enough. A website phone can match the Maps phone.

**Are reviews an extra charge?**

No. The optional top reviews are included in the place event. Only the limited signed-out sample is available.

**What happens when a website fails?**

You keep the Maps place and its listed phone/website. The contacts fields explain the failure and no contacts event is charged.

**Can I request several countries?**

Yes. Include the country in each location or full search. The country setting is a Google regional preference; it does not route traffic through that country.

**Are duplicates charged twice?**

The same place is emitted once per run, matched by place ID, CID or feature ID. `searchMatches` records its appearances in completed searches. Separate branches remain separate places.

**Does a closed business get returned?**

Permanently closed businesses are skipped by default. Turn that filter off to include them. Temporarily closed businesses are returned with their status.

**Can I fetch more contacts with a browser?**

This Actor reads HTML only. JavaScript-dependent or blocked sites may need a separate website-crawling workflow.

### Related Actors from Zaiq

- [contact-details-extractor](https://apify.com/zaiq/contact-details-extractor): website-first contact extraction with additional crawl options
- [google-maps-rank-grid](https://apify.com/zaiq/google-maps-rank-grid): measure how a business ranks at points around its location
- [company-research-agent](https://apify.com/zaiq/company-research-agent): turn company websites into researched profiles

### Support

Questions, a site that changed, or a field you need? Open an issue on this Actor's **Issues** tab: we answer there, usually within a day.

***

Also found as: google maps scraper, google maps email scraper, business leads scraper, google maps contact details, google maps phones, google maps top reviews, local business data.

# Actor input Schema

## `searches` (type: `array`):

Business types or complete searches. With locations, each search runs in each location. Whole queries such as plumbers in Austin work without locations.

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

Optional cities or areas paired with each search. For multiple countries include the country in each location.

## `mapsUrls` (type: `array`):

Google Maps search or place links, including Maps short links. Search links are paged; place links request that one business.

## `placeIds` (type: `array`):

Google place IDs, such as a ChIJ identifier copied from a previous result.

## `maxPlacesPerSearch` (type: `integer`):

Maximum matching places per search, before deduplication across searches. Google may list fewer. Scan is bounded to 600 candidates per search and 150 Maps requests per run.

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

Language code for Google names, hours and reviews, for example en, af, de or pt-BR.

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

Two-letter Google regional setting, for example us or za. The location in the search decides the area. This does not change the connection country.

## `contacts` (type: `boolean`):

Read the business website and contact pages for sourced emails, phones and social profiles. Charge only when an email or non-fax phone is found.

## `topReviews` (type: `boolean`):

Read the limited reviews shown on the signed-out place page, usually a small most-relevant selection. Included in the place price; never promises all reviews.

## `maxContactPages` (type: `integer`):

Maximum website pages, including the starting page, read for contacts. Robots checks and redirects also use requests. Plain HTML only.

## `hasWebsite` (type: `boolean`):

Keep only places with a website listed on Google Maps.

## `hasPhone` (type: `boolean`):

Keep only places with a phone listed on Google Maps, before website enrichment.

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

Minimum Google rating. Zero turns the filter off; unrated places fail a positive minimum.

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

Minimum Google review count. Zero turns the filter off; unknown counts fail a positive minimum.

## `skipPermanentlyClosed` (type: `boolean`):

Exclude places Google marks permanently closed. Temporarily closed places are kept and labelled.

## Actor input object example

```json
{
  "searches": [
    "plumbers in Austin, TX"
  ],
  "maxPlacesPerSearch": 10,
  "language": "en",
  "country": "us",
  "contacts": true,
  "topReviews": false,
  "maxContactPages": 4,
  "hasWebsite": false,
  "hasPhone": false,
  "minRating": 0,
  "minReviews": 0,
  "skipPermanentlyClosed": true
}
```

# Actor output Schema

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

Dataset: the results.

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

What each input returned, and notes.

# 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 = {
    "searches": [
        "plumbers in Austin, TX"
    ],
    "maxPlacesPerSearch": 10,
    "language": "en",
    "country": "us",
    "contacts": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("zaiq/google-maps-leads-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 = {
    "searches": ["plumbers in Austin, TX"],
    "maxPlacesPerSearch": 10,
    "language": "en",
    "country": "us",
    "contacts": True,
}

# Run the Actor and wait for it to finish
run = client.actor("zaiq/google-maps-leads-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 '{
  "searches": [
    "plumbers in Austin, TX"
  ],
  "maxPlacesPerSearch": 10,
  "language": "en",
  "country": "us",
  "contacts": true
}' |
apify call zaiq/google-maps-leads-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,zaiq/google-maps-leads-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/6jqijBhHMbEm4iZOh/builds/Wn01oK7qCanndMBco/openapi.json
