{ "openapi": "3.0.1", "info": { "title": "App Store Apps Scraper — Search, Top Charts & App Details", "description": "Apple App Store scraper: find apps by keyword, app ID, bundle ID, URL, developer or Top Free / Top Paid chart in any country and get price, rating, ratings count, category, version, update date, size, age rating, languages, icon and description as flat JSON. No API key. From US$2.40 per 1,000 apps.", "version": "0.1", "x-build-id": "lP2CrTyG8Igvf9xfc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fabrikit~app-store-apps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fabrikit-app-store-apps-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/fabrikit~app-store-apps-scraper/runs": { "post": { "operationId": "runs-sync-fabrikit-app-store-apps-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/fabrikit~app-store-apps-scraper/run-sync": { "post": { "operationId": "run-sync-fabrikit-app-store-apps-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 in the App Store, one search per entry (for example: weather, photo editor, budget planner). Apple returns at most 200 apps per term; the position of each app in the results is saved as `position`.", "items": { "type": "string" } }, "appIds": { "title": "App IDs, bundle IDs, URLs or developers", "type": "array", "description": "Specific apps: numeric App Store IDs (407558537 or id407558537), bundle IDs (com.spotify.client), App Store URLs (https://apps.apple.com/us/app/capital-one-mobile/id407558537) or developer URLs (https://apps.apple.com/us/developer/capital-one/id339644101 = every app of that developer). A plain app name is resolved to the top search match. The country in a URL overrides the Store country below.", "items": { "type": "string" } }, "charts": { "title": "Top charts", "type": "array", "description": "Read Apple's top charts for the Store country: Top Free and/or Top Paid apps (up to 100 entries each, `chartRank` is saved on every record).", "items": { "type": "string", "enum": [ "top-free", "top-paid" ], "enumTitles": [ "Top Free apps", "Top Paid apps" ] } }, "chartSize": { "title": "Chart size", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many ranked apps to read from each chart (1 to 100, Apple's maximum).", "default": 50 }, "country": { "title": "Store country", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Two-letter App Store country code (us, gb, de, fr, es, br, mx, jp, in, ...). Prices, currency, ratings and charts are specific to each storefront.", "default": "us" }, "platform": { "title": "Platform", "enum": [ "iphone", "ipad", "mac" ], "type": "string", "description": "Which catalogue to search: iPhone apps (also universal iPad apps), iPad apps or Mac apps. Charts are always the iPhone charts.", "default": "iphone" }, "fullDescription": { "title": "Full description", "type": "boolean", "description": "Save the complete store description instead of the first 1,000 characters.", "default": false }, "maxItems": { "title": "Maximum apps", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many apps in total (exact; duplicates across sources are skipped and not charged).", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings. Apple's endpoints normally work from datacenter IPs; if they answer with their per-IP rate limit (HTTP 403/429) the Actor retries with backoff and switches to a residential proxy in the Store country.", "default": { "useApifyProxy": 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 } } } } } } } } } }