# Google Maps Scraper - Places, Ratings, Phone, Website & GPS (`zaver.api/google-maps-scraper`) Actor

Just $2.49 per 1,000 places. Scrape Google Maps for any query - business name, address, rating, reviews count, category, phone, website, opening hours, Place ID and GPS - with a map position/zoom, language and pagination. No proxies. Export CSV, JSON, Excel.

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

## Pricing

from $2.49 / 1,000 place rows

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 Scraper - Places, Ratings, Phone, Website & GPS

**Scrape Google Maps places with the fields that matter for outreach and analysis** - phone, website, opening hours, rating, review count, Place ID and exact coordinates. Target a query, a map area by coordinates, or a single place by ID.

> ⭐ map-area targeting · phone, website & opening hours · Place ID + CID · GPS coordinates · pay per row delivered · CSV/JSON/Excel · API, MCP & schedules

### What data does it extract?

One row per place, with the `query`, `page` and `type` it came from so multi-query exports stay
separable. Fields Google does not return for an item are simply absent, and any new field Google
adds is passed through automatically.

| Field | Description |
|---|---|
| `title` | Business name |
| `address` | Full address |
| `latitude` | Latitude |
| `longitude` | Longitude |
| `rating` | Average star rating |
| `ratingCount` | Number of reviews |
| `item_type` | Google's own category value (renamed so it cannot clash with the row `type`) |
| `types` | All Google categories for the place |
| `phoneNumber` | Phone, where listed |
| `website` | Website, where listed |
| `openingHours` | Opening hours per day |
| `placeId` | Google Place ID |
| `cid` | Google customer ID |
| `thumbnailUrl` | Listing photo |
| `position` | Rank within the page |
| `query` | The query this row came from |
| `page` | Which results page it came from |

#### Example output

```json
{
  "query": "coffee shop new york",
  "page": 1,
  "type": "place",
  "position": 1,
  "title": "787 coffee",
  "address": "245 W 46th St, New York, NY 10036",
  "latitude": 40.7597441,
  "longitude": -73.9875048,
  "rating": 4.9,
  "ratingCount": 3585,
  "item_type": "Coffee shop",
  "types": [
    "Coffee shop"
  ]
}
```

### How to use it

1. Paste your queries into **`queries`** - one per line.
2. Set the options you need from the table below.
3. Run it, then download the dataset as **CSV, Excel, JSON, JSONL or XML** - or read it straight from
   the Apify API.

#### Input example

```json
{
  "queries": [
    "coffee shop",
    "gym"
  ],
  "ll": "@40.7128,-74.0060,12z",
  "hl": "en",
  "maxPages": 5
}
```

| Option | Type | Description |
|---|---|---|
| `queries` | array | **Required.** Search queries, one per line. |
| `ll` | string | Map centre and zoom - `@40.7128,-74.0060,12z`. **Required to page beyond page 1.** |
| `placeId` | string | Fetch one specific place by Google Place ID. |
| `cid` | string | Fetch one specific place by Google Maps CID. |
| `gl` | string | Country code - `us`, `in`, `gb`, `de`... |
| `hl` | string | Language code - `en`, `hi`, `es`... |
| `maxPages` | integer | Pages per query, default 1. Each page is one request. |

### Pricing

| Event | Price |
|---|---|
| `place-result` | **$2.49 per 1,000 places** ($0.00249 per place) |

1,000 places → **$2.49** · 10,000 → **$24.90** · 100,000 → **$249.00**

You are billed per row delivered, as it is delivered. Queries that fail or return nothing cost you
nothing, and an interrupted run only ever bills the rows already in your dataset.

### Use cases

#### Build outreach lists of local businesses with phone and website

Maps carries phone, site and opening hours in one row - everything a cold-call or local-service campaign needs, with GPS for routing.

#### Sweep a city area by area

Move the `ll` centre across a grid of coordinates to cover a metro systematically instead of hoping one query returns everything.

#### Benchmark competitor density and ratings by neighbourhood

Compare how many places rank per area and what they score, to spot saturated and thin markets.

#### Create store-locator and POI datasets

Coordinates, Place ID and categories give you a clean base layer for an app or analysis.

#### Monitor ratings and review counts over time

