{ "openapi": "3.0.1", "info": { "title": "Apple App Store Scraper: iOS Apps, Ratings & Reviews", "description": "Scrape Apple App Store iOS apps by keyword search, app ID, URL or bundle ID across many countries: ratings, rating counts, price, version history, genres, developer and optional customer reviews. Built on the official iTunes Search and RSS feeds.", "version": "0.1", "x-build-id": "hxzdPzIFZGgKsd76j" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-co~app-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-co-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/api-co~app-store-scraper/runs": { "post": { "operationId": "runs-sync-api-co-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/api-co~app-store-scraper/run-sync": { "post": { "operationId": "run-sync-api-co-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search the App Store for, one per line (e.g. 'habit tracker', 'budget app'). Each term is searched in every selected country and returns apps in Apple's search ranking order.", "items": { "type": "string" } }, "appIds": { "title": "App IDs or App Store URLs", "type": "array", "description": "Specific apps, one per line. Accepts numeric IDs (1232780281), 'id1232780281', App Store URLs (https://apps.apple.com/us/app/notion/id1232780281) or bundle IDs (com.burbn.instagram). Each app is fetched in every selected country.", "items": { "type": "string" } }, "countries": { "title": "Countries (App Store storefronts)", "type": "array", "description": "Two-letter country codes, e.g. us, gb, de, fr, jp, br, in, mx. Every search term and app is fetched in every country, so you can compare prices, ratings and reviews across markets in one run.", "default": [ "us" ], "items": { "type": "string" } }, "platform": { "title": "Platform (for search)", "enum": [ "iphone", "ipad", "mac" ], "type": "string", "description": "Which store to search: iPhone apps, iPad apps or Mac apps. App IDs are looked up regardless of platform.", "default": "iphone" }, "resultsPerSearch": { "title": "Apps per search term (per country)", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many search results to take for each term in each country. Apple returns at most 200.", "default": 50 }, "maxItems": { "title": "Max apps (total)", "minimum": 1, "type": "integer", "description": "Stop after this many app records in total (one app in one country = one record). You are only charged per app record returned.", "default": 100 }, "includeDescription": { "title": "Include full description", "type": "boolean", "description": "Include the full App Store description text. Turn off for smaller datasets.", "default": true }, "includeReviews": { "title": "Include customer reviews", "type": "boolean", "description": "Fetch recent customer reviews for every app from Apple's public reviews feed (rating, title, text, app version, date, reviewer nickname). Each review is charged as one 'review' event.", "default": false }, "maxReviewsPerApp": { "title": "Max reviews per app (per country)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Apple's feed exposes up to the 500 most recent (or most helpful) reviews per app in each country. Add more countries to get more reviews.", "default": 100 }, "reviewsSort": { "title": "Review order", "enum": [ "mostrecent", "mosthelpful" ], "type": "string", "description": "Most recent first, or most helpful first.", "default": "mostrecent" }, "reviewsOutput": { "title": "Review output format", "enum": [ "nested", "rows" ], "type": "string", "description": "nested = a 'reviews' array inside each app record (best for JSON). rows = one dataset row per review (best for CSV/Excel and sentiment tools); the app record is still included.", "default": "nested" } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }