# Fastest Google Maps Reviews Scraper With Images & Videos (`veeronica/fastest-google-maps-reviews-scraper-with-images-videos`) Actor
Scrape every review of any business on Google Maps: star rating, full text, reviewer name and profile, owner responses, review photos, videos and dates. Paste a Maps URL or place ID, choose how to sort, and export clean JSON.
- **URL**: https://apify.com/veeronica/fastest-google-maps-reviews-scraper-with-images-videos.md
- **Developed by:** [Veronica](https://apify.com/veeronica) (community)
- **Categories:** Lead generation, E-commerce, SEO tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.25 / 1,000 reviews
This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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 Reviews Scraper
Google Maps Reviews Scraper **extracts every review of any business on Google Maps** — star rating, full text, reviewer profile, owner responses, photos, and dates — and downloads them as **JSON, CSV, Excel, or XML**. It runs in the cloud, needs no coding, and no Google API key.
Try it right away: paste a Google Maps place URL into the input form, click **Start**, and watch the dataset fill up with structured review data.
### What data does it extract?
Each result is **one review**, with the business it belongs to nested in a `place` object:
| Data | Details |
|---|---|
| 💬 **Review** | full text, original-language text, translated text, star rating, like count, source |
| 🗓️ **Dates** | when the review was published and last edited (ISO 8601) |
| 👤 **Reviewer** | nested `reviewer` object: name, profile URL, photo, ID, total reviews written, Local Guide status |
| 🏢 **Owner response** | the business's reply text and date, when present |
| 📷 **Photos & videos** | every image and video attached to the review — playable video URLs, image URLs, and dimensions |
| 📍 **Place** | nested `place` object: name, address, category, coordinates, overall rating, total review count, place ID, URL |
### How do I scrape Google Maps reviews?
1. **Add a place** — paste one or more Google Maps URLs (`google.com/maps/place/…`, or short `maps.app.goo.gl` links). You can also supply place IDs directly.
2. **Choose how many** — set *Maximum reviews per place*, or use `0` to scrape all of them.
3. **Pick a sort order** — Newest, Most relevant, Highest rating, or Lowest rating.
4. **Filter the content** *(optional)* — keep all reviews, only those with text, or only those with text and media (photos/videos).
5. **Click Start** — then download the results from the **Storage** tab in any format, or send them anywhere using integrations.
### How do I find a place's URL?
Open [Google Maps](https://www.google.com/maps), search for the business, click it, and copy the URL from your browser's address bar. Each URL contains the place's ID (the `0x…:0x…` value), which is what the scraper uses.
### Input example
```json
{
"startUrls": [
{ "url": "https://www.google.com/maps/place/Katz's+Delicatessen/@40.722233,-73.987429,17z/data=!4m6!3m5!1s0x89c2598f7ff4aa09:0x313547e757cb8cea!8m2!3d40.722233!4d-73.987429" }
],
"maxReviews": 100,
"reviewsSort": "newest",
"language": "en",
"personalData": true
}
````
You can also target places by ID instead of URL:
```json
{
"placeIds": ["0x89c2598f7ff4aa09:0x313547e757cb8cea"],
"maxReviews": 0
}
```
### Output example (abridged)
```json
{
"place": {
"placeId": "0x89c2598f7ff4aa09:0x313547e757cb8cea",
"title": "Katz's Delicatessen",
"address": "205 E Houston St, New York, NY 10002, United States",
"categoryName": "Deli",
"categories": ["Deli"],
"location": { "lat": 40.722233, "lng": -73.987429 },
"totalScore": 4.5,
"reviewsCount": 53374,
"url": "https://www.google.com/maps/place/…"
},
"reviewId": "Ci9DQUlRQUNvZ…",
"reviewer": {
"id": "1002…",
"name": "Jane D.",
"url": "https://www.google.com/maps/contrib/1002…",
"photoUrl": "https://lh3.googleusercontent.com/…",
"numberOfReviews": 197,
"isLocalGuide": true
},
"stars": 5,
"text": "Best pastrami in NYC. The line moves fast and the portions are huge.",
"textTranslated": null,
"originalLanguage": "en",
"publishedAtDate": "2026-02-04T05:28:13.519Z",
"lastEditedAtDate": "2026-02-04T05:28:13.519Z",
"reviewImageUrls": ["https://lh3.googleusercontent.com/…"],
"reviewVideoUrls": ["https://lh3.googleusercontent.com/…"],
"reviewMedia": [
{ "type": "video", "url": "https://…", "thumbnailUrl": "https://…", "width": 1920, "height": 864, "caption": null }
],
"responseFromOwnerText": null,
"responseFromOwnerDate": null
}
```
### Input reference
| Field | Type | Description |
|---|---|---|
| `startUrls` | array | Google Maps place URLs to scrape. One business per URL. |
| `placeIds` | array | Place feature IDs (`0x…:0x…`) — an alternative to full URLs. |
| `maxReviews` | integer | Reviews per place. `0` = all available. Default `100`. Counts only reviews kept after filtering. |
| `reviewsSort` | string | `newest`, `mostRelevant`, `highestRanking`, or `lowestRanking`. Default `newest`. |
| `reviewsContentFilter` | string | `all`, `textOnly` (has text), or `textAndMedia` (has text + at least one photo/video). Default `all`. |
| `searchQuery` | string | Keyword/phrase to search reviews for (e.g. `delivery`). Only matching reviews are fetched. Leave empty for all. |
| `language` | string | UI/output language code, e.g. `en`, `fr`, `de`, `es`. Default `en`. |
| `personalData` | boolean | Include reviewer name, profile, photo, and review URL. Default `true`. |
### Why scrape Google Maps reviews?
- **Reputation monitoring** — track what customers say about your locations over time.
- **Competitor analysis** — benchmark ratings and sentiment against nearby businesses.
- **Customer insight** — mine review text for recurring praise and complaints.
- **Lead generation & research** — gather reviewer and business data at scale.
### Pricing
This Actor uses **pay-per-event** pricing: a small fee when a run starts, plus a fee per review delivered. You only pay for the reviews you actually receive — set *Maximum reviews per place* to control your spend.
### Notes
- The Actor routes through Apify Proxy automatically for reliable scraping — no proxy setup needed on your end.
- Reviewer personal data is publicly visible on Google Maps. Make sure your use complies with Google's terms and applicable data-protection laws (e.g. GDPR). Turn off *Include reviewer personal data* if you don't need it.
# Actor input Schema
## `startUrls` (type: `array`):
Links to the businesses you want reviews from. Paste the full Google Maps link from your browser's address bar — short maps.app.goo.gl links work too. One business per link.
## `placeIds` (type: `array`):
Optional — most users can leave this empty and just paste links above. If you already have Google Maps place IDs (the 0x…:0x… code found in a Maps link), add them here, one per line, to skip pasting full URLs.
## `maxReviews` (type: `integer`):
How many reviews to scrape for each business (according to the chosen sort order). Use 0 to scrape all available reviews.
## `reviewsSort` (type: `string`):
Order in which reviews are fetched. Most relevant is Google's default ordering (content-rich reviews first, star-only ratings last); Newest returns the most recent first.
## `reviewsContentFilter` (type: `string`):
Which reviews to return. All keeps every review (including star-only ratings). Only with text keeps reviews that have written text. Only with text and media keeps reviews that have text and at least one photo or video.
## `searchQuery` (type: `string`):
Return only reviews that mention this keyword or phrase (e.g. delivery, parking, or a dish name). Leave empty to fetch all reviews. Combine with the sort order and content filter to narrow results further.
## `language` (type: `string`):
Language for the review text, e.g. en, fr, de, es. Reviews written in another language are automatically translated into this language, and the original wording is kept too.
## `personalData` (type: `boolean`):
Include reviewer details (name, profile URL, profile photo, reviewer ID) and the direct review URL. Turn off to exclude personal data from the output.
## Actor input object example
```json
{
"startUrls": [
{
"url": "https://www.google.com/maps/place/Statue+of+Liberty+National+Monument/@40.6892494,-74.0466891,17z/data=!3m1!4b1!4m6!3m5!1s0x89c25090129c363d:0x40c6a5770d25022b!8m2!3d40.6892494!4d-74.0445142!16zL20vMDdiZ3M"
}
],
"maxReviews": 100,
"reviewsSort": "mostRelevant",
"reviewsContentFilter": "all",
"language": "en",
"personalData": true
}
```
# Actor output Schema
## `reviews` (type: `string`):
One row per review.
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"startUrls": [
{
"url": "https://www.google.com/maps/place/Statue+of+Liberty+National+Monument/@40.6892494,-74.0466891,17z/data=!3m1!4b1!4m6!3m5!1s0x89c25090129c363d:0x40c6a5770d25022b!8m2!3d40.6892494!4d-74.0445142!16zL20vMDdiZ3M"
}
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("veeronica/fastest-google-maps-reviews-scraper-with-images-videos").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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "startUrls": [{ "url": "https://www.google.com/maps/place/Statue+of+Liberty+National+Monument/@40.6892494,-74.0466891,17z/data=!3m1!4b1!4m6!3m5!1s0x89c25090129c363d:0x40c6a5770d25022b!8m2!3d40.6892494!4d-74.0445142!16zL20vMDdiZ3M" }] }
# Run the Actor and wait for it to finish
run = client.actor("veeronica/fastest-google-maps-reviews-scraper-with-images-videos").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 '{
"startUrls": [
{
"url": "https://www.google.com/maps/place/Statue+of+Liberty+National+Monument/@40.6892494,-74.0466891,17z/data=!3m1!4b1!4m6!3m5!1s0x89c25090129c363d:0x40c6a5770d25022b!8m2!3d40.6892494!4d-74.0445142!16zL20vMDdiZ3M"
}
]
}' |
apify call veeronica/fastest-google-maps-reviews-scraper-with-images-videos --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=veeronica/fastest-google-maps-reviews-scraper-with-images-videos",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Fastest Google Maps Reviews Scraper With Images & Videos",
"description": "Scrape every review of any business on Google Maps: star rating, full text, reviewer name and profile, owner responses, review photos, videos and dates. Paste a Maps URL or place ID, choose how to sort, and export clean JSON.",
"version": "1.0",
"x-build-id": "LjXzhpdqax5cV9RzO"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/veeronica~fastest-google-maps-reviews-scraper-with-images-videos/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-veeronica-fastest-google-maps-reviews-scraper-with-images-videos",
"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/veeronica~fastest-google-maps-reviews-scraper-with-images-videos/runs": {
"post": {
"operationId": "runs-sync-veeronica-fastest-google-maps-reviews-scraper-with-images-videos",
"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/veeronica~fastest-google-maps-reviews-scraper-with-images-videos/run-sync": {
"post": {
"operationId": "run-sync-veeronica-fastest-google-maps-reviews-scraper-with-images-videos",
"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",
"properties": {
"startUrls": {
"title": "Google Maps URLs",
"type": "array",
"description": "Links to the businesses you want reviews from. Paste the full Google Maps link from your browser's address bar — short maps.app.goo.gl links work too. One business per link.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"placeIds": {
"title": "Place IDs (advanced)",
"type": "array",
"description": "Optional — most users can leave this empty and just paste links above. If you already have Google Maps place IDs (the 0x…:0x… code found in a Maps link), add them here, one per line, to skip pasting full URLs.",
"items": {
"type": "string"
}
},
"maxReviews": {
"title": "Maximum reviews per place",
"minimum": 0,
"type": "integer",
"description": "How many reviews to scrape for each business (according to the chosen sort order). Use 0 to scrape all available reviews.",
"default": 100
},
"reviewsSort": {
"title": "Sort reviews by",
"enum": [
"mostRelevant",
"newest",
"highestRanking",
"lowestRanking"
],
"type": "string",
"description": "Order in which reviews are fetched. Most relevant is Google's default ordering (content-rich reviews first, star-only ratings last); Newest returns the most recent first.",
"default": "mostRelevant"
},
"reviewsContentFilter": {
"title": "Review content filter",
"enum": [
"all",
"textOnly",
"textAndMedia"
],
"type": "string",
"description": "Which reviews to return. All keeps every review (including star-only ratings). Only with text keeps reviews that have written text. Only with text and media keeps reviews that have text and at least one photo or video.",
"default": "all"
},
"searchQuery": {
"title": "Search reviews for a keyword",
"type": "string",
"description": "Return only reviews that mention this keyword or phrase (e.g. delivery, parking, or a dish name). Leave empty to fetch all reviews. Combine with the sort order and content filter to narrow results further."
},
"language": {
"title": "Translate to",
"type": "string",
"description": "Language for the review text, e.g. en, fr, de, es. Reviews written in another language are automatically translated into this language, and the original wording is kept too.",
"default": "en"
},
"personalData": {
"title": "Include reviewer personal data",
"type": "boolean",
"description": "Include reviewer details (name, profile URL, profile photo, reviewer ID) and the direct review URL. Turn off to exclude personal data from the output.",
"default": true
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```