{ "openapi": "3.0.1", "info": { "title": "Apple App Store Product API | Get App Details, Reviews, Pricing", "description": "API to fetch full Apple App Store product details for any iOS, iPadOS, or macOS app by App Store ID. Returns title, developer, description, version history, price, ratings, screenshots, in-app purchases, supported languages, privacy cards, and sample reviews. Built as an MCP-ready API for AI agents.", "version": "0.1", "x-build-id": "r6w5trDh1uD461xBG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~apple-app-store-product-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-apple-app-store-product-api", "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/johnvc~apple-app-store-product-api/runs": { "post": { "operationId": "runs-sync-johnvc-apple-app-store-product-api", "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/johnvc~apple-app-store-product-api/run-sync": { "post": { "operationId": "run-sync-johnvc-apple-app-store-product-api", "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": [ "product_ids" ], "properties": { "product_ids": { "title": "App Store IDs or URLs", "minItems": 1, "maxItems": 100, "type": "array", "description": "List of Apple App Store product IDs to look up. Each entry can be a numeric App Store ID (e.g. 324684580) or a full App Store URL (e.g. https://apps.apple.com/us/app/spotify/id324684580) - the ID will be parsed automatically. Each parsed ID yields exactly one dataset row. Minimum 1, maximum 100 per run.", "items": { "type": "string" } }, "country": { "title": "Country Store", "enum": [ "us", "gb", "ca", "au", "nz", "ie", "in", "sg", "ph", "my", "de", "fr", "es", "it", "nl", "be", "at", "ch", "se", "no", "dk", "fi", "pt", "pl", "cz", "gr", "hu", "ro", "tr", "ru", "ua", "il", "ae", "sa", "eg", "za", "ng", "ke", "jp", "kr", "cn", "tw", "hk", "th", "id", "vn", "br", "mx", "ar", "cl", "co", "pe" ], "type": "string", "description": "Two-letter country code (ISO 3166-1 alpha-2, lowercase) selecting which App Store region the API queries. The same App Store ID can return different metadata (price, availability, localized text, reviews) per country. Defaults to 'us'.", "default": "us" }, "include_reviews_sample": { "title": "Include Sample Reviews", "type": "boolean", "description": "When true (default), the API returns the small sample of user reviews Apple shows on each product page (typically 3 reviews with rating, title, text, author, date, and developer reply). Set false to slim the row when reviews are not needed.", "default": true }, "include_related_apps": { "title": "Include Related App Lists", "type": "boolean", "description": "When true, the API includes 'You May Also Like' and 'More By This Developer' recommendation lists. Defaults to false because most agent and research use cases do not need them and dropping them keeps each row smaller.", "default": false }, "output_file": { "title": "Local Output File", "type": "string", "description": "Optional filename for a local JSON copy of the raw API results. Used during local development only - has no effect on the dataset." } } }, "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 } } } } } } } } } }