# App Store Review Miner — AI Bugs & Feature Requests (`automationnation/app-store-review-miner`) Actor Mine Apple App Store and Google Play reviews for real bugs, feature requests, and sentiment. One AI call turns raw reviews into a structured, agent-ready summary — no anti-bot risk, official/public data sources only. - **URL**: https://apify.com/automationnation/app-store-review-miner.md - **Developed by:** [Nathan Carter](https://apify.com/automationnation) (community) - **Categories:** Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $50.00 / 1,000 app analyseds 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Review Miner — AI Bugs & Feature Requests Turn Apple App Store and Google Play reviews into a structured bug/feature-request report in one run. No raw review dump to read through — one AI call per app turns dozens (or hundreds) of reviews into the handful of things that actually matter: what's broken, what users are asking for, and how urgent it is. ### Why this instead of a raw review scraper The Apify Store already has several App Store/Play Store review scrapers doing large volumes at raw-data pricing (~$0.10 per 1,000 reviews). That's fine if you want a CSV of review text — it's not useful if you actually want to know *what to fix next*. This actor does the analysis, not just the extraction: - **Top bugs** — the specific, recurring technical issues users are hitting, most-frequent first - **Top feature requests** — what users are explicitly asking for - **Critical issues** — anything that sounds urgent (crashes, data loss, billing problems, can't log in) - **Competitor mentions** — when reviewers name a competitor or say they're switching away - **Sentiment summary** — what's actually driving the rating, in plain English ### Input | Field | Description | |---|---| | `appleAppIds` | Numeric Apple App Store IDs, e.g. `"324684580"` (found in the App Store URL) | | `appleCountry` | App Store storefront, e.g. `"us"`, `"gb"` | | `googlePlayIds` | Google Play package names, e.g. `"com.spotify.music"` | | `maxReviewsPerApp` | Reviews to fetch per app per source (default 100, free trial capped at 8 apps total) | | `includeRawReviews` | Include individual review records alongside the AI synthesis (off by default — output stays compact) | | `anthropicApiKey` / `geminiApiKey` | Optional — enables the AI synthesis step | ### How it works 1. Apple: fetches the official RSS customer-reviews feed (public, no auth, no blocking — plain HTTP) 2. Google Play: parses the review data Google already embeds in the app page's HTML (no browser needed) 3. Both sources feed into a single AI call per app that extracts bugs, feature requests, critical issues, competitor mentions, and sentiment 4. One record per app, ready for a product/support team or downstream automation ### Notes - Both data sources are public/official — no scraping-detection risk, no CAPTCHAs, no proxies needed. - Apple's RSS feed has a baseline ~30% cache-staleness rate on any given request (an Akamai CDN quirk, not a block) — the actor retries automatically, so this is invisible in normal use. - Google Play returns the reviews visible on the app's page at fetch time (typically 20-40) — for a bug/feature-request *sample*, this is plenty; it isn't a full review-history export. - AI is optional. Without a key, you still get review counts and average rating — just no synthesis. # Actor input Schema ## `appleAppIds` (type: `array`): Numeric Apple App Store IDs, e.g. "363590051" (Netflix). Find it in the App Store URL: apps.apple.com/us/app/name/id363590051. ## `appleCountry` (type: `string`): Two-letter App Store storefront country code, e.g. "us", "gb". ## `googlePlayIds` (type: `array`): Google Play package names, e.g. "com.spotify.music". Find it in the Play Store URL: play.google.com/store/apps/details?id=com.spotify.music. ## `maxReviewsPerApp` (type: `integer`): Maximum reviews to fetch per app per source. Free trial is capped at 8 apps total regardless of this value. ## `includeRawReviews` (type: `boolean`): Include the individual review records alongside the AI synthesis. Off by default to keep output compact for agent/MCP consumption. ## `anthropicApiKey` (type: `string`): Enables AI synthesis (bugs, feature requests, sentiment). Tried before Gemini if both are set. ## `geminiApiKey` (type: `string`): Free-tier alternative to Anthropic for AI synthesis. ## Actor input object example ```json { "appleAppIds": [ "363590051", "444934666" ], "appleCountry": "us", "googlePlayIds": [], "maxReviewsPerApp": 100, "includeRawReviews": false } ```` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("automationnation/app-store-review-miner").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 = {} # Run the Actor and wait for it to finish run = client.actor("automationnation/app-store-review-miner").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 '{}' | apify call automationnation/app-store-review-miner --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automationnation/app-store-review-miner", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "App Store Review Miner — AI Bugs & Feature Requests", "description": "Mine Apple App Store and Google Play reviews for real bugs, feature requests, and sentiment. One AI call turns raw reviews into a structured, agent-ready summary — no anti-bot risk, official/public data sources only.", "version": "0.1", "x-build-id": "IQgECungVCVcXBO1B" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automationnation~app-store-review-miner/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automationnation-app-store-review-miner", "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/automationnation~app-store-review-miner/runs": { "post": { "operationId": "runs-sync-automationnation-app-store-review-miner", "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/automationnation~app-store-review-miner/run-sync": { "post": { "operationId": "run-sync-automationnation-app-store-review-miner", "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": { "appleAppIds": { "title": "Apple App Store IDs", "type": "array", "description": "Numeric Apple App Store IDs, e.g. \"363590051\" (Netflix). Find it in the App Store URL: apps.apple.com/us/app/name/id363590051.", "default": [ "363590051", "444934666" ], "items": { "type": "string" } }, "appleCountry": { "title": "Apple storefront country", "type": "string", "description": "Two-letter App Store storefront country code, e.g. \"us\", \"gb\".", "default": "us" }, "googlePlayIds": { "title": "Google Play package names", "type": "array", "description": "Google Play package names, e.g. \"com.spotify.music\". Find it in the Play Store URL: play.google.com/store/apps/details?id=com.spotify.music.", "default": [], "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 10, "maximum": 500, "type": "integer", "description": "Maximum reviews to fetch per app per source. Free trial is capped at 8 apps total regardless of this value.", "default": 100 }, "includeRawReviews": { "title": "Include raw review text in output", "type": "boolean", "description": "Include the individual review records alongside the AI synthesis. Off by default to keep output compact for agent/MCP consumption.", "default": false }, "anthropicApiKey": { "title": "Anthropic API key (optional)", "type": "string", "description": "Enables AI synthesis (bugs, feature requests, sentiment). Tried before Gemini if both are set." }, "geminiApiKey": { "title": "Google Gemini API key (optional)", "type": "string", "description": "Free-tier alternative to Anthropic for AI synthesis." } } }, "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 } } } } } } } } } } ```