# Google Play Reviews Scraper (`automation-lab/google-play-reviews-scraper`) Actor 📱 Extract public Google Play reviews with ratings, dates, app versions, helpful votes, developer replies, and app metadata for ASO. - **URL**: https://apify.com/automation-lab/google-play-reviews-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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 Play Reviews Scraper Extract public Google Play reviews for Android apps, including ratings, review text, dates, app versions, helpful votes, developer replies, and app metadata. The actor is built for ASO teams, product managers, growth teams, agencies, and developers who need structured review data without manually copying Google Play pages. ### What does Google Play Reviews Scraper do? Google Play Reviews Scraper collects public review rows from Google Play app pages. It accepts app package IDs or Play Store URLs. It returns one dataset item per review. Each item includes review content, reviewer name, rating, date, app version, helpful votes, developer reply fields, locale, and app metadata. ### Who is it for? Product managers can monitor user feedback after releases. ASO specialists can analyze keywords and sentiment in reviews. Mobile agencies can benchmark competitors across markets. Support teams can identify recurring bugs reported by users. Founders can export review evidence for product decisions. Data teams can feed app-review data into BI, warehouses, and dashboards. ### Why use this actor? Manual Google Play review exports are slow. The Google Play console only covers apps you own. This actor works with public apps, competitor apps, and market research targets. You can run it on a schedule and export the dataset to JSON, CSV, Excel, or API clients. ### What data can it extract? | Field | Description | | --- | --- | | appId | Google Play package name | | appUrl | Google Play app URL | | appTitle | App title | | developer | Developer name | | reviewId | Review identifier | | reviewUrl | Direct review URL when available | | userName | Public reviewer name | | userImage | Public reviewer avatar URL | | rating | Star rating from 1 to 5 | | ratingText | Rating as text | | reviewTitle | Review title when available | | reviewText | Full review text | | reviewDate | Review date in ISO format | | appVersion | App version named on the review | | thumbsUp | Helpful vote count | | developerReplyText | Developer reply text | | developerReplyDate | Developer reply date | | language | Google Play language used | | country | Google Play country used | | sort | Sort mode used | | scrapeTimestamp | Time the actor saved the review | ### Pricing The launch price starts at about $0.10 per 1,000 saved reviews on the BRONZE tier, plus a small run-start event. Higher-volume tiers receive lower per-review prices. You only pay for reviews saved to the dataset. Small tests with low `maxReviews` are recommended before large monitoring jobs. ### How much does it cost to scrape Google Play reviews? Use a small `maxReviews` value for a first run. The actor charges a start event and a per-review event only for saved reviews. ### How to use Google Play Reviews Scraper 1. Open the actor on Apify. 2. Add one or more app IDs such as `com.instagram.android`. 3. Or paste Google Play URLs such as `https://play.google.com/store/apps/details?id=com.google.android.apps.maps`. 4. Choose a country and language. 5. Choose a sort mode. 6. Set `maxReviews`. 7. Run the actor. 8. Download results from the dataset. ### Input options #### appIds Use `appIds` when you know Android package names. Example: ```json ["com.instagram.android", "com.google.android.apps.maps"] ```` #### startUrls Use `startUrls` when you have Play Store links. The actor extracts the `id=` query parameter automatically. #### language Use a two-letter Google Play language code. The default is `en`. Different languages may expose different review pools. #### country Use a two-letter country code. The default is `US`. Country can affect app availability and visible reviews. #### sort Choose `newest`, `rating`, or `helpfulness`. `newest` is best for monitoring. `helpfulness` is best for common user complaints. `rating` is useful for star-focused analysis. #### maxReviews This limits saved reviews across all supplied apps. Use a small number for test runs. Use larger numbers for production exports. #### rating filters `minRating` and `maxRating` let you collect only low-star or high-star reviews. For example, set both to `1` to inspect one-star feedback. #### date filters `sinceDate` and `untilDate` accept ISO-style dates such as `2026-05-01`. The actor skips reviews outside the selected range. ### Example input ```json { "appIds": ["com.instagram.android"], "language": "en", "country": "US", "sort": "newest", "maxReviews": 100, "minRating": 1, "maxRating": 5, "includeAppDetails": true } ``` ### Example output ```json { "appId": "com.instagram.android", "appUrl": "https://play.google.com/store/apps/details?id=com.instagram.android&hl=en&gl=US", "appTitle": "Instagram", "developer": "Instagram", "reviewId": "gp:example", "userName": "Public reviewer", "rating": 5, "reviewText": "Great app", "reviewDate": "2026-05-31T12:00:00.000Z", "appVersion": "123.0", "thumbsUp": 4, "developerReplyText": null, "developerReplyDate": null, "language": "en", "country": "US", "sort": "newest", "scrapeTimestamp": "2026-06-01T00:00:00.000Z" } ``` ### Tips for better results Run by locale if you need country-specific review monitoring. Use `newest` for daily jobs. Use `helpfulness` to collect the reviews other users found useful. Use low `maxReviews` values for first tests. Use rating filters to focus sentiment analysis. Use multiple scheduled runs to build a time series. ### Integrations Export reviews to Google Sheets for manual triage. Send datasets to BigQuery or Snowflake for BI. Trigger Zapier or Make flows after a run finishes. Use Apify webhooks to notify Slack when new one-star reviews are found. Feed review text into sentiment analysis or topic clustering. ### API usage with Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/google-play-reviews-scraper').call({ appIds: ['com.instagram.android'], maxReviews: 50, country: 'US', language: 'en' }); console.log(run.defaultDatasetId); ``` ### API usage with Python ```python from apify_client import ApifyClient client = ApifyClient('MY-APIFY-TOKEN') run = client.actor('automation-lab/google-play-reviews-scraper').call(run_input={ 'appIds': ['com.instagram.android'], 'maxReviews': 50, 'country': 'US', 'language': 'en', }) print(run['defaultDatasetId']) ``` ### API usage with cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/automation-lab~google-play-reviews-scraper/runs?token=MY-APIFY-TOKEN' \ -H 'Content-Type: application/json' \ -d '{"appIds":["com.instagram.android"],"maxReviews":50,"country":"US","language":"en"}' ``` ### MCP usage Use the Apify MCP server with Claude Desktop, Claude Code, Cursor, or other MCP-compatible clients. MCP URL: ```text https://mcp.apify.com/?tools=automation-lab/google-play-reviews-scraper ``` Claude Code setup: ```bash claude mcp add apify-google-play-reviews https://mcp.apify.com/?tools=automation-lab/google-play-reviews-scraper ``` Claude Desktop JSON config: ```json { "mcpServers": { "apify-google-play-reviews": { "url": "https://mcp.apify.com/?tools=automation-lab/google-play-reviews-scraper" } } } ``` Example prompts: - "Run Google Play Reviews Scraper for com.instagram.android and summarize one-star complaints." - "Collect the newest 100 reviews for this app in the US locale." - "Compare helpful reviews for two competing Android apps." ### Scheduling Schedule the actor daily to monitor fresh reviews. Use `newest` sort for monitoring jobs. Set `sinceDate` in downstream logic or compare review IDs between runs. ### Data quality notes Google Play exposes different review pools by language and country. The visible count on Google Play includes ratings without written review text. Some reviews do not include app version. Some reviews do not have developer replies. Reviewer names are public display names. ### FAQ #### Can I scrape competitor app reviews? Yes. The actor works with public Google Play app pages that are visible without logging in. #### Why do I see fewer reviews than the total rating count? Google Play rating totals include star ratings without written public review text. ### Troubleshooting If you get few reviews, try a different language or country. If a package ID fails, confirm the app is visible in the selected country. If date filters return no items, widen the date range or use `newest` sort. If app metadata is unavailable, set `includeAppDetails` to false and retry. ### Legality This actor extracts public Google Play information. Use the data responsibly. Do not collect private data. Respect applicable laws, platform terms, and privacy requirements. ### Related scrapers Explore other automation-lab actors for app, review, and market research workflows. Related categories include review monitoring, app store optimization, social listening, and competitor intelligence. ### Limitations The actor does not log in to Google Play. It does not access private Google Play Console data. It can only return reviews Google Play makes publicly visible for the selected locale. Large exports may need multiple runs by language or country. ### Changelog Initial version extracts public Google Play reviews through an HTTP-first workflow. ### Support Open an Apify issue if a public app URL stops working or a field becomes unavailable. Include the app ID, input, and run ID so the problem can be reproduced. # Actor input Schema ## `appIds` (type: `array`): Package names such as com.instagram.android. Use this when you already know the app IDs. ## `startUrls` (type: `array`): Play Store URLs in the form https://play.google.com/store/apps/details?id=APP\_ID. You can use app IDs, URLs, or both. ## `maxReviews` (type: `integer`): Maximum number of matching reviews to save across all apps. ## `sort` (type: `string`): How Google Play should order returned reviews. ## `language` (type: `string`): Two-letter Google Play language code for reviews and app metadata. ## `country` (type: `string`): Two-letter Google Play country code used for country-specific app availability and reviews. ## `minRating` (type: `integer`): Only save reviews with this star rating or higher. ## `maxRating` (type: `integer`): Only save reviews with this star rating or lower. ## `sinceDate` (type: `string`): Optional ISO date (YYYY-MM-DD). Reviews older than this are skipped. ## `untilDate` (type: `string`): Optional ISO date (YYYY-MM-DD). Reviews newer than this are skipped. ## `includeAppDetails` (type: `boolean`): Fetch app title, developer, installs, genre, and rating summary once per app and attach it to each review. ## Actor input object example ```json { "appIds": [ "com.instagram.android" ], "startUrls": [ { "url": "https://play.google.com/store/apps/details?id=com.google.android.apps.maps" } ], "maxReviews": 20, "sort": "newest", "language": "en", "country": "US", "minRating": 1, "maxRating": 5, "includeAppDetails": true } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "appIds": [ "com.instagram.android" ], "startUrls": [ { "url": "https://play.google.com/store/apps/details?id=com.google.android.apps.maps" } ], "language": "en", "country": "US" }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/google-play-reviews-scraper").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "appIds": ["com.instagram.android"], "startUrls": [{ "url": "https://play.google.com/store/apps/details?id=com.google.android.apps.maps" }], "language": "en", "country": "US", } # Run the Actor and wait for it to finish run = client.actor("automation-lab/google-play-reviews-scraper").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 '{ "appIds": [ "com.instagram.android" ], "startUrls": [ { "url": "https://play.google.com/store/apps/details?id=com.google.android.apps.maps" } ], "language": "en", "country": "US" }' | apify call automation-lab/google-play-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/google-play-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Play Reviews Scraper", "description": "📱 Extract public Google Play reviews with ratings, dates, app versions, helpful votes, developer replies, and app metadata for ASO.", "version": "0.1", "x-build-id": "VAQb9z4gz0kgz65ET" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~google-play-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-google-play-reviews-scraper", "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/automation-lab~google-play-reviews-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-google-play-reviews-scraper", "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/automation-lab~google-play-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-google-play-reviews-scraper", "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": { "appIds": { "title": "Google Play app IDs", "type": "array", "description": "Package names such as com.instagram.android. Use this when you already know the app IDs.", "items": { "type": "string" } }, "startUrls": { "title": "Google Play app URLs", "type": "array", "description": "Play Store URLs in the form https://play.google.com/store/apps/details?id=APP_ID. You can use app IDs, URLs, or both.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxReviews": { "title": "Maximum reviews", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of matching reviews to save across all apps.", "default": 20 }, "sort": { "title": "Review sort order", "enum": [ "newest", "rating", "helpfulness" ], "type": "string", "description": "How Google Play should order returned reviews.", "default": "newest" }, "language": { "title": "Language", "type": "string", "description": "Two-letter Google Play language code for reviews and app metadata.", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Two-letter Google Play country code used for country-specific app availability and reviews.", "default": "US" }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only save reviews with this star rating or higher.", "default": 1 }, "maxRating": { "title": "Maximum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only save reviews with this star rating or lower.", "default": 5 }, "sinceDate": { "title": "Reviews since date", "type": "string", "description": "Optional ISO date (YYYY-MM-DD). Reviews older than this are skipped." }, "untilDate": { "title": "Reviews until date", "type": "string", "description": "Optional ISO date (YYYY-MM-DD). Reviews newer than this are skipped." }, "includeAppDetails": { "title": "Include app metadata", "type": "boolean", "description": "Fetch app title, developer, installs, genre, and rating summary once per app and attach it to each review.", "default": true } } }, "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 } } } } } } } } } } ```