# Google Maps Reviews Scraper & Analyzer (`salem5077/google-reviews-analyzer`) Actor

Turn hundreds of Google Maps reviews into a clear report: satisfaction score, top praises, top complaints, rating trend, and highlight quotes.

- **URL**: https://apify.com/salem5077/google-reviews-analyzer.md
- **Developed by:** [ReviewLens](https://apify.com/salem5077) (community)
- **Categories:** AI, E-commerce, Lead generation
- **Stats:** 2 total users, 1 monthly users, 83.3% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## 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 Analyzer 📊

Stop reading hundreds of reviews one by one. Paste a Google Maps link and get a clear, instant report about any business.

### What you get

For every business you analyze, this tool produces:

- 📝 **Smart summary** — a clear, human-readable paragraph summarizing the business at a glance
- 🎯 **Aspect ratings** — separate scores for food & quality, service, price & value, atmosphere, wait & speed, and location
- 🧠 **Text sentiment** — sentiment read from the actual words of reviews (not just stars), catching nuance and sarcasm
- 💬 **Reputation management** — how often the owner replies to reviews (and to negative ones), plus average response time
- 💡 **Actionable recommendations** — a prioritized, plain-English to-do list of what to fix first
- 📄 **Printable PDF report** — a polished, shareable PDF with charts, aspect ratings, and recommendations (download link in `pdfReportUrl`)
- ⭐ **Overall rating & satisfaction score** — what % of customers are happy
- 📈 **Rating distribution** — how many 1★, 2★, 3★, 4★, 5★ reviews
- 👍 **Top praises** — the things customers love most (auto-detected from review text)
- 👎 **Top complaints** — the recurring problems customers mention
- 🕒 **Recent trend** — is the business improving or declining in the last 90 days?
- 📈 **Monthly trend** — average rating and review volume month by month (last 12 months)
- 💬 **Highlight quotes** — representative positive and negative reviews

Perfect for **business owners, restaurants, agencies, and market researchers** who want to understand customer feedback in seconds.

### How to use

You can start in two ways:

**Option 1 — by URL (most accurate):**
- `placeUrls`: paste one or more Google Maps links of the businesses.

**Option 2 — by search:**
- `searchTerm`: e.g. `coffee shop`
- `location`: e.g. `Los Angeles, USA`
- `maxPlaces`: how many matching businesses to analyze

Other options:
- `maxReviews`: how many reviews to analyze per business (default 50)
- `reviewsSort`: which reviews to pull first (newest / most relevant / highest / lowest)
- `reviewsSince`: only analyze recent reviews — a date (`2025-01-01`) or range (`3 months`, `1 year`)
- `reviewsKeyword`: only analyze reviews mentioning a word/phrase (e.g. `delivery`, `staff`)
- `language`: `en`, `es`, `fr`, etc.

#### Filters

Use `reviewsSince` to answer "what are customers saying lately?" and `reviewsKeyword` to drill into one topic (e.g. analyze only reviews that mention `delivery`).

#### Competitor comparison 🏆

Analyze **2 or more businesses** in one run (add several `placeUrls`, or raise `maxPlaces`) and you also get a comparison report: a ranking, who wins on each aspect (service, price, food, etc.), complaints shared across all of them, and a plain-English verdict. Perfect for "my business vs. my competitors".

### Example input

```json
{
  "placeUrls": ["https://www.google.com/maps/place/..."],
  "maxReviews": 200,
  "reviewsSort": "newest",
  "language": "en"
}
````

### Example output (per business)

```json
{
  "placeName": "Sample Coffee",
  "overallRating": 4.3,
  "reviewsAnalyzed": 200,
  "satisfactionScore": 81,
  "sentiment": { "positive": 162, "neutral": 18, "negative": 20 },
  "topPraises": [{ "theme": "great coffee", "mentions": 44 }],
  "topComplaints": [{ "theme": "slow service", "mentions": 12 }],
  "recentTrend": { "direction": "improving", "recentAvg": 4.5, "olderAvg": 4.1 }
}
```

### Notes

- Review data is fetched through Apify's trusted Google Maps Scraper, then analyzed by this tool.
- Sentiment is based on star ratings, so it works in any language. Themes are detected from review text with multilingual support.

# Actor input Schema

## `placeUrls` (type: `array`):

Paste one or more Google Maps URLs of the businesses you want to analyze. Either fill this OR use the Search term below.

## `searchTerm` (type: `string`):

Instead of URLs, search Google Maps by name, e.g. 'Starbucks' or 'pizza restaurant'. Use together with Location.

## `location` (type: `string`):

City + Country for the search term, e.g. 'Los Angeles, USA'.

## `maxPlaces` (type: `integer`):

How many businesses to analyze per search term.

## `maxReviews` (type: `integer`):

How many reviews to pull and analyze for each business. More reviews = deeper analysis but higher cost.

## `reviewsSort` (type: `string`):

Which reviews to prioritize when pulling them.

## `reviewsSince` (type: `string`):

Focus the analysis on recent feedback. Use an absolute date (e.g. 2025-01-01) or a relative range (e.g. '3 months', '1 year', '30 days'). Leave empty to analyze all reviews.

## `reviewsKeyword` (type: `string`):

Analyze only reviews that mention a specific word or phrase (e.g. 'delivery', 'parking', 'staff'). Great for digging into one topic. Leave empty to analyze all reviews.

## `compareMode` (type: `boolean`):

When you analyze 2 or more businesses, also produce a side-by-side comparison report (ranking, who wins each aspect, shared complaints, and a verdict). Add your business + competitors via the URLs or by raising 'Max places'.

## `generatePdf` (type: `boolean`):

Also create a polished, printable PDF report for each business (with charts, aspect ratings, and recommendations). A download link is added to each result as 'pdfReportUrl'.

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

Language for the scraped data (e.g. 'en' for English, 'es' for Spanish).

## Actor input object example

```json
{
  "placeUrls": [],
  "searchTerm": "restaurant",
  "location": "New York, USA",
  "maxPlaces": 1,
  "maxReviews": 50,
  "reviewsSort": "newest",
  "compareMode": true,
  "generatePdf": true,
  "language": "en"
}
```

# Actor output Schema

## `analysis` (type: `string`):

The full analysis report for each business, plus a competitor comparison when 2 or more are analyzed.

## `pdfReports` (type: `string`):

Printable PDF analysis report for each analyzed business.

# 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 = {
    "placeUrls": [],
    "searchTerm": "restaurant",
    "location": "New York, USA",
    "maxReviews": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("salem5077/google-reviews-analyzer").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 = {
    "placeUrls": [],
    "searchTerm": "restaurant",
    "location": "New York, USA",
    "maxReviews": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("salem5077/google-reviews-analyzer").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 '{
  "placeUrls": [],
  "searchTerm": "restaurant",
  "location": "New York, USA",
  "maxReviews": 50
}' |
apify call salem5077/google-reviews-analyzer --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Maps Reviews Scraper & Analyzer",
        "description": "Turn hundreds of Google Maps reviews into a clear report: satisfaction score, top praises, top complaints, rating trend, and highlight quotes.",
        "version": "0.1",
        "x-build-id": "66N1HBnZNNZCsWvLT"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/salem5077~google-reviews-analyzer/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-salem5077-google-reviews-analyzer",
                "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/salem5077~google-reviews-analyzer/runs": {
            "post": {
                "operationId": "runs-sync-salem5077-google-reviews-analyzer",
                "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/salem5077~google-reviews-analyzer/run-sync": {
            "post": {
                "operationId": "run-sync-salem5077-google-reviews-analyzer",
                "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": {
                    "placeUrls": {
                        "title": "Google Maps place URL(s)",
                        "type": "array",
                        "description": "Paste one or more Google Maps URLs of the businesses you want to analyze. Either fill this OR use the Search term below.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "searchTerm": {
                        "title": "Search term (optional)",
                        "type": "string",
                        "description": "Instead of URLs, search Google Maps by name, e.g. 'Starbucks' or 'pizza restaurant'. Use together with Location."
                    },
                    "location": {
                        "title": "Location (optional)",
                        "type": "string",
                        "description": "City + Country for the search term, e.g. 'Los Angeles, USA'."
                    },
                    "maxPlaces": {
                        "title": "Max places to analyze",
                        "minimum": 1,
                        "maximum": 50,
                        "type": "integer",
                        "description": "How many businesses to analyze per search term.",
                        "default": 1
                    },
                    "maxReviews": {
                        "title": "Reviews to analyze per place",
                        "minimum": 10,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "How many reviews to pull and analyze for each business. More reviews = deeper analysis but higher cost.",
                        "default": 50
                    },
                    "reviewsSort": {
                        "title": "Reviews order",
                        "enum": [
                            "newest",
                            "mostRelevant",
                            "highestRanking",
                            "lowestRanking"
                        ],
                        "type": "string",
                        "description": "Which reviews to prioritize when pulling them.",
                        "default": "newest"
                    },
                    "reviewsSince": {
                        "title": "Only analyze reviews since (optional)",
                        "type": "string",
                        "description": "Focus the analysis on recent feedback. Use an absolute date (e.g. 2025-01-01) or a relative range (e.g. '3 months', '1 year', '30 days'). Leave empty to analyze all reviews."
                    },
                    "reviewsKeyword": {
                        "title": "Only analyze reviews containing keyword (optional)",
                        "type": "string",
                        "description": "Analyze only reviews that mention a specific word or phrase (e.g. 'delivery', 'parking', 'staff'). Great for digging into one topic. Leave empty to analyze all reviews."
                    },
                    "compareMode": {
                        "title": "Competitor comparison",
                        "type": "boolean",
                        "description": "When you analyze 2 or more businesses, also produce a side-by-side comparison report (ranking, who wins each aspect, shared complaints, and a verdict). Add your business + competitors via the URLs or by raising 'Max places'.",
                        "default": true
                    },
                    "generatePdf": {
                        "title": "Generate PDF report",
                        "type": "boolean",
                        "description": "Also create a polished, printable PDF report for each business (with charts, aspect ratings, and recommendations). A download link is added to each result as 'pdfReportUrl'.",
                        "default": true
                    },
                    "language": {
                        "title": "Language",
                        "type": "string",
                        "description": "Language for the scraped data (e.g. 'en' for English, 'es' for Spanish).",
                        "default": "en"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```