Google Maps Reviews Scraper

This actor allows you to scrape Google Maps reviews for a specific business. It automatically handles pagination and can collect up to the specified number of reviews.

Features

• Automatic pagination handling
• Configurable maximum number of reviews
• Multiple sorting options
• Language and country filtering
• Rate limiting protection
• Real-time data collection

Input Parameters

• business_id (required): The unique identifier of the business
• maxItems (optional, default: 20): Maximum number of reviews to scrape
• country (optional): Country code to limit the search results
• lang (optional): Language code for the results
• sort (optional, default: 'Relevant'): Sort order for reviews ('Relevant', 'Newest', 'Highest', 'Lowest')
• place_id (optional): Google Maps place ID

Output Data

The actor outputs an array of Google Maps reviews, where each review contains:

• user_name: Name of the reviewer
• user_total_reviews: Total number of reviews by the user
• user_total_photos: Total number of photos by the user
• user_avatar: URL of the user's avatar
• user_link: Link to the user's profile
• review_id: Unique identifier for the review
• review_time: Relative time of the review
• review_timestamp: Timestamp of the review
• review_link: Link to the review
• review_text: Text content of the review
• review_photos: Array of photos attached to the review
• business_response_text: Response from the business owner
• review_services: Service ratings (Food, Service, Atmosphere)
• owner_answer: Business owner's reply
• translations: Translated versions of the review
• review_rate: Rating given by the reviewer
• review_cursor: Cursor for pagination
• scrapedAt: Timestamp of when the data was scraped

Usage Example

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

Output Example

[
  {
    "user_name": "ionut.m m",
    "user_total_reviews": 1,
    "user_total_photos": 0,
    "user_avatar": "https://lh3.googleusercontent.com/a-/ALV-UjWOkAwIcsDTG9Sm_yDMSZvxLydz-go3_5b4jfwiyi8xyeK8-Isz=s120-c-rp-mo-br100",
    "user_link": "https://www.google.com/maps/contrib/113274872929229613721?hl=en",
    "review_id": "ChZDSUhNMG9nS0VLM3JoWl9IMGRtR2ZnEAE",
    "review_time": "5 hours ago",
    "review_timestamp": 1748712993496872,
    "review_link": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sChZDSUhNMG9nS0VLM3JoWl9IMGRtR2ZnEAE!2m1!1s0x0:0x7bb3bc00dfc039a9!3m1!1s2@1:CIHM0ogKEK3rhZ_H0dmGfg%7CCgwIofzswQYQwNT27AE%7C?hl=en",
    "review_text": null,
    "review_photos": [],
    "business_response_text": null,
    "review_services": {
      "Price per person": "€30–40",
      "Food": 5,
      "Service": 5,
      "Atmosphere": 5,
      "Noise level": "Moderate noise",
      "Group size": "5-8 people",
      "Wait time": "Up to 10 min"
    },
    "translations": [],
    "review_rate": 5,
    "review_cursor": "CAESYENBRVFBUnBDUTJrNFNVRlNTVzVEWjI5QlVEY3lSMnBaYkZVd2JsOWZSV2hEZDIxQ01qbElUemhFYUc5b2RqUktPRUZCUVVGQlIyZG1YMEZ0YWxsc1ZUQnVSMEZCYVVGQg==",
    "scrapedAt": "2025-05-31T23:06:12.988Z"
  },
  ...
]