Google Maps Reviews Scraper

This actor scrapes reviews for a specific business from Google Maps. It handles pagination automatically and collects structured review data based on your configuration.

Key Features

• Automatic Pagination: Scrapes multiple pages of reviews without manual intervention.
• Configurable Limits: Set the maximum number of reviews to collect (maxItems).
• Sorting & Filtering: Sort reviews by 'Relevant', 'Newest', 'Highest', or 'Lowest' rating. Optionally filter by country and language.
• Rate Limit Handling: Built-in logic to help avoid being blocked by Google.
• Real-time Data: Fetches current reviews directly from Google Maps.

How to Use

Provide the actor with a JSON input containing the target business identifier and your desired parameters.

Example Input:

{
  "business_id": "0x47f4ea8ed352d3c5:0x7bb3bc00dfc039a9",
  "maxItems": 30,
  "country": "us",
  "lang": "en",
  "sort": "Newest"
}

Input Parameters

• business_id (Required): The unique identifier for the business.
• maxItems (Optional, Default: 20): Maximum number of reviews to scrape.
• sort (Optional, Default: 'Relevant'): Sort order. Options: 'Relevant', 'Newest', 'Highest', 'Lowest'.
• country (Optional): Two-letter country code (e.g., 'us') to limit results.
• lang (Optional): Language code (e.g., 'en') for the review text.
• place_id (Optional): An alternative business identifier using Google's Place ID.

Output Data

The actor outputs a JSON array of review objects. Each object contains the following key fields:

• Reviewer Info: user_name, user_total_reviews, user_avatar, user_link.
• Review Content: review_text, review_rate (1-5), review_time, review_timestamp.
• Review Metadata: review_id, review_link, review_photos (array), review_cursor (for pagination).
• Business Interaction: business_response_text, owner_answer.
• Service Details: review_services (an object containing ratings like Food, Service, Atmosphere).
• Technical: scrapedAt (timestamp of collection).

Output Snippet:

[
  {
    "user_name": "ionut.m m",
    "user_total_reviews": 1,
    "review_rate": 5,
    "review_time": "5 hours ago",
    "review_text": "Great experience!",
    "review_services": {
      "Food": 5,
      "Service": 5,
      "Atmosphere": 5
    },
    "scrapedAt": "2025-05-31T23:06:12.988Z"
  }
]