# Google Maps Scraper API: Places, Leads, Emails & Phones (`sauliusautomatesit/google-maps-scraper-api`) Actor

Google Maps scraper and Google Places API alternative: business name, phone, website, address, rating, review count, opening hours, categories and coordinates for any search and area, plus emails and social profiles from each website. Splits big areas for thousands of leads. $2 per 1,000 places.

- **URL**: https://apify.com/sauliusautomatesit/google-maps-scraper-api.md
- **Developed by:** [Saulius AutomatesIT](https://apify.com/sauliusautomatesit) (community)
- **Categories:** Lead generation, Marketing, AI
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.70 / 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 API: Places, Leads, Emails & Phones

Scrape Google Maps like an API. Type a search (`dentist`, `coffee shop`, `plumber`) and a location (`Austin, TX`,
`10001`, `London`) and get every business Google Maps lists there: name, phone, website, full address, rating,
review count, opening hours, categories, coordinates, Place ID and Google Maps link. Turn on contact details and each
place's website is read for **emails and social profiles** in the same run.

A Google Places API alternative with no API key, no Google Cloud billing account and no 60 result limit.

### Price

| What | Price |
|---|---|
| Place (all fields below, opening hours and review count included) | **$2 per 1,000 places** |
| Contact details from the website (emails, social profiles) | **$1 per 1,000 places**, only when at least one was found |
| Actor start | $0.00005 |

Places you filter out (minimum rating, with or without website, closed places) are free. Store discounts apply on
higher Apify plans.

### What you get

- **Business data:** name, main category and all categories, description, phone (formatted and E.164), website.
- **Location:** full address, street, neighborhood, city, ZIP, state, country code, latitude and longitude, time zone.
- **Reputation:** rating and review count.
- **Hours and status:** opening hours for every day, open now text, permanently or temporarily closed flags.
- **IDs and links:** Place ID, CID, feature ID, Knowledge Graph ID and a Google Maps link.
- **Extras:** photo count, main photo, whether the owner claimed the listing.
- **Contact details (optional):** best email first, all emails, phone numbers on the website, Facebook, Instagram,
  LinkedIn, X, YouTube, TikTok, Pinterest and WhatsApp profiles, and the contact page link.

### Thousands of places per city

Google Maps stops at about 120 places per search. When you ask for more, the Actor splits the map into smaller
tiles and searches each one, the way you would zoom in by hand, and removes duplicates. Ask for 5,000 dentists in
Texas and it keeps splitting until it has them or the area runs out.

### Input example

```json
{
  "searchStringsArray": ["dentist", "orthodontist"],
  "locationQuery": "Miami, FL",
  "maxCrawledPlacesPerSearch": 500,
  "scrapeContacts": true,
  "website": "withWebsite"
}
```

You can also paste Google Maps search links (`https://www.google.com/maps/search/dentist/@40.7128,-74.006,13z`):
the search text and the map area in the link are used.

### Output example

A real row (Seattle florists, 8 Oct 2026, contact details on):

```json
{
  "type": "place",
  "title": "LUCIOL bouquets",
  "categoryName": "Florist",
  "categories": ["Florist", "Boutique", "Flower delivery", "Flower market", "Gift basket store", "Gift shop", "Wedding service"],
  "address": "2445 4th Ave S, Seattle, WA 98134",
  "neighborhood": "SODO",
  "street": "2445 4th Ave S",
  "city": "Seattle",
  "postalCode": "98134",
  "state": "Washington",
  "countryCode": "US",
  "latitude": 47.5803892,
  "longitude": -122.3293211,
  "phone": "(425) 535-6575",
  "phoneUnformatted": "+14255356575",
  "website": "http://luciolbouquets.com/",
  "rating": 5,
  "reviewsCount": 134,
  "imagesCount": 81,
  "openingHours": [{ "day": "Thursday", "hours": "9 AM–9 PM" }, { "day": "Friday", "hours": "9 AM–9 PM" }],
  "openNow": "Open · Closes 9 PM",
  "permanentlyClosed": false,
  "claimedByOwner": true,
  "timezone": "America/Los_Angeles",
  "placeId": "ChIJ7fGn8fddkFQRXSpcFtnAQas",
  "cid": "12340356492587444829",
  "url": "https://www.google.com/maps/search/?api=1&query=LUCIOL%20bouquets&query_place_id=ChIJ7fGn8fddkFQRXSpcFtnAQas",
  "searchString": "florist",
  "searchLocation": "Seattle, WA",
  "rank": 12,
  "primaryEmail": "luciolbouquets@gmail.com",
  "emails": ["luciolbouquets@gmail.com"],
  "instagrams": ["https://www.instagram.com/luciol_bouquets"],
  "contactPageUrl": "https://luciolbouquets.com/policies/contact-information",
  "contactsStatus": "FOUND"
}
```

### Use it as an API

Run it from any language with the Apify API or client, or call it from an AI agent through Apify's MCP server
(`https://mcp.apify.com/?tools=sauliusautomatesit/google-maps-scraper-api`).

```bash
curl -X POST "https://api.apify.com/v2/acts/sauliusautomatesit~google-maps-scraper-api/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "content-type: application/json" \
  -d '{"searchStringsArray":["plumber"],"locationQuery":"Denver, CO","maxCrawledPlacesPerSearch":100}'
```

### Who uses it

- **Lead generation:** local businesses by category and city with phone, website and email, ready for a CRM.
- **Agencies:** businesses without a website, or with a low rating, as prospects.
- **Market research:** count competitors, ratings and reviews by area.
- **Data enrichment:** Place IDs, coordinates and opening hours for store locators and maps.

### Good to know

- Only data Google Maps shows to any visitor is collected. Reviews text and photos galleries are not included.
- A location that Google reads as a wide area (a big city) can include nearby towns; every row has its city and ZIP
  so you can filter, or use ZIP codes or a Google Maps link for a tight area.
- Contact details come from the business's own public website. Sites that block automated visits return
  `contactsStatus: "BLOCKED"` and are not charged for contacts.
- Run summary (searches, map tiles, places found and filtered) is saved as `OUTPUT` in the run's key-value store.

### Related Actors

- [Contact Details Scraper API](https://apify.com/sauliusautomatesit/contact-details-scraper-api): emails and social profiles for any list of websites.
- [Google Hotels API](https://apify.com/sauliusautomatesit/google-hotels-api): hotel prices from every booking site.
- [Bing Search API](https://apify.com/sauliusautomatesit/bing-search-api): web search results.

# Actor input Schema

## `searchStringsArray` (type: `array`):

One search per line, as you would type it into Google Maps: `dentist`, `coffee shop`, `plumber`, `italian restaurant`. Each search runs in the location below.

## `locationQuery` (type: `string`):

City, area, ZIP code or address: `Austin, TX`, `Brooklyn, New York`, `10001`, `London`. Leave empty when the searches already say where (`dentist in Miami`).

## `maxCrawledPlacesPerSearch` (type: `integer`):

Stop each search after this many places. Google Maps shows about 120 places per search; above that the area is split into smaller map tiles automatically, so thousands of places per city work.

## `scrapeContacts` (type: `boolean`):

Visit each place's website (home, contact and about pages) and add emails, extra phone numbers and Facebook, Instagram, LinkedIn, X, YouTube and TikTok profiles. Charged as a separate `contact-details` event only for places where at least one email or social profile was found.

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

Google Maps search links, for example `https://www.google.com/maps/search/dentist/@40.7128,-74.006,13z`. The search text and the map area in the link are used.

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

Only places rated at least this (1 to 5). Places filtered out are not charged.

## `website` (type: `string`):

Keep all places, only places with a website, or only places without one (prospects for web design and marketing agencies). Places filtered out are not charged.

## `skipClosedPlaces` (type: `boolean`):

Leave out places Google marks as permanently or temporarily closed.

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

Language of categories, opening hours and descriptions, as a code: `en`, `de`, `fr`, `es`.

## `countryCode` (type: `string`):

Two-letter country code Google uses to read ambiguous locations: `us`, `gb`, `de`.

## `maxPagesPerWebsite` (type: `integer`):

With contact details on: pages read on each website (home page first, then contact, imprint and about pages).

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

Apify Proxy is used by default.

## Actor input object example

```json
{
  "searchStringsArray": [
    "coffee shop"
  ],
  "locationQuery": "Austin, TX",
  "maxCrawledPlacesPerSearch": 20,
  "scrapeContacts": false,
  "website": "all",
  "skipClosedPlaces": false,
  "language": "en",
  "countryCode": "us",
  "maxPagesPerWebsite": 3,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

One item per place. Download as JSON, CSV or Excel, or read it from this API endpoint.

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

Searches, places delivered, map tiles searched and failures.

# 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 = {
    "searchStringsArray": [
        "coffee shop"
    ],
    "locationQuery": "Austin, TX",
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("sauliusautomatesit/google-maps-scraper-api").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 = {
    "searchStringsArray": ["coffee shop"],
    "locationQuery": "Austin, TX",
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("sauliusautomatesit/google-maps-scraper-api").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 '{
  "searchStringsArray": [
    "coffee shop"
  ],
  "locationQuery": "Austin, TX",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call sauliusautomatesit/google-maps-scraper-api --silent --output-dataset

```

## MCP server setup

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

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/yRWWYhuSuLBWzOUhh/builds/xLkLQAQt0XYxxHm5z/openapi.json