Google Play Store Reviews Scraper

An Apify actor that scrapes reviews from Google Play Store apps. Extract comprehensive review data including ratings, reviewer information, review text, dates, and metadata.

Features

• ⚡ Lightning Fast: Get thousands of reviews in seconds
• 🔄 No Proxy Required: We handle proxy rotation automatically - no setup needed!
• 🔍 Flexible Input: Accepts app package name or full Google Play Store URL
• ⭐ Rich Data: Extracts ratings, reviewer names, review text, dates, languages, and helpful vote counts
• 🎯 Advanced Filtering: Filter by star ratings, keywords, date ranges, and more
• 📄 Pagination Support: Automatically handles pagination to get all available reviews
• 🚀 High Performance: Optimized for speed and reliability with retry logic

Input Parameters

Parameter	Type	Default	Description
appIdOrUrl	String	Required	App package name (e.g., 'com.supercell.brawlstars') or full Google Play Store URL
startPage	Integer	1	Page number to start scraping from
pagesToScrape	Integer	5	Maximum number of pages to scrape (-1 for all available)
reviewsPerPage	Integer	100	Number of reviews per page; with startPage and pagesToScrape it selects which part of the review list you get
maxReviews	Integer	10000	Maximum number of reviews to scrape (-1 for no limit)
sortBy	String	"mostRelevant"	Sort reviews by "mostRelevant", "newest" or "rating"
ratingFilter	Array	all	Filter reviews by star ratings (1-5)
keywords	Array	[]	Filter reviews containing specific keywords
endDate	String	null	Only include reviews posted before this date (YYYY-MM-DD format)
recentDays	Integer	0	Only include reviews from the last N days (0 = disabled)
uniqueOnly	Boolean	true	Remove duplicate reviews (by review ID)

Output Data

Each review contains the following fields:

Field	Type	Description
reviewId	String	Unique review identifier
rating	Integer	Star rating (1-5)
reviewer	String	Name of the reviewer
date	String	Review date in ISO format (YYYY-MM-DD)
body	String	Full text content of the review
language	String	Language code of the review
userImage	String	URL to reviewer's profile image
helpfulCounts	Integer	Number of helpful votes the review received
appId	String	App package name
timestamp	Integer	Unix timestamp of the review
position	Integer	Position/order of review in the results

Usage Examples

Basic Usage

{
  "appIdOrUrl": "https://play.google.com/store/apps/details?id=com.supercell.brawlstars",
  "maxReviews": 10000,
  "reviewsPerPage": 100,
  "pagesToScrape": 10
}

Advanced Filtering

{
  "appIdOrUrl": "com.supercell.brawlstars",
  "ratingFilter": [4, 5],
  "keywords": ["great", "amazing", "fun"],
  "recentDays": 30,
  "maxReviews": 100,
  "sortBy": "newest"
}

Package Name Only

{
  "appIdOrUrl": "com.supercell.brawlstars",
  "pagesToScrape": 5,
  "sortBy": "mostRelevant"
}

How to Get App Package Name

You can provide either:

1. Full Google Play Store URL:

   https://play.google.com/store/apps/details?id=com.supercell.brawlstars
   

2. Package name only:

   com.supercell.brawlstars
   

The package name is the string after id= in the Google Play Store URL.

Rate Limiting & Best Practices

• The scraper includes built-in delays between requests to respect Google Play Store's servers
• Proxy is handled by us!
• Non-paying Apify users are limited to 5 total runs and 500 total reviews across all runs.
• The free-user run quota is consumed when a scrape starts, even if the run returns zero matching reviews.
• Once either free-tier quota is exhausted, the Actor exits cleanly with a terminal status message.

Common Use Cases

• Market Research: Analyze user sentiment and feedback for mobile apps
• Competitive Analysis: Compare reviews across similar apps
• Product Development: Identify common issues and feature requests
• Content Moderation: Monitor reviews for specific keywords or patterns
• Trend Analysis: Track review patterns over time

Error Handling

The actor includes comprehensive error handling:

• Invalid package names or URLs are detected and reported
• An app that does not exist on Google Play fails the run with a clear message (nothing is charged)
• An app with no reviews in the requested language succeeds with 0 reviews and a status message saying so
• Network timeouts, refusals and rate limiting are retried on a fresh connection
• If Google Play stops answering partway through, the reviews already saved are kept and the status message says the results may be incomplete

Performance Notes

• Reviews are fetched up to 1000 at a time, whatever reviewsPerPage is, so large runs need few requests
• With sortBy: "newest" and recentDays, the run stops as soon as it reaches reviews older than the window
• Reviews are saved as they arrive, so memory use stays flat however many reviews a run collects

Support

For issues, feature requests, or questions:

1. Check the actor run logs for detailed error messages
2. Verify the app package name or URL is correct
3. Try with smaller batch sizes if encountering timeouts
4. Contact support through the Apify platform