Schedule the same query set and track `rating` and `ratingCount` drift per `placeId`.

### Good to know

- **Set `ll` when `maxPages` > 1** - Google requires a map centre for paginated Maps search.
- About 20 places per page; each page is one request.
- There is no date filter for Maps results; recency options do not apply here.

### Frequently asked questions

#### Do I need proxies, an API key or a Google account?

No. Requests run through hosted Google search infrastructure on our side - nothing to configure.

#### Why do I need `ll` and what does it do?

`ll` sets the map centre and zoom, for example `@40.7128,-74.0060,12z`. Google requires it to return page 2 and beyond, so **set `ll` whenever `maxPages` is above 1** - without it, deeper pages return an error instead of places.

#### How many places can I get per query?

About 20 per page. Depth comes from `maxPages` with `ll` set; for large areas, move the `ll` centre across a grid of points rather than paging very deep.

#### Can I scrape one specific business?

Yes - pass `placeId` or `cid` to fetch a single listing, which is the cheapest way to refresh records you already hold.

#### Do I get emails or reviews?

Neither. Maps exposes phone, website and hours; review text and emails are separate products. Feed the `website` column into a contact extractor for emails.

#### How is this different from the Google Places Scraper?

Maps adds opening hours, Place ID and map-area targeting by coordinates. Places reads Google's local search results and is simpler for plain "service + city" prospecting.

#### How do I export Google Maps data to CSV or Excel?

Download the run's dataset as CSV, Excel, JSON, JSONL or XML, or read it via the Apify API.

#### Am I charged for queries that return no places?

No. Billing is per row delivered.

### Related Google scrapers

- [Google Search Results Scraper](https://apify.com/zaver.api/google-search-scraper) - organic rankings and People Also Ask
- [Google Images Scraper](https://apify.com/zaver.api/google-images-scraper) - image URLs, sizes and source pages
- [Google Videos Scraper](https://apify.com/zaver.api/google-videos-scraper) - video results across YouTube, TikTok and the web
- [Google Places Scraper](https://apify.com/zaver.api/google-places-scraper) - local business results with phone and website
- [Google Patents Scraper](https://apify.com/zaver.api/google-patents-scraper) - patents with inventors, assignees and dates
- [Google Shopping Scraper](https://apify.com/zaver.api/google-shopping-scraper) - products with prices, sellers and ratings

***

*Not affiliated with or endorsed by Google. Returns publicly available search results.*

# Actor input Schema

## `queries` (type: `array`):

Search queries, one per line.

## `ll` (type: `string`):

GPS centre and zoom for the map search, format <code>@latitude,longitude,zoom</code>, e.g. <code>@15.2993,74.1240,12z</code>. Leave empty to let Google infer from the query.

## `placeId` (type: `string`):

Google Place ID to target one specific place.

## `cid` (type: `string`):

Google Maps CID to target one specific place.

## `gl` (type: `string`):

Two-letter country code for localised results, e.g. <code>us</code>, <code>in</code>, <code>th</code>, <code>gb</code>. Leave empty for default.

## `hl` (type: `string`):

Interface language code, e.g. <code>en</code>, <code>hi</code>, <code>th</code>. Leave empty for default.

## `dateRange` (type: `string`):

Restrict results to a recent period.

## `maxPages` (type: `integer`):

How many result pages to fetch per query. You are billed only per row delivered.

## Actor input object example

```json
{
  "queries": [
    "influencer goa"
  ],
  "ll": "",
  "placeId": "",
  "cid": "",
  "gl": "",
  "hl": "",
  "dateRange": "",
  "maxPages": 1
}
```

# Actor output Schema

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

One dataset item per result.

## `resultsCsv` (type: `string`):

CSV download.

## `runSummary` (type: `string`):

Counts for the run.

# 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 = {
    "queries": [
        "influencer goa"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("zaver.api/google-maps-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 = { "queries": ["influencer goa"] }

# Run the Actor and wait for it to finish
run = client.actor("zaver.api/google-maps-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 '{
  "queries": [
    "influencer goa"
  ]
}' |
apify call zaver.api/google-maps-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,zaver.api/google-maps-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/sNTWjGMsjXcZWgD8o/builds/vuqut5z2QcrERTm9W/openapi.json