{ "openapi": "3.0.1", "info": { "title": "App Store Scraper – Reviews, App Details, Search & Top Charts", "description": "Scrape Apple App Store reviews from any country, full app details (ratings, version, size, developer), keyword search rankings and top free / paid / grossing charts by category. Fast, no login, no API key.", "version": "0.1", "x-build-id": "d9siZUM2nIvQfGspr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pardoning_vacation~app-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pardoning_vacation-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/pardoning_vacation~app-store-scraper/runs": { "post": { "operationId": "runs-sync-pardoning_vacation-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/pardoning_vacation~app-store-scraper/run-sync": { "post": { "operationId": "run-sync-pardoning_vacation-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", "required": [ "mode" ], "properties": { "mode": { "title": "What to scrape", "enum": [ "reviews", "apps", "search", "charts" ], "type": "string", "description": "Choose the data you need.", "default": "reviews" }, "apps": { "title": "Apps (for Reviews / App details)", "type": "array", "description": "App Store URLs or numeric app IDs, e.g. https://apps.apple.com/us/app/whatsapp-messenger/id310633997 or 310633997.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter App Store country codes, e.g. us, gb, de, fr, jp. Reviews are collected from every listed country (Apple serves up to 500 recent reviews per country), so adding countries gives more reviews.", "default": [ "us" ], "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Reviews mode only. Total across all countries.", "default": 500 }, "reviewSort": { "title": "Review order", "enum": [ "mostrecent", "mosthelpful" ], "type": "string", "description": "Order in which reviews are collected.", "default": "mostrecent" }, "reviewRating": { "title": "Only reviews with this star rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "1–5 keeps only reviews with that many stars. 0 = all ratings.", "default": 0 }, "searchTerms": { "title": "Search keywords (for Search mode)", "type": "array", "description": "Each keyword returns matching apps in App Store ranking order — useful for ASO.", "items": { "type": "string" } }, "maxSearchResults": { "title": "Max apps per keyword", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many apps to take per keyword.", "default": 50 }, "chart": { "title": "Chart (for Top charts mode)", "enum": [ "topfree", "toppaid", "topgrossing" ], "type": "string", "description": "Which App Store chart to collect.", "default": "topfree" }, "genre": { "title": "Category (for Top charts mode)", "enum": [ "all", "business", "weather", "utilities", "travel", "sports", "social", "reference", "productivity", "photo", "news", "navigation", "music", "lifestyle", "health", "games", "finance", "entertainment", "education", "books", "medical", "magazines", "food", "shopping", "developer", "graphics" ], "type": "string", "description": "App Store category of the chart.", "default": "all" }, "maxChartResults": { "title": "Max apps in chart", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many apps to take from the chart.", "default": 100 }, "includeAppDetails": { "title": "Full app details for charts", "type": "boolean", "description": "Add the complete app record (ratings count, version, description, size, languages...) to chart results.", "default": true } } }, "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 } } } } } } } } } }