# Google Maps Scraper (`pramodkonde17/google-maps-scraper`) Actor

Scrapes Google Maps for places matching search queries. Extracts full details: name, address, phone, website, rating, hours, reviews, photos, Q\&A, and popular times.

- **URL**: https://apify.com/pramodkonde17/google-maps-scraper.md
- **Developed by:** [Pramod Konde](https://apify.com/pramodkonde17) (community)
- **Categories:** Travel, Integrations, Automation
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $15.00 / 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.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Google Maps Scraper — Apify Actor

Scrapes Google Maps for places matching your search queries. Extracts full details:

- **Basic info** — name, address, phone, website, category, rating, price level, hours, coordinates
- **Reviews** — author, rating, text, date, owner response, likes
- **Photos** — high-resolution photo URLs
- **Q&A** — community questions and answers
- **Popular times** — hourly occupancy breakdown by day

Built with [Crawlee](https://crawlee.dev/) + [Playwright](https://playwright.dev/) and [Apify SDK v3](https://docs.apify.com/sdk/js/).

---

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `searchQueries` | `string[]` | required | Search terms, e.g. `"restaurants in New York"` |
| `maxResultsPerQuery` | `number` | `20` | Max places per query |
| `maxReviewsPerPlace` | `number` | `10` | Max reviews per place (0 = skip) |
| `maxPhotosPerPlace` | `number` | `10` | Max photo URLs per place (0 = skip) |
| `language` | `string` | `"en"` | Google Maps language code |
| `scrapeReviews` | `boolean` | `true` | Enable review scraping |
| `scrapePhotos` | `boolean` | `true` | Enable photo URL collection |
| `scrapeQA` | `boolean` | `true` | Enable Q&A scraping |
| `scrapePopularTimes` | `boolean` | `true` | Enable popular times scraping |
| `proxyConfig` | `object` | — | Apify proxy config (residential recommended) |

#### Example input

```json
{
  "searchQueries": ["pizza in Manhattan", "coffee shops Brooklyn"],
  "maxResultsPerQuery": 30,
  "maxReviewsPerPlace": 20,
  "language": "en",
  "proxyConfig": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}
````

***

### Running locally

```bash
## Install dependencies
npm install

## Run with Apify CLI (reads input from storage/key_value_stores/default/INPUT.json)
apify run

## Or run directly with tsx (for quick testing)
npx tsx src/main.ts
```

#### Local input file

Create `storage/key_value_stores/default/INPUT.json`:

```json
{
  "searchQueries": ["restaurants in London"],
  "maxResultsPerQuery": 5,
  "maxReviewsPerPlace": 3,
  "scrapePhotos": false,
  "scrapeQA": false,
  "scrapePopularTimes": false
}
```

***

### Deploying to Apify

#### Via Apify CLI

```bash
## Login
apify login

## Push to Apify (creates or updates the actor)
apify push
```

#### Via GitHub integration

1. Push this directory to a GitHub repo (the actor root should be the repo root).
2. In Apify Console → **Actors** → **Create new** → **Link GitHub repo**.
3. Apify will auto-build on every push.

***

### Output schema

Each place is saved as a dataset item:

```jsonc
{
  "placeId": "ChIJ...",
  "name": "Joe's Pizza",
  "url": "https://www.google.com/maps/place/...",
  "searchQuery": "pizza in Manhattan",
  "address": "7 Carmine St, New York, NY 10014",
  "street": "7 Carmine St",
  "city": "New York",
  "state": "NY",
  "postalCode": "10014",
  "countryCode": "US",
  "latitude": 40.7305,
  "longitude": -74.0022,
  "phone": "+1 212-366-1182",
  "website": "https://joespizzanyc.com",
  "category": "Pizza restaurant",
  "rating": 4.6,
  "reviewCount": 8234,
  "priceLevel": "$",
  "openingHours": [
    { "day": "Monday", "hours": "10 AM–4 AM" }
  ],
  "reviews": [
    {
      "reviewId": "...",
      "author": "Jane D.",
      "rating": 5,
      "text": "Best slice in NYC.",
      "publishedAt": "2 weeks ago"
    }
  ],
  "imageUrls": ["https://lh5.googleusercontent.com/..."],
  "qa": [
    {
      "question": "Is there outdoor seating?",
      "answer": "No, it's takeout only."
    }
  ],
  "popularTimes": [
    {
      "day": "Friday",
      "hours": [
        { "hour": 12, "occupancyPercent": 80, "timeLabel": "12 PM: Usually as busy as it gets" }
      ]
    }
  ],
  "scrapedAt": "2025-06-14T10:00:00.000Z"
}
```

***

### Notes

- **Proxies** — Google Maps aggressively blocks datacenter IPs. Residential proxies (Apify Residential group) are strongly recommended for production runs.
- **Selectors** — Google Maps frequently changes its DOM. If scraping breaks, selectors in `src/place-scraper.ts` and `src/search-handler.ts` may need updating.
- **Rate limiting** — `maxConcurrency` is set to 3 by default. Increase at your own risk.
- **Comparable actor** — Similar to `compass/crawler-google-places` on the Apify store.

# Actor input Schema

## `searchQueries` (type: `array`):

List of search terms to query on Google Maps (e.g. "restaurants in New York", "pizza Manhattan").

## `maxResultsPerQuery` (type: `integer`):

Maximum number of places to scrape per search query. Set to 0 for unlimited.

## `maxReviewsPerPlace` (type: `integer`):

Maximum number of reviews to scrape per place. Set to 0 to skip reviews.

## `maxPhotosPerPlace` (type: `integer`):

Maximum number of photo URLs to collect per place. Set to 0 to skip photos.

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

Language code for Google Maps results (e.g. "en", "de", "fr").

## `scrapeReviews` (type: `boolean`):

Whether to scrape reviews for each place.

## `scrapePhotos` (type: `boolean`):

Whether to collect photo URLs for each place.

## `scrapeQA` (type: `boolean`):

Whether to scrape the Q\&A section for each place.

## `scrapePopularTimes` (type: `boolean`):

Whether to scrape popular times data for each place.

## `proxyConfig` (type: `object`):

Apify proxy configuration. Residential proxies are strongly recommended for Google Maps.

## Actor input object example

```json
{
  "searchQueries": [
    "restaurants in New York"
  ],
  "maxResultsPerQuery": 20,
  "maxReviewsPerPlace": 10,
  "maxPhotosPerPlace": 10,
  "language": "en",
  "scrapeReviews": true,
  "scrapePhotos": true,
  "scrapeQA": true,
  "scrapePopularTimes": true,
  "proxyConfig": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 = {
    "searchQueries": [
        "restaurants in New York"
    ],
    "proxyConfig": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("pramodkonde17/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 = {
    "searchQueries": ["restaurants in New York"],
    "proxyConfig": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("pramodkonde17/google-maps-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "restaurants in New York"
  ],
  "proxyConfig": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call pramodkonde17/google-maps-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=pramodkonde17/google-maps-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Maps Scraper",
        "description": "Scrapes Google Maps for places matching search queries. Extracts full details: name, address, phone, website, rating, hours, reviews, photos, Q&A, and popular times.",
        "version": "0.1",
        "x-build-id": "U4CK6W35PR2AhyLrC"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/pramodkonde17~google-maps-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-pramodkonde17-google-maps-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/pramodkonde17~google-maps-scraper/runs": {
            "post": {
                "operationId": "runs-sync-pramodkonde17-google-maps-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/pramodkonde17~google-maps-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-pramodkonde17-google-maps-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "searchQueries"
                ],
                "properties": {
                    "searchQueries": {
                        "title": "Search queries",
                        "type": "array",
                        "description": "List of search terms to query on Google Maps (e.g. \"restaurants in New York\", \"pizza Manhattan\").",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxResultsPerQuery": {
                        "title": "Max results per query",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of places to scrape per search query. Set to 0 for unlimited.",
                        "default": 20
                    },
                    "maxReviewsPerPlace": {
                        "title": "Max reviews per place",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of reviews to scrape per place. Set to 0 to skip reviews.",
                        "default": 10
                    },
                    "maxPhotosPerPlace": {
                        "title": "Max photos per place",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of photo URLs to collect per place. Set to 0 to skip photos.",
                        "default": 10
                    },
                    "language": {
                        "title": "Language",
                        "type": "string",
                        "description": "Language code for Google Maps results (e.g. \"en\", \"de\", \"fr\").",
                        "default": "en"
                    },
                    "scrapeReviews": {
                        "title": "Scrape reviews",
                        "type": "boolean",
                        "description": "Whether to scrape reviews for each place.",
                        "default": true
                    },
                    "scrapePhotos": {
                        "title": "Scrape photo URLs",
                        "type": "boolean",
                        "description": "Whether to collect photo URLs for each place.",
                        "default": true
                    },
                    "scrapeQA": {
                        "title": "Scrape Q&A",
                        "type": "boolean",
                        "description": "Whether to scrape the Q&A section for each place.",
                        "default": true
                    },
                    "scrapePopularTimes": {
                        "title": "Scrape popular times",
                        "type": "boolean",
                        "description": "Whether to scrape popular times data for each place.",
                        "default": true
                    },
                    "proxyConfig": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Apify proxy configuration. Residential proxies are strongly recommended for Google Maps."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```