{ "openapi": "3.0.1", "info": { "title": "Apple App Store Scraper: Reviews, Ratings & In-App Prices", "description": "Apple App Store scraper for iPhone and iPad apps: app reviews, star rating breakdown, in-app purchase prices, privacy labels, top charts and app details in 170+ countries. No API key. Export JSON, CSV, Excel. ASO and competitor research.", "version": "0.1", "x-build-id": "dIrVDKuIHaolalHk7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/daperk~app-store-app-intel/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-daperk-app-store-app-intel", "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/daperk~app-store-app-intel/runs": { "post": { "operationId": "runs-sync-daperk-app-store-app-intel", "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/daperk~app-store-app-intel/run-sync": { "post": { "operationId": "run-sync-daperk-app-store-app-intel", "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": { "apps": { "title": "Apps (IDs or App Store links)", "type": "array", "description": "Paste App Store links like https://apps.apple.com/us/app/instagram/id389801252 or just the number 389801252. One per line.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two letter App Store country codes, like us, gb, mx, es, de, jp. Every app is checked in every country you add (1 result per app per country). Leave empty to use the country in the link, or us.", "items": { "type": "string" } }, "charts": { "title": "Top charts (optional)", "type": "array", "description": "Also pull apps from Apple's official top charts. Example: [{\"chart\": \"top-free\", \"country\": \"us\", \"limit\": 25}]. chart is top-free or top-paid. limit is 1 to 100. Each app found gets a full record with its chart rank." }, "includeReviews": { "title": "Include recent reviews shown on the app page", "type": "boolean", "description": "Adds the reviews Apple shows on the app page (usually 8 to 10 per app per country) with star rating, title, text, date and the developer reply.", "default": true }, "maxReviewsPerApp": { "title": "Max reviews per app per country", "minimum": 0, "maximum": 50, "type": "integer", "description": "0 turns reviews off.", "default": 10 }, "includeReviewerNames": { "title": "Include reviewer nicknames", "type": "boolean", "description": "Off by default to keep personal data out of your dataset. Only turn this on if you have a lawful reason to store nicknames.", "default": false }, "includeDescription": { "title": "Include full app description", "type": "boolean", "description": "Turn off for smaller, faster datasets.", "default": true }, "localLanguage": { "title": "Use the local language of each country", "type": "boolean", "description": "Off (default): pages load in English so every field is filled the same way in every country. Prices always stay in the local currency. On: app names, descriptions and release notes come in the local language, but category and languages may be empty in some countries.", "default": false }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Hard stop. The run ends after this many app records are saved. Protects your budget.", "default": 1000 }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many pages load at the same time. Keep it low to be polite to Apple.", "default": 2 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 5, "maximum": 120, "type": "integer", "description": "Speed limit for page loads.", "default": 40 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed for most runs. Turn on only if you see many failed requests on very large runs." } } }, "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 } } } } } } } } } }