# Review Extractor Google Map (`happitap/review-extractor-google-map`) Actor

Google Maps Reviews Scraper - Professional Edition
Extract comprehensive review data from any Google Maps place  (mechanism for 10x faster results.)
Start extracting valuable review insights today! Try it free and see why businesses and researchers trust our scraper for reliable Google Maps data.

- **URL**: https://apify.com/happitap/review-extractor-google-map.md
- **Developed by:** [HappiTap](https://apify.com/happitap) (community)
- **Categories:** Automation, Developer tools, Other
- **Features:** Limited permissions
- **Stats:** 67 total users, 3 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$0.50 / 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/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 Reviews Scraper

Extract **reviews** from any Google Maps place page. Get detailed review data including ratings, reviewer names, review text, dates, likes, and owner responses. Perfect for sentiment analysis, reputation management, and customer feedback analysis.

***

### 🧠 What it does

This actor scrapes reviews from a specific Google Maps place URL and extracts comprehensive review data including reviewer information, ratings, review text, dates, and more.

***

### ✅ Use cases

- **Sentiment Analysis**: Analyze customer feedback and opinions
- **Reputation Management**: Monitor and respond to customer reviews
- **Competitive Intelligence**: Compare reviews across competitors
- **Market Research**: Understand customer preferences and pain points
- **Business Intelligence**: Track review trends over time

***

### 📥 Input

Provide the following input fields:

```json
{
  "placeUrl": "https://www.google.com/maps/place/Taj+Mahal/@27.1751496,78.0399535,17z/",
  "maxReviews": 100,
  "sortBy": "newest"
}
```

#### Input Parameters

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `placeUrl` | `string` | ✅ Yes | Google Maps place URL (must contain `/maps/place/`) |
| `maxReviews` | `integer` | No | Maximum number of reviews to scrape (default: 100, max: 5000). Cached reviews are automatically used when available. |
| `sortBy` | `string` | No | Sort order: `newest`, `highest`, `lowest`, or `relevant` (default: `newest`) |

> **💡 Smart Caching**: This actor automatically caches reviews to avoid re-scraping. If you've already scraped reviews from a place, subsequent runs will be much faster!

#### How to get the Place URL

1. Open Google Maps in your browser
2. Search for any place (restaurant, hotel, attraction, etc.)
3. Click on the place to open its details
4. Copy the URL from your browser's address bar
5. Paste it into the `placeUrl` input field

***

### 📤 Output

The actor saves structured review data into the default dataset.

#### Sample Output

```json
{
  "placeName": "Taj Mahal",
  "placeRating": "4.6",
  "placeTotalReviews": 125847,
  "placeUrl": "https://www.google.com/maps/place/Taj+Mahal/@27.1751496,78.0399535,17z/",
  "reviewId": "ChZDSUhNMG9nS0VJQ0FnSURGN...",
  "reviewUrl": "https://www.google.com/maps/reviews/ChZDSUhNMG9nS0VJQ0FnSURGN...",
  "reviewText": "Absolutely stunning monument! A must-visit when in India. The architecture is breathtaking and the history is fascinating.",
  "publishedDate": "2 weeks ago",
  "rating": 5,
  "likes": 42,
  "reviewImages": [
    "https://lh5.googleusercontent.com/p/AF1QipM...",
    "https://lh5.googleusercontent.com/p/AF1QipN..."
  ],
  "reviewContext": "Visited with family",
  "detailedRatings": {
    "Service": 5,
    "Atmosphere": 5
  },
  "ownerResponseText": "Thank you for visiting! We're glad you enjoyed your experience.",
  "reviewerName": "John Doe",
  "reviewerId": "112345678901234567890",
  "reviewerUrl": "https://www.google.com/maps/contrib/112345678901234567890",
  "reviewerPhoto": "https://lh3.googleusercontent.com/a-/ALV...",
  "reviewerReviewCount": 156,
  "isLocalGuide": true,
  "scrapedAt": "2025-10-03T09:35:26.123Z"
}
```

#### 📄 Output Fields Explained

| Field | Type | Description |
|-------|------|-------------|
| **Place Information** |
| `placeName` | `string` | Name of the place/business |
| `placeRating` | `string` | Overall rating of the place |
| `placeTotalReviews` | `number` | Total number of reviews for this place |
| `placeUrl` | `string` | Google Maps URL of the place |
| **Review Information** |
| `reviewId` | `string` | 🆔 Unique identifier for the review |
| `reviewUrl` | `string` | 🆔 Direct URL to the review |
| `reviewText` | `string` | 📝 Full text of the review |
| `publishedDate` | `string` | 📅 When the review was posted (relative time) |
| `rating` | `number` | 🌟 Rating given by this reviewer (1-5 stars) |
| `likes` | `number` | Number of likes/helpful votes on the review |
| `reviewImages` | `array` | 📷 List of image URLs attached to the review |
| `reviewContext` | `string` | 💬 Context of the visit (e.g., "Dine in", "Takeout") |
| `detailedRatings` | `object` | 📊 Detailed ratings per service (e.g., Food: 5, Service: 4) |
| **Owner Response** |
| `ownerResponseText` | `string` | ✅ Response from the business owner (if any) |
| **Reviewer Information** |
| `reviewerName` | `string` | 🧛 Name of the reviewer |
| `reviewerId` | `string` | 🆔 Unique identifier for the reviewer |
| `reviewerUrl` | `string` | 🆔 Profile URL of the reviewer |
| `reviewerPhoto` | `string` | 🖼 Profile image URL of the reviewer |
| `reviewerReviewCount` | `number` | ✍️ Total number of reviews by this reviewer |
| `isLocalGuide` | `boolean` | 👋 Whether the reviewer is a Local Guide |
| **Metadata** |
| `scrapedAt` | `string` | ISO timestamp of when the data was scraped |
-----------------------------------------------------------------------

### 🚀 How to Use

#### On Apify Platform

1. Go to [Apify Console](https://console.apify.com)
2. Click **"Try Actor"** or create a Task
3. Enter your input:
   ```json
   {
     "placeUrl": "https://www.google.com/maps/place/Taj+Mahal/@27.1751496,78.0399535,17z/",
     "maxReviews": 100,
     "sortBy": "newest"
   }
   ```
4. Run the Actor
5. Download your results in **JSON**, **CSV**, or **Excel** formats

> **⚡ Performance Tip**: The actor automatically caches reviews. Re-running for the same place will be significantly faster!

***

### 🤝 Support

If you encounter any issues or have questions, please open an issue on GitHub or contact support.

# Actor input Schema

## `placeUrl` (type: `string`):

Enter the Google Maps URL of the place from which you want to extract reviews. Example: https://www.google.com/maps/place/...

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

Maximum number of reviews to scrape (default: 100). Note: Cached reviews are automatically used when available for faster results.

## `sortBy` (type: `string`):

How to sort the reviews

## Actor input object example

```json
{
  "placeUrl": "https://www.google.com/maps/place/Taj+Mahal,+Dharmapuri,+Forest+Colony,+Tajganj,+Agra,+Uttar+Pradesh+282001/@27.1751496,78.0421422,17z/data=!3m1!4b1!4m6!3m5!1s0x39747121d702ff6d:0xdd2ae4803f767dde!8m2!3d27.1751448!4d78.0421422!16zL20vMGo1ajE?entry=ttu",
  "maxReviews": 100,
  "sortBy": "newest"
}
```

# Actor output Schema

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

Extracted data items stored in the default dataset.

# 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 = {
    "placeUrl": "https://www.google.com/maps/place/Taj+Mahal,+Dharmapuri,+Forest+Colony,+Tajganj,+Agra,+Uttar+Pradesh+282001/@27.1751496,78.0421422,17z/data=!3m1!4b1!4m6!3m5!1s0x39747121d702ff6d:0xdd2ae4803f767dde!8m2!3d27.1751448!4d78.0421422!16zL20vMGo1ajE?entry=ttu"
};

// Run the Actor and wait for it to finish
const run = await client.actor("happitap/review-extractor-google-map").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 = { "placeUrl": "https://www.google.com/maps/place/Taj+Mahal,+Dharmapuri,+Forest+Colony,+Tajganj,+Agra,+Uttar+Pradesh+282001/@27.1751496,78.0421422,17z/data=!3m1!4b1!4m6!3m5!1s0x39747121d702ff6d:0xdd2ae4803f767dde!8m2!3d27.1751448!4d78.0421422!16zL20vMGo1ajE?entry=ttu" }

# Run the Actor and wait for it to finish
run = client.actor("happitap/review-extractor-google-map").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 '{
  "placeUrl": "https://www.google.com/maps/place/Taj+Mahal,+Dharmapuri,+Forest+Colony,+Tajganj,+Agra,+Uttar+Pradesh+282001/@27.1751496,78.0421422,17z/data=!3m1!4b1!4m6!3m5!1s0x39747121d702ff6d:0xdd2ae4803f767dde!8m2!3d27.1751448!4d78.0421422!16zL20vMGo1ajE?entry=ttu"
}' |
apify call happitap/review-extractor-google-map --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,happitap/review-extractor-google-map"
        }
    }
}
```

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/iFlJUbwrdCCojoJFP/builds/fqxfP7POByEVQZgJz/openapi.json
