# App Store & Google Play Reviews Scraper (`josh99smith/app-reviews-scraper`) Actor Scrape App Store and Google Play reviews in one run: rating, text, author, version, date, developer reply. Any country and sort order. Pay per review. - **URL**: https://apify.com/josh99smith/app-reviews-scraper.md - **Developed by:** [Joshua Smith](https://apify.com/josh99smith) (community) - **Categories:** E-commerce, Marketing, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $0.15 / 1,000 review collecteds 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/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README An **App Store and Google Play reviews scraper** that collects public user reviews from both stores in a single run. Paste app links or ids from either store and get back every review as a clean JSON record: star rating, title, text, reviewer display name, app version, date, helpful votes and the developer's reply where one exists. Apps that cannot be found are reported **free of charge**; you pay a small flat price per review. Built for product managers, app marketers, researchers and developers who need review data as an API rather than copied from store pages. ### Features - Scrape App Store reviews by app ID or App Store URL - Scrape Google Play reviews by package name or Play Store URL - Export app reviews to CSV, Excel, JSON or Google Sheets - Filter app reviews by star rating, for example 1-2 star complaints only - Get developer replies to Google Play reviews - Collect App Store reviews per country (us, gb, de, jp and any other storefront) - Sort app reviews by newest, most helpful or highest rating - Monitor competitor app reviews on a schedule ### What can you do with App Store & Google Play Reviews Scraper? - **Product feedback analysis**: find the bugs, feature requests and friction points users write about after every release, split by app version. - **Competitor monitoring**: track what people like and dislike about competing apps, and schedule weekly runs to spot changes. - **Sentiment pipelines**: feed reviews into your own classifier or a BI tool; the rating window filter lets you pull only 1-2 star complaints or only 5 star praise. - **Feeding LLMs and agents**: the output is compact JSON that drops straight into a summarisation or RAG workflow, and the Actor is available through the Apify MCP server. ### How it works For Apple the Actor reads the public customer-reviews feed that the App Store publishes for every app and country, plus the public lookup API for the app name, developer, average rating and rating count. For Google Play it uses the public web endpoints behind the Play store page (via the MIT-licensed `google-play-scraper` library). No login, no browser, low request rates: a run for two apps with 200 reviews each finishes in a few seconds. Limits you should know: **Apple exposes at most 500 reviews per app per country** (10 pages of 50) and does not filter by language; the Apple feed also has no developer replies. Google Play returns reviews in pages of 150 and can go much deeper. ### How to use it 1. Open the Actor and paste your apps into **Apps**, one per line. App Store URLs, Google Play URLs, numeric Apple ids and Android package names all work and can be mixed. 2. Pick the **Country** (and, for Google Play, the **Language**), the **Sort order** and **Max reviews per app**. Narrow the **rating** window if you only want complaints or praise. 3. Click **Start**. Reviews appear in the **Output** tab as they arrive. 4. Download the dataset as JSON, CSV, Excel or XML, or send it to Google Sheets, Slack, Make or Zapier with an integration. ```json { "apps": ["https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580", "com.spotify.music"], "country": "us", "language": "en", "sort": "newest", "maxReviewsPerApp": 200, "minRating": 1, "maxRating": 5 } ``` ### Use it from the API, Python, JavaScript or an AI agent Start a run and get the reviews back in one HTTP call: ```bash curl -X POST "https://api.apify.com/v2/acts/josh99smith~app-reviews-scraper/run-sync-get-dataset-items?token=" \ -H "Content-Type: application/json" \ -d '{"apps": ["com.spotify.music"], "maxReviewsPerApp": 50}' ``` Python, with the `apify-client` package: ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("josh99smith/app-reviews-scraper").call( run_input={"apps": ["com.spotify.music", "324684580"], "maxReviewsPerApp": 50, "minRating": 1, "maxRating": 2} ) for review in client.dataset(run["defaultDatasetId"]).iterate_items(): print(review["rating"], review["text"]) ``` JavaScript or TypeScript, with the `apify-client` package: ```javascript import { ApifyClient } from "apify-client"; const client = new ApifyClient({ token: "" }); const run = await client.actor("josh99smith/app-reviews-scraper").call({ apps: ["com.spotify.music", "324684580"], maxReviewsPerApp: 50, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` The Actor is also available as a tool through the Apify MCP server for AI agents, and it can be scheduled or connected to Zapier, Make, n8n and Google Sheets in the **Integrations** tab. ### Output One record per review, identical shape for both stores: ```json { "store": "google", "appId": "com.spotify.music", "appName": "Spotify: Music and Podcasts", "developer": "Spotify AB", "reviewId": "4cac1797-5266-4c68-b3f6-f86f63b2c5f5", "title": null, "text": "too much ad", "rating": 2, "authorName": "HIMANSHU RANJAN BEHERA", "version": "9.1.30.1993", "date": "2026-09-17T19:23:03.181Z", "helpfulVotes": 0, "developerReply": { "text": "Hi! We welcome your feedback and we'll pass it along to the ads team. ...", "date": "2026-09-17T19:45:13.542Z" }, "country": "us", "language": "en", "url": "https://play.google.com/store/apps/details?id=com.spotify.music&reviewId=4cac1797-5266-4c68-b3f6-f86f63b2c5f5", "fetchedAt": "2026-09-18T19:46:00.886Z" } ``` ```json { "store": "apple", "appId": "324684580", "appName": "Spotify: Music and Podcasts", "developer": "Spotify", "reviewId": "14560977347", "title": "Excelente servicio", "text": "Todo es mejor sin comerciales", "rating": 5, "authorName": "MoruXx", "version": "9.1.82", "date": "2026-09-17T16:18:01.000Z", "helpfulVotes": 0, "developerReply": null, "country": "us", "language": null, "url": "https://apps.apple.com/us/app/id324684580?see-all=reviews", "fetchedAt": "2026-09-18T19:46:00.626Z" } ``` Apps that could not be processed are recorded too, so nothing silently disappears from your list: ```json { "success": false, "input": "com.this.package.does.not.exist", "store": "google", "appId": "com.this.package.does.not.exist", "errorType": "not-found", "error": "App not found (404)", "fetchedAt": "..." } ``` The `SUMMARY` record in the key-value store lists, for every app, the name, developer, average rating, total rating count and how many reviews were fetched and stored. ### Output fields | Field | Description | | --------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | `store` | `apple` or `google`. | | `appId` / `appName` / `developer` | Apple track id or Android package name, plus the store listing name and developer. | | `reviewId` | Store-assigned review id, unique per store. | | `title` | Review headline (Apple only; always `null` on Google Play). | | `text` / `rating` | Review body and star rating 1-5. | | `authorName` | The public display name shown next to the review. | | `version` | App version the review was written for, when the store provides it. | | `date` | ISO 8601 timestamp of the review. | | `helpfulVotes` | Helpful votes (Apple `voteSum`, Google Play thumbs-up). | | `developerReply` | `{ text, date }` when the developer answered (Google Play only), otherwise `null`. | | `country` / `language` | Store country of the review; language is the requested Play language and `null` for Apple. | | `url` | Direct review link on Google Play, or the app's reviews page on the App Store. | | `errorType` | Failures only: `invalid-url`, `not-found`, `blocked`, `rate-limited`, `timeout`, `http-error`, `network` or `other`. | ### Pricing: how much does it cost to scrape app reviews? You pay a **flat price per review stored** (shown next to the Start button); 1,000 reviews cost well under a dollar. Invalid identifiers, apps that do not exist and store errors are never charged, and there is no start-up fee. The Actor stops as soon as the maximum cost you set for the run is reached, so a long app list never produces a surprise bill. **How it compares (September 2026).** Per-review pricing here is $0.00015, in line with the cheapest single-store Actors, and unlike them this Actor covers both stores in one run with one fixed output schema. Apps that cannot be found are free, an error on one app never stops the run, and reviews filtered out by rating or date are never billed. ### Tips - **More Apple reviews**: the 500-review limit is per country. Run the same app with `country` set to `gb`, `de`, `fr`, `jp` and so on (or several runs on a schedule) and merge the datasets by `reviewId`. - **Complaints only**: set `minRating` 1 and `maxRating` 2 to collect negative reviews; the Actor keeps paging until it finds enough or the store runs out. - **Sort by rating**: Apple's feed cannot sort by rating, so the Actor downloads everything available and sorts locally. On Google Play, asking for low ratings switches to newest-first paging so that low-star reviews are actually reached. ### FAQ #### How many reviews can I scrape per app? Up to 500 per app and country from the App Store (the limit of Apple's public feed) and up to 10,000 per app from Google Play, controlled by **Max reviews per app**. Runs are also capped by the maximum cost you set. #### Why do I get fewer than 500 Apple reviews? Apple's feed serves up to 500 of the most recent (or most helpful) reviews per country, fewer for apps that do not have that many. Run per country for wider coverage. #### Why is `language` null for Apple reviews? The App Store feed does not accept a language parameter; it returns reviews in whatever language reviewers used in that country's store. #### Does it include reviewer email addresses or profile data? No. Only the public display name shown on the store page is stored, exactly as the store publishes it. Reviewer names are personal data in many jurisdictions; you are responsible for using the results in compliance with the privacy laws that apply to you (GDPR, CCPA and similar) and with the store terms. #### Is it legal to scrape App Store and Google Play reviews? The Actor only reads pages and feeds that Apple and Google publish to everyone without a login, at low request rates, and stores what the stores show publicly. Using the data lawfully and within the store terms is your responsibility. #### Will the output fields change between runs? No. Output fields are stable: existing fields are never renamed or removed without a major version bump announced in the changelog, and new fields are only ever added. You can build integrations on the schema without checking it after every run. ### Related Actors by the same developer - [Tech Stack Detector](https://apify.com/josh99smith/tech-stack-detector): find out what a website is built with. - [Website Screenshot API](https://apify.com/josh99smith/website-screenshot-api): full-page screenshots and PDFs of any URL. - [Google Autocomplete Scraper](https://apify.com/josh99smith/google-autocomplete-scraper): keyword suggestions from Google search. - [PageSpeed Insights Audit](https://apify.com/josh99smith/pagespeed-insights-audit): Core Web Vitals and Lighthouse scores via Google's API. - [Remote Jobs Aggregator](https://apify.com/josh99smith/remote-jobs-aggregator): remote job listings from five public boards. - [PDF Text Extractor](https://apify.com/josh99smith/pdf-text-extractor): text and metadata from PDF files. - [Sitemap URL Extractor](https://apify.com/josh99smith/sitemap-url-extractor): all URLs from XML sitemaps. - [RSS Feed to JSON](https://apify.com/josh99smith/rss-feed-to-json): RSS and Atom feeds as JSON. ### Support and feedback Found an app that is not parsed correctly or need an extra field? Open a ticket in the **Issues** tab of this Actor. The source code is MIT licensed. # Changelog This Actor's version history is a separate document: https://apify.com/josh99smith/app-reviews-scraper/changelog.md # Actor input Schema ## `apps` (type: `array`): One app per line. Accepts App Store URLs (`https://apps.apple.com/us/app/.../id324684580`), Google Play URLs (`https://play.google.com/store/apps/details?id=com.spotify.music`), numeric Apple app ids (`324684580`) and Android package names (`com.spotify.music`). The store is detected automatically and duplicates are removed. ## `country` (type: `string`): Two-letter store country code (`us`, `gb`, `de`, `jp`, ...). Each App Store country has its own reviews, so run once per country for wider coverage. A country inside an App Store URL overrides this value for that app. ## `language` (type: `string`): Language code for Google Play (`en`, `de`, `pt-BR`, ...). The App Store feed does not filter by language and returns whatever language reviewers wrote in. ## `sort` (type: `string`): `newest` returns the most recent reviews first, `helpful` the ones with most helpful votes, `rating` the highest rated first. The App Store feed only supports newest and helpful natively; for `rating` all available Apple reviews are downloaded and sorted. ## `maxReviewsPerApp` (type: `integer`): Stop after this many reviews for each app. The public App Store feed exposes at most 500 reviews per app and country, so higher values only matter for Google Play. ## `minRating` (type: `integer`): Only keep reviews with at least this many stars (1-5). ## `maxRating` (type: `integer`): Only keep reviews with at most this many stars (1-5). Set both limits to 1 to collect complaints only, or 4-5 for praise. ## `timeoutSecs` (type: `integer`): Give up on a single store request after this many seconds. ## Actor input object example ```json { "apps": [ "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580", "com.spotify.music" ], "country": "us", "language": "en", "sort": "newest", "maxReviewsPerApp": 200, "minRating": 1, "maxRating": 5, "timeoutSecs": 30 } ``` # Actor output Schema ## `results` (type: `string`): One record per review with store, app, rating, title, text, author display name, version, date, helpful votes and developer reply. Apps that failed are recorded with success=false. ## `summary` (type: `string`): Counts of apps requested, reviews fetched and charged, failures, plus per-app metadata (name, developer, average rating, rating count). # 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 = { "apps": [ "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580", "com.spotify.music" ] }; // Run the Actor and wait for it to finish const run = await client.actor("josh99smith/app-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 = { "apps": [ "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580", "com.spotify.music", ] } # Run the Actor and wait for it to finish run = client.actor("josh99smith/app-reviews-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "apps": [ "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580", "com.spotify.music" ] }' | apify call josh99smith/app-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,josh99smith/app-reviews-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/hULbb1kdZjnJkcsLM/builds/heIMRgigwEqF9dazY/openapi.json