{ "openapi": "3.0.1", "info": { "title": "App Store Scraper - Apple App Details & Search API", "description": "Search the Apple App Store by keyword or look up apps by ID, URL or bundle ID. Returns ratings, rating counts, price, version, release notes, size, genres, languages and screenshots for iPhone, iPad and Mac. Official Apple endpoints, no login, no HTML parsing.", "version": "1.0", "x-build-id": "QOeeC60xK1XFXq5ZR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/appdata-labs~app-store-app-details/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-appdata-labs-app-store-app-details", "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/appdata-labs~app-store-app-details/runs": { "post": { "operationId": "runs-sync-appdata-labs-app-store-app-details", "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/appdata-labs~app-store-app-details/run-sync": { "post": { "operationId": "run-sync-appdata-labs-app-store-app-details", "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": { "searchQuery": { "title": "Search keyword", "type": "string", "description": "What to search the App Store for, exactly as you would type it into the App Store search box. Used only when no specific apps are listed below. Example: \"habit tracker\".", "default": "habit tracker" }, "appStoreUrlsOrIds": { "title": "Specific apps (optional)", "type": "array", "description": "Look up these exact apps instead of searching. Each entry can be an App Store URL (https://apps.apple.com/us/app/notion/id1232780281), a numeric app ID (1232780281), or a bundle ID (com.burbn.instagram). Leave empty to search by keyword instead.", "default": [], "items": { "type": "string" } }, "countries": { "title": "App Store countries", "type": "array", "description": "Two-letter country codes of the App Store storefronts to read. Prices, rankings and availability differ per country, so add more countries to compare them. Examples: us, gb, de, jp, th, br.", "default": [ "us" ], "items": { "type": "string" } }, "maxApps": { "title": "Max apps per country", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many app records to return for each country. Keep this small for fast, cheap runs. Apple returns at most 200 search results per country.", "default": 25 }, "deviceType": { "title": "Device type", "enum": [ "software", "iPadSoftware", "macSoftware" ], "type": "string", "description": "Which App Store catalogue to search. software is iPhone, iPadSoftware is iPad, macSoftware is the Mac App Store. Ignored when looking up specific apps.", "default": "software" }, "includeFullText": { "title": "Include full description text", "type": "boolean", "description": "By default the app description and release notes are shortened to a 600-character preview and screenshots are capped at 3, which keeps each row small enough to pass straight into an AI model. Turn this on to get the complete description, full release notes and every screenshot URL.", "default": 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 } } }, "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 } } } } } } } } } }