{ "openapi": "3.0.1", "info": { "title": "Apple App Store Scraper", "description": "Scrape the Apple App Store: search apps by keyword, get full app details by ID or URL, pull up to 500 reviews per app per country, or grab the Top Free, Top Paid and Top Grossing charts by category. Any country. No API key.", "version": "0.1", "x-build-id": "xUsP1PjX5AzeXlT19" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/labrat011~app-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-labrat011-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/labrat011~app-store-scraper/runs": { "post": { "operationId": "runs-sync-labrat011-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/labrat011~app-store-scraper/run-sync": { "post": { "operationId": "run-sync-labrat011-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": [ "search", "apps", "reviews", "charts" ], "type": "string", "description": "Search: apps matching keywords. Apps: details for app IDs or URLs. Reviews: only reviews for app IDs or URLs. Charts: an App Store top chart.", "default": "search" }, "searchTerms": { "title": "Search terms (Search mode)", "type": "array", "description": "One per line, for example: photo editor, habit tracker, budget app.", "items": { "type": "string" } }, "appIds": { "title": "App IDs or URLs (Apps and Reviews modes)", "type": "array", "description": "Numeric IDs like 389801252, or App Store links like https://apps.apple.com/us/app/instagram/id389801252.", "items": { "type": "string" } }, "chart": { "title": "Chart (Charts mode)", "enum": [ "top-free", "top-paid", "top-grossing", "new-free", "new-paid" ], "type": "string", "description": "Which chart to read. Up to 200 apps.", "default": "top-free" }, "genre": { "title": "Category (Charts mode)", "enum": [ "", "books", "business", "developer-tools", "education", "entertainment", "finance", "food-drink", "games", "graphics-design", "health-fitness", "lifestyle", "magazines", "medical", "music", "navigation", "news", "photo-video", "productivity", "reference", "shopping", "social-networking", "sports", "travel", "utilities", "weather" ], "type": "string", "description": "Limit the chart to one category. Leave empty for all apps.", "default": "" }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter App Store country codes: us, gb, de, jp, br... Each country is scraped separately and gets its own reviews, prices and ranks.", "items": { "type": "string" } }, "maxAppsPerQuery": { "title": "Max apps per search or chart", "minimum": 1, "maximum": 200, "type": "integer", "description": "Up to 200, Apple's limit.", "default": 50 }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Also fetch reviews for every app found. Always on in Reviews mode.", "default": false }, "maxReviewsPerApp": { "title": "Max reviews per app per country", "minimum": 0, "maximum": 500, "type": "integer", "description": "Apple serves up to 500 reviews per app per country. Add more countries to get more reviews.", "default": 100 }, "reviewSort": { "title": "Review order", "enum": [ "mostRecent", "mostHelpful" ], "type": "string", "description": "Most recent is best for monitoring and works with Only reviews after. Most helpful surfaces the reviews other users upvoted.", "default": "mostRecent" }, "reviewRatings": { "title": "Only these star ratings", "type": "array", "description": "Leave empty for all. Pick 1 and 2 to collect complaints.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "reviewsSince": { "title": "Only reviews after", "type": "string", "description": "A date like 2026-09-01. With Most recent order, paging stops at the first older review, so daily syncs only pay for new reviews." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed normally. Apple's public endpoints are used directly.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }