# App Store & Google Play Review Scraper (`chilly_damask/app-store-google-play-review-scraper`) Actor Pull public app reviews from the Apple App Store and Google Play across all countries in one normalized feed. Signed out, no login, no API keys. Pay per review. - **URL**: https://apify.com/chilly\_damask/app-store-google-play-review-scraper.md - **Developed by:** [Jaxx](https://apify.com/chilly_damask) (community) - **Categories:** Developer tools, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.30 / 1,000 review scrapeds 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/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 ## App Store & Google Play Review Scraper — Both Stores, All Countries **Pull public app reviews from the Apple App Store and Google Play — across every country storefront, in one normalized feed — for any app. Signed out, no login, no API keys. You pay per review.** Feed it Apple App Store IDs and/or Google Play package names, pick the countries you care about (or `["all"]`), and get one clean, deduplicated table of reviews from **both stores at once** — the same schema whether a review came from Apple or Google, so you never reconcile two different scrapers again. - ⭐ Star rating, title, full review text, app version, date, and helpful-count - 🌍 **Every storefront** — fan out across all countries in a single run - 🍎 + 🤖 **Both stores, one schema** — App Store and Google Play normalized together - 💬 Developer responses where present - 💰 **Pay per review** — an app with no reviews costs you nothing --- ### 🎯 Best for - **ASO & product teams** — pull all reviews to mine keywords, bugs, and feature requests. - **Sentiment / LLM pipelines** — a clean, normalized review feed to run through analysis or a model. - **Competitor & market research** — scrape any competitor's app across both stores and all markets. - **International coverage** — surface what users in every country actually say, not just the US. - **Support & QA monitoring** — pull recent low-star reviews to catch regressions after a release. --- ### ⚙️ How it works Fully **signed out**, plain HTTP — **no browser, no login, no CAPTCHA, no API keys**: - **Apple App Store** — the public iTunes RSS customer-reviews feed, paginated across pages and fanned out across every requested storefront (up to ~500 most-recent reviews per storefront). - **Google Play** — the public web reviews endpoint, per storefront and language. - Reviews from both stores are **normalized into one schema** and **deduplicated** by their stable per-store ID. **Non-PII by design:** the actor returns only a review's **pseudonymous public display name** — never an email, and never any author-contact enrichment. --- ### ▶️ How to use (no code) 1. Open the actor and add your **Apple App Store IDs** (the number in `apps.apple.com/app/id`**`123456789`**) and/or **Google Play package names** (the `id=`**`com.example.app`** in the Play URL). 2. Set **Countries** — e.g. `["us","gb","de","jp"]`, or `["all"]` for global coverage. 3. (Optional) filter by star rating (`minRating` / `maxRating`), a `sinceDate`, or a `maxReviewsPerApp` cap. 4. Click **Start**, then export the results as JSON, CSV, Excel, XML, or HTML — or pull them via the API. --- ### 📥 Input | Field | Type | Default | Notes | |---|---|---|---| | `appStoreIds` | array | — | Apple App Store numeric IDs (e.g. `389801252`). Empty = Google Play only. | | `googlePlayPackageIds` | array | — | Google Play package names (e.g. `com.instagram.android`). Empty = App Store only. | | `countries` | array | `["us"]` | ISO storefront codes, or `["all"]` for all major storefronts. | | `language` | string | `en` | Google Play review language (BCP-47). | | `maxReviewsPerApp` | integer | `1000` | Cap per app per store, summed across countries. `0` = maximum available. | | `sortBy` | enum | `mostRecent` | `mostRecent` or `mostHelpful`. | | `minRating` / `maxRating` | integer | — | Only reviews within a star range (1–5). Pull only complaints (`maxRating: 2`) or praise (`minRating: 4`). | | `sinceDate` | ISO date | — | Only reviews on/after this date — for cheap incremental re-runs. | | `includeAppMetadata` | boolean | `true` | Also resolve app name (and, on the App Store, version, developer, rating count). | #### Example input ```json { "appStoreIds": ["389801252"], "googlePlayPackageIds": ["com.instagram.android"], "countries": ["us", "gb", "de", "jp"], "sortBy": "mostRecent", "maxReviewsPerApp": 500, "minRating": 1, "maxRating": 2 } ```` *** ### 📤 Output — one record per review ```json { "store": "app_store", "appId": "389801252", "appName": "Instagram", "country": "us", "language": "us", "reviewId": "12040288301", "rating": 1, "title": "Keeps crashing", "body": "Since the last update the app crashes when I open reels…", "authorHandle": "Cloud.Yeller", "appVersion": "436.0.0", "reviewDate": "2026-07-08T14:22:10-07:00", "helpfulCount": null, "developerResponse": null, "reviewUrl": "https://itunes.apple.com/us/review?id=12040288301", "scrapedAt": "2026-07-10T18:00:00.000Z" } ``` `store` is `app_store` or `google_play`. Fields that a given store doesn't expose come back `null` (e.g. `title` and `reviewUrl` on Google Play, `helpfulCount` on the App Store) — the schema stays identical across both. *** ### 💰 Pricing (pay-per-event) You are charged a **fixed price per result** — not for compute or platform usage. | Event | Price | Per 1,000 | When you're charged | |---|---|---|---| | `review-scraped` | **$0.0003** | **$0.30 / 1,000** | Once per unique review returned. | | `app-resolved` | **$0.004** | — | Once per app successfully resolved per store. An app/store that returns nothing costs nothing. | **What a run costs — a worked example:** scraping **1 app across 4 countries** returning **2,000 reviews** total = 2,000 × $0.0003 = **$0.60**, plus 4 App Store + 4 Google Play resolutions = 8 × $0.004 = **$0.032**. Total ≈ **$0.63**. > The prices above are exactly what you're billed. Comparable review scrapers price per 1,000 results too — compare the live listings and pick what fits your volume. *** ### ❓ FAQ **Which stores and countries are covered?** Apple App Store and Google Play, any storefront. Pass a list of ISO country codes, or `["all"]` to fan out across all major storefronts in one run. **How many reviews can I get per app?** The App Store returns up to ~500 most-recent reviews **per storefront**, so covering more countries returns more reviews. Google Play returns recent reviews per storefront. For maximum depth, run across multiple countries. **Is this legal / is it personal data?** The actor reads only publicly posted reviews, signed out, and returns only a **pseudonymous display name** — no email or contact data. Review text can still reference personal experiences, so use the data lawfully (GDPR/CCPA, each store's terms). If unsure about your use, consult your own counsel. **Do I pay for an app that has no reviews?** No. `review-scraped` only fires per review returned, and `app-resolved` isn't charged for an app/store that yields nothing. **Can I get only 1-star reviews (or only 5-star)?** Yes — set `maxRating: 2` for complaints or `minRating: 4` for praise. **Can I run it on a schedule or from my own code?** Yes — schedule it in the Apify Console, call it via the API, drive it with the `apify-client` SDKs (JS/Python), or wire the output into Make, Zapier, Slack, Google Sheets, or a webhook. *** ### 🔌 API-ready Apify auto-generates integration snippets for this actor — JavaScript, Python, CLI, REST, OpenAPI, and an MCP server — so you can drop it into your own stack or an agent workflow. See the **API** tab on the actor page. *** ### Maintainer Published by **Jaxx**. Found an app that should parse but didn't, or a field you'd like added? Open an issue on the actor's **Issues** tab — reports and edge cases are actively reviewed. # Actor input Schema ## `appStoreIds` (type: `array`): Apple App Store numeric app IDs (e.g. 389801252 for Instagram). Find it in the App Store URL: apps.apple.com/app/id\. Leave empty to scrape Google Play only. ## `googlePlayPackageIds` (type: `array`): Google Play package names (e.g. com.instagram.android). Find it in the Play URL: play.google.com/store/apps/details?id=. Leave empty to scrape the App Store only. ## `countries` (type: `array`): ISO storefront/locale codes to cover, e.g. \["us","gb","de","jp"]. Pass \["all"] to fan out across all major storefronts for global coverage (the core feature). Each country is a separate storefront with its own reviews. ## `language` (type: `string`): BCP-47 language code for Google Play reviews (e.g. "en"). Defaults to English. App Store reviews come in each storefront's own language regardless. ## `maxReviewsPerApp` (type: `integer`): Cap reviews per app per store, summed across countries. 0 = pull the maximum available. App Store returns up to ~500 most-recent per storefront. ## `sortBy` (type: `string`): Which reviews to prioritize. ## `minRating` (type: `integer`): Only return reviews at or above this star rating (1-5). Leave empty for no minimum. Handy for pulling only complaints (maxRating=2) or praise (minRating=4). ## `maxRating` (type: `integer`): Only return reviews at or below this star rating (1-5). Leave empty for no maximum. ## `sinceDate` (type: `string`): Only return reviews on or after this date, e.g. 2026-01-01. Enables cheap incremental re-runs. Leave empty for all available. ## `includeAppMetadata` (type: `boolean`): Also resolve the app name (and, on the App Store, current version, developer, and total rating count) for each app. ## Actor input object example ```json { "appStoreIds": [ "389801252" ], "googlePlayPackageIds": [ "com.instagram.android" ], "countries": [ "us", "gb", "de", "jp" ], "language": "en", "maxReviewsPerApp": 1000, "sortBy": "mostRecent", "includeAppMetadata": true } ``` # 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 = { "appStoreIds": [ "389801252" ], "googlePlayPackageIds": [ "com.instagram.android" ], "countries": [ "us", "gb", "de", "jp" ] }; // Run the Actor and wait for it to finish const run = await client.actor("chilly_damask/app-store-google-play-review-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 = { "appStoreIds": ["389801252"], "googlePlayPackageIds": ["com.instagram.android"], "countries": [ "us", "gb", "de", "jp", ], } # Run the Actor and wait for it to finish run = client.actor("chilly_damask/app-store-google-play-review-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 '{ "appStoreIds": [ "389801252" ], "googlePlayPackageIds": [ "com.instagram.android" ], "countries": [ "us", "gb", "de", "jp" ] }' | apify call chilly_damask/app-store-google-play-review-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=chilly_damask/app-store-google-play-review-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "App Store & Google Play Review Scraper", "description": "Pull public app reviews from the Apple App Store and Google Play across all countries in one normalized feed. Signed out, no login, no API keys. Pay per review.", "version": "1.0", "x-build-id": "zEyJtxs3HCTVUTtLS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/chilly_damask~app-store-google-play-review-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-chilly_damask-app-store-google-play-review-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/chilly_damask~app-store-google-play-review-scraper/runs": { "post": { "operationId": "runs-sync-chilly_damask-app-store-google-play-review-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/chilly_damask~app-store-google-play-review-scraper/run-sync": { "post": { "operationId": "run-sync-chilly_damask-app-store-google-play-review-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": { "appStoreIds": { "title": "Apple App Store IDs", "type": "array", "description": "Apple App Store numeric app IDs (e.g. 389801252 for Instagram). Find it in the App Store URL: apps.apple.com/app/id. Leave empty to scrape Google Play only.", "items": { "type": "string" } }, "googlePlayPackageIds": { "title": "Google Play package names", "type": "array", "description": "Google Play package names (e.g. com.instagram.android). Find it in the Play URL: play.google.com/store/apps/details?id=. Leave empty to scrape the App Store only.", "items": { "type": "string" } }, "countries": { "title": "Countries / storefronts", "type": "array", "description": "ISO storefront/locale codes to cover, e.g. [\"us\",\"gb\",\"de\",\"jp\"]. Pass [\"all\"] to fan out across all major storefronts for global coverage (the core feature). Each country is a separate storefront with its own reviews.", "default": [ "us" ], "items": { "type": "string" } }, "language": { "title": "Language (Google Play)", "type": "string", "description": "BCP-47 language code for Google Play reviews (e.g. \"en\"). Defaults to English. App Store reviews come in each storefront's own language regardless.", "default": "en" }, "maxReviewsPerApp": { "title": "Max reviews per app (per store)", "minimum": 0, "type": "integer", "description": "Cap reviews per app per store, summed across countries. 0 = pull the maximum available. App Store returns up to ~500 most-recent per storefront.", "default": 1000 }, "sortBy": { "title": "Sort order", "enum": [ "mostRecent", "mostHelpful" ], "type": "string", "description": "Which reviews to prioritize.", "default": "mostRecent" }, "minRating": { "title": "Minimum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only return reviews at or above this star rating (1-5). Leave empty for no minimum. Handy for pulling only complaints (maxRating=2) or praise (minRating=4)." }, "maxRating": { "title": "Maximum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only return reviews at or below this star rating (1-5). Leave empty for no maximum." }, "sinceDate": { "title": "Only reviews since (ISO date)", "type": "string", "description": "Only return reviews on or after this date, e.g. 2026-01-01. Enables cheap incremental re-runs. Leave empty for all available." }, "includeAppMetadata": { "title": "Include app metadata", "type": "boolean", "description": "Also resolve the app name (and, on the App Store, current version, developer, and total rating count) for each app.", "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 } } } } } } } } } } ```