# App Store + Google Play Reviews & ASO Scraper (`renzomacar/app-store-scraper`) Actor Scrape Apple App Store and Google Play app metadata, ratings, and reviews by country, in one run, with no API key. ASO research, review monitoring, and sentiment data — a pay-per-result Sensor Tower & data.ai alternative. - **URL**: https://apify.com/renzomacar/app-store-scraper.md - **Developed by:** [Renzo Madueno](https://apify.com/renzomacar) (community) - **Categories:** AI, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 Reviews & ASO Scraper Scrape **Apple App Store and Google Play** app metadata, ratings, and reviews — by country, in one call, with **no API key**. The pay-per-result alternative to Sensor Tower and data.ai for ASO research, review monitoring, and app-review sentiment analysis. ⭐ **Using it and it works? [Leave a 30-second review](https://apify.com/renzomacar/app-store-scraper/reviews).** It's the single biggest thing that helps other developers find it. ### What can this Actor do? Three modes — pick one with the `mode` input: - **Reviews + metadata** — for any app: title, developer, category, rating, rating count, version, price, description, icon, screenshots, plus reviews (star rating, title, text, author, date, version, helpful votes, developer replies). - **Top charts (ASO)** — Apple Top Free / Paid / Grossing charts, by country and category (genre), with rank. - **Keyword ranking (ASO)** — give it a keyword and see exactly which apps rank for it on Apple and Google Play, by country. The core of App Store Optimization research. Plus, across all modes: - **Both stores in one run** — Apple App Store *and* Google Play, side by side. - **Multi-country** — localized data per country code (us, gb, de, …). - **No API key, no login, no proxy headaches** — it uses Apple's official iTunes API + RSS feeds and Google Play's public endpoints. ### How do I scrape app reviews? 1. Add your **apps** — by name (`Notion`), Apple ID/URL (`477128284`), or Google Play package (`com.spotify.music`). 2. Pick the **platform** (both / Apple / Google), **countries**, and how many reviews per app. 3. Run it. You get one row per app (metadata) and one row per review. ### How much will it cost to scrape app reviews? Pay-per-result — no subscription, a fraction of Sensor Tower / data.ai: | Event | Price | |-------|-------| | Actor start | $0.01 | | App metadata (per app) | $0.005 | | Reviews batch (per app, per country) | $0.01 | ### What does the output look like? App record: ```json { "type": "app", "platform": "apple", "appId": 477128284, "title": "Notion", "rating": 4.78, "ratingCount": 86359, "genre": "Productivity", "country": "us" } ```` Review record: ```json { "type": "review", "platform": "google", "appId": "com.spotify.music", "userName": "Alex P.", "rating": 5, "title": "Love it", "text": "Works great…", "date": "2026-06-15T10:00:00Z", "thumbsUp": 12 } ``` ### Use cases - **ASO (App Store Optimization)** — track ratings, versions, and metadata for your app and competitors. - **Review monitoring** — watch new reviews across both stores and countries. - **Sentiment analysis / ML** — pull thousands of reviews as clean JSON to feed an LLM or model. - **Market research** — compare competitor ratings and review themes. ### FAQ **Do I need an API key or developer account?** No. Apple's iTunes API/RSS and Google Play's public endpoints need no login. **Which is more complete, Apple or Google?** Apple exposes ~500 recent reviews per country via RSS; Google Play supports deeper review pulls. Metadata is full on both. **Can I monitor only new reviews?** Sort by `newest` and run on a schedule — compare against your last run's review IDs. **Does it work for any country?** Yes — pass any two-letter country code. ### Other Actors by this author Need contacts, maps, or web data too? See my [other Actors](https://apify.com/renzomacar) — company enrichment, email & contact finder, Google Maps, and more. *** Built and maintained by [Renzo Madueño](https://apify.com/renzomacar). Found a bug or want another field? Open an issue or leave a review and tell me — I read every message. # Actor input Schema ## `mode` (type: `string`): reviews = app metadata + reviews. charts = ASO top charts. search = ASO keyword ranking (which apps rank for a term). ## `apps` (type: `array`): App names, Apple App Store IDs/URLs, or Google Play package names/URLs. E.g. "Notion", "477128284", "com.spotify.music". ## `searchTerms` (type: `array`): Keywords to check app rankings for (ASO). Returns the ranked apps per term and country. ## `platform` (type: `string`): Which store(s) to use. ## `countries` (type: `array`): Two-letter country codes (e.g. us, gb, de). ## `includeReviews` (type: `boolean`): Also scrape reviews, not just app metadata. ## `maxReviewsPerApp` (type: `integer`): Per app, per country. Apple caps at ~500 via RSS; Google Play supports more. ## `sort` (type: `string`): Order in which reviews are pulled. ## `chartType` (type: `string`): Which Apple chart to pull. ## `appleGenreId` (type: `integer`): Optional App Store genre/category ID to filter charts (e.g. 6017 = Education, 6013 = Health & Fitness, 6014 = Games). Leave empty for overall. ## `limit` (type: `integer`): Max apps to return per chart or per search term/country. ## Actor input object example ```json { "mode": "reviews", "apps": [ "com.spotify.music", "Notion" ], "searchTerms": [ "meditation", "habit tracker" ], "platform": "both", "countries": [ "us" ], "includeReviews": true, "maxReviewsPerApp": 100, "sort": "newest", "chartType": "topfree", "limit": 50 } ``` # 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": [ "com.spotify.music", "Notion" ], "searchTerms": [ "meditation", "habit tracker" ], "countries": [ "us" ] }; // Run the Actor and wait for it to finish const run = await client.actor("renzomacar/app-store-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": [ "com.spotify.music", "Notion", ], "searchTerms": [ "meditation", "habit tracker", ], "countries": ["us"], } # Run the Actor and wait for it to finish run = client.actor("renzomacar/app-store-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 '{ "apps": [ "com.spotify.music", "Notion" ], "searchTerms": [ "meditation", "habit tracker" ], "countries": [ "us" ] }' | apify call renzomacar/app-store-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=renzomacar/app-store-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "App Store + Google Play Reviews & ASO Scraper", "description": "Scrape Apple App Store and Google Play app metadata, ratings, and reviews by country, in one run, with no API key. ASO research, review monitoring, and sentiment data — a pay-per-result Sensor Tower & data.ai alternative.", "version": "0.1", "x-build-id": "Dgah3EBDT3IfThkBA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/renzomacar~app-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-renzomacar-app-store-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/renzomacar~app-store-scraper/runs": { "post": { "operationId": "runs-sync-renzomacar-app-store-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/renzomacar~app-store-scraper/run-sync": { "post": { "operationId": "run-sync-renzomacar-app-store-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": { "mode": { "title": "Mode", "enum": [ "reviews", "charts", "search" ], "type": "string", "description": "reviews = app metadata + reviews. charts = ASO top charts. search = ASO keyword ranking (which apps rank for a term).", "default": "reviews" }, "apps": { "title": "Apps (reviews mode)", "type": "array", "description": "App names, Apple App Store IDs/URLs, or Google Play package names/URLs. E.g. \"Notion\", \"477128284\", \"com.spotify.music\".", "items": { "type": "string" } }, "searchTerms": { "title": "Search terms (search mode)", "type": "array", "description": "Keywords to check app rankings for (ASO). Returns the ranked apps per term and country.", "items": { "type": "string" } }, "platform": { "title": "Platform", "enum": [ "both", "apple", "google" ], "type": "string", "description": "Which store(s) to use.", "default": "both" }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes (e.g. us, gb, de).", "items": { "type": "string" } }, "includeReviews": { "title": "Include reviews (reviews mode)", "type": "boolean", "description": "Also scrape reviews, not just app metadata.", "default": true }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Per app, per country. Apple caps at ~500 via RSS; Google Play supports more.", "default": 100 }, "sort": { "title": "Review sort", "enum": [ "newest", "mosthelpful", "rating" ], "type": "string", "description": "Order in which reviews are pulled.", "default": "newest" }, "chartType": { "title": "Chart type (charts mode)", "enum": [ "topfree", "toppaid", "topgrossing" ], "type": "string", "description": "Which Apple chart to pull.", "default": "topfree" }, "appleGenreId": { "title": "Apple genre ID (charts mode, optional)", "type": "integer", "description": "Optional App Store genre/category ID to filter charts (e.g. 6017 = Education, 6013 = Health & Fitness, 6014 = Games). Leave empty for overall." }, "limit": { "title": "Limit (charts/search mode)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Max apps to return per chart or per search term/country.", "default": 50 } } }, "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 } } } } } } } } } } ```