# Apple App Store Scraper — App Data, Reviews & iTunes API (`bovi/app-store-scraper`) Actor Scrape Apple App Store app details and customer reviews via Apple's official iTunes API. No auth, no proxies, zero COGS. Returns app name, developer, price, rating, category, version, and up to 500 reviews per app with parse\_confidence. Pay per result. - **URL**: https://apify.com/bovi/app-store-scraper.md - **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community) - **Categories:** Developer tools, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.90 / 1,000 apps 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 ## Apple App Store Scraper — Metadata & Reviews | $2/1K | No Proxy **ASO managers, indie developers, and market researchers** use this actor to monitor competitor ratings, track review sentiment across countries, and build app datasets for NLP pipelines. **Pricing: $2.00 per 1,000 results** (app metadata + reviews). No proxy costs — Apple's official iTunes API. **No API key. No proxy. No auth. Zero setup friction.** Extract Apple App Store app details and customer reviews with a single actor. Uses Apple's official iTunes public API — **no authentication, no proxies, zero extra cost.** --- ### What you get Each output record is a flat, typed row. Two record types share the same schema: | Field | Type | Description | |---|---|---| | `record_type` | string | `"app_meta"` or `"review"` | | `app_id` | string | Numeric Apple App Store ID | | `app_name` | string | App display name | | `developer` | string | Developer / publisher name | | `category` | string | Primary category (Music, Productivity…) | | `price` | number | Price in local currency (0 = free) | | `rating_avg` | number | All-time average user rating | | `rating_count` | number | Total ratings count | | `version` | string | Current (or reviewed) app version | | `country` | string | App Store country code | | `review_id` | string | Review ID (review records only) | | `review_title` | string | Review title | | `review_text` | string | Review body text | | `review_rating` | integer | 1–5 star rating | | `review_author` | string | Reviewer username | | `review_date` | string | Review date (ISO 8601) | | `parse_confidence` | number | 0.0–1.0 data quality score | | `warnings` | array | List of missing/degraded field codes | | `scraped_at` | string | Run timestamp (ISO 8601 UTC) | --- ### Sample output ```json { "record_type": "app_meta", "app_id": "324684580", "app_name": "Spotify: Music and Podcasts", "developer": "Spotify AB", "category": "Music", "rating_avg": 4.8, "rating_count": 11500000, "price": 0, "version": "8.9.62", "parse_confidence": 1.0 } ```` ```json { "record_type": "review", "app_id": "324684580", "review_title": "Best music app", "review_text": "Absolutely love this app, UI is smooth...", "review_rating": 5, "review_author": "JohnD", "review_date": "2026-05-30T12:00:00Z", "parse_confidence": 1.0 } ``` *** ### Input options | Parameter | Default | Description | |---|---|---| | `appIds` | `["324684580"]` | Numeric Apple app IDs | | `searchTerms` | `[]` | Keyword queries (up to 200 results each) | | `country` | `"us"` | Two-letter App Store storefront code | | `maxReviews` | `50` | Reviews per app (max 500, 0 = all available) | | `includeReviews` | `true` | Fetch customer reviews | | `sortBy` | `"mostRecent"` | `"mostRecent"` or `"mostHelpful"` | | `maxSearchResults` | `50` | Max apps returned per search term | *** ### Why this scraper beats the competition - **Unified schema** — app metadata and reviews in one flat record. No post-join needed. - **parse\_confidence** — every record reports its own data quality (0.0–1.0). No competitor offers this. - **Search + direct ID** — one actor covers both use cases. - **Zero COGS** — Apple's official public iTunes API, no proxy required. - **Flat typed output** — 19 well-named fields, no nested blobs. | Feature | This actor | apify/itunes-scraper | bebity/apple-app-store-scraper | |---|---|---|---| | parse\_confidence score | ✅ | ❌ | ❌ | | Search + direct ID in one actor | ✅ | partial | ✅ | | Review sentiment by country | ✅ | ❌ | partial | | Price | $2/1K | $3.50/1K | $3/1K | *(Verify competitor prices at publish time — adjust table accordingly.)* **parse\_confidence** — every record carries a 0.0–1.0 data quality score. If Apple updates their API response shape, confidence drops before results go silently empty. Score < 0.5 → check the `warnings` field. *** ### Pricing Pay per result (`app-data-item` event). **$2.00 per 1,000 items** — competitive with the market rate. Apple's RSS feed is capped at 500 reviews per app per country. Each app lookup is one result; each review is one result. **Worked example:** - 10 apps + 50 reviews each = 10 + 500 = 510 items → **$1.02** - 100 apps (metadata only, no reviews) = 100 items → **$0.20** - 1 app with 500 reviews (full RSS cap) = 501 items → **$1.00** *** ### FAQ **Do I need an API key or proxy?** No. This actor uses Apple's official public iTunes API — no auth, no proxy, zero setup. **What formats can I export?** JSON, CSV, Excel, or JSONL — directly from the Apify dataset UI or via the REST API. **Can I schedule it to run automatically?** Yes. Use Apify Scheduler to run daily/weekly. Pair with a webhook to Slack or email to alert on rating changes. **What if it returns no results?** The `warnings` field explains missing data. If `parse_confidence` < 0.5, Apple may have changed their API format — check the warnings and [file an issue](https://apify.com/bovi/app-store-scraper/issues). App IDs not found in the selected country will be skipped with a warning in the run log. *** ### Common use cases - **ASO (App Store Optimization)** — track competitor ratings and review trends - **Market research** — discover apps in a category, compare developer portfolios - **Sentiment analysis** — feed review text into NLP pipelines - **Competitive intelligence** — monitor rating changes and user feedback for rival apps - **App monitoring** — daily review ingestion with `parse_confidence` alerts *** ### Technical details - **Endpoints used:** - iTunes Lookup API: `https://itunes.apple.com/lookup?id={appId}&country={country}` - iTunes Search API: `https://itunes.apple.com/search?term=...&entity=software` - Reviews RSS (JSON): Apple's customer reviews RSS feed (10 pages × 50 reviews) - **No authentication** — all endpoints are Apple's public APIs - **No proxy** — no CAPTCHA, no IP blocks on these endpoints - **Stack:** Python 3.13 + Apify SDK v2 *** ### Use with AI agents (MCP) This actor is registered in the Apify MCP server. Connect it to Claude, GPT-4, or n8n to let your AI agent pull live App Store data on demand — no manual runs needed. MCP config: `https://mcp.apify.com/?tools=bovi/app-store-scraper` ### Also in this suite - [Google Play Store Scraper](#) — same schema, Android ecosystem - [App Store Reviews Scraper](#) — reviews-only, bulk NLP use case - [App Store Charts Scraper](#) — market surveillance, top charts - [ASO Keyword Rank Tracker](#) — ranking intelligence, 10× cheaper than Sensor Tower - [iOS App Update Tracker](#) — version monitoring, change detection - [F-Droid Scraper](#) — FOSS/privacy research ### Limitations - Reviews capped at 500 per app per country (Apple RSS hard limit) - Search returns up to 200 apps per query (Apple API limit) - Historical reviews beyond the most recent ~500 are not accessible via the public RSS - Paid app prices reflect the storefront specified by `country` ### Integrations Built for ASO managers and mobile researchers monitoring competitor app metadata and review sentiment across countries — the JSON/dataset output drops into the tools you already run, no glue code: - **n8n / Make / Zapier** — trigger a run or pipe every new dataset item into 500+ apps (Google Sheets, Airtable, Slack, HubSpot, your database) with no code: [n8n](https://docs.apify.com/platform/integrations/n8n), [Make](https://docs.apify.com/platform/integrations/make), [Zapier](https://docs.apify.com/platform/integrations/zapier). - **Webhooks** — fire your own endpoint the moment a run finishes, to push results straight into your pipeline ([docs](https://docs.apify.com/platform/integrations/webhooks)). - **MCP server** — expose this actor as a tool to Claude, Cursor, or any [MCP client](https://mcp.apify.com) so an AI agent can pull this data mid-conversation ([guide](https://blog.apify.com/how-to-use-mcp/)). - **API & SDKs** — fetch the dataset as JSON, CSV, or Excel through the Apify REST API or the Python / JS SDKs. See all [Apify integrations](https://apify.com/integrations). # Actor input Schema ## `appIds` (type: `array`): Numeric Apple App Store IDs (e.g. 324684580 for Spotify). Tip: find the ID in the App Store URL: apps.apple.com/us/app/name/id324684580 ## `searchTerms` (type: `array`): Keyword queries to search the App Store (up to 200 results per query). Example: \["meditation", "task manager"] ## `country` (type: `string`): Two-letter ISO country code for the App Store storefront. Examples: us, gb, de, fr, jp, ca, au. ## `maxReviews` (type: `integer`): Maximum customer reviews to fetch per app. Apple's RSS feed caps at 500 (10 pages × 50). Set 0 to fetch all available. ## `includeReviews` (type: `boolean`): If enabled, fetches customer reviews for each app in addition to metadata. Each review is a separate output record. ## `sortBy` (type: `string`): Sort customer reviews by: mostRecent (default) or mostHelpful. ## `maxSearchResults` (type: `integer`): Maximum apps to return per search term. Apple API limit is 200. ## Actor input object example ```json { "appIds": [ "324684580" ], "searchTerms": [], "country": "us", "maxReviews": 50, "includeReviews": true, "sortBy": "mostRecent", "maxSearchResults": 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 = { "appIds": [ "324684580" ], "searchTerms": [], "country": "us", "maxReviews": 50, "includeReviews": true, "sortBy": "mostRecent", "maxSearchResults": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("bovi/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 = { "appIds": ["324684580"], "searchTerms": [], "country": "us", "maxReviews": 50, "includeReviews": True, "sortBy": "mostRecent", "maxSearchResults": 50, } # Run the Actor and wait for it to finish run = client.actor("bovi/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 '{ "appIds": [ "324684580" ], "searchTerms": [], "country": "us", "maxReviews": 50, "includeReviews": true, "sortBy": "mostRecent", "maxSearchResults": 50 }' | apify call bovi/app-store-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bovi/app-store-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Apple App Store Scraper — App Data, Reviews & iTunes API", "description": "Scrape Apple App Store app details and customer reviews via Apple's official iTunes API. No auth, no proxies, zero COGS. Returns app name, developer, price, rating, category, version, and up to 500 reviews per app with parse_confidence. Pay per result.", "version": "0.1", "x-build-id": "lTX7BzNbt2UWEszRi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bovi~app-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bovi-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/bovi~app-store-scraper/runs": { "post": { "operationId": "runs-sync-bovi-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/bovi~app-store-scraper/run-sync": { "post": { "operationId": "run-sync-bovi-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": { "appIds": { "title": "App IDs", "type": "array", "description": "Numeric Apple App Store IDs (e.g. 324684580 for Spotify). Tip: find the ID in the App Store URL: apps.apple.com/us/app/name/id324684580", "items": { "type": "string" } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Keyword queries to search the App Store (up to 200 results per query). Example: [\"meditation\", \"task manager\"]", "items": { "type": "string" } }, "country": { "title": "Country", "type": "string", "description": "Two-letter ISO country code for the App Store storefront. Examples: us, gb, de, fr, jp, ca, au." }, "maxReviews": { "title": "Max reviews per app", "minimum": 0, "maximum": 500, "type": "integer", "description": "Maximum customer reviews to fetch per app. Apple's RSS feed caps at 500 (10 pages × 50). Set 0 to fetch all available." }, "includeReviews": { "title": "Include customer reviews", "type": "boolean", "description": "If enabled, fetches customer reviews for each app in addition to metadata. Each review is a separate output record." }, "sortBy": { "title": "Review sort order", "enum": [ "mostRecent", "mostHelpful" ], "type": "string", "description": "Sort customer reviews by: mostRecent (default) or mostHelpful." }, "maxSearchResults": { "title": "Max search results per term", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum apps to return per search term. Apple API limit is 200." } } }, "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 } } } } } } } } } } ```