{ "openapi": "3.0.1", "info": { "title": "App Store & Podcast Data - 175 Apple storefronts", "description": "Apps, podcasts, music and books from Apple's own public API. One row per item per country, so you can compare price, rating and availability across storefronts in a single run.", "version": "0.1", "x-build-id": "0jnCHWuNaFv46G6cM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/canonrow~app-store-podcast-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-canonrow-app-store-podcast-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/canonrow~app-store-podcast-scraper/runs": { "post": { "operationId": "runs-sync-canonrow-app-store-podcast-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/canonrow~app-store-podcast-scraper/run-sync": { "post": { "operationId": "run-sync-canonrow-app-store-podcast-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": { "terms": { "title": "Search terms", "type": "array", "description": "Words to search Apple's catalogue for, e.g. \"meditation\" or \"budget tracker\". Each term is searched separately in every storefront you list below.", "items": { "type": "string" } }, "ids": { "title": "Apple IDs", "type": "array", "description": "Exact App Store or podcast IDs, e.g. 324684580 (Spotify). More precise than searching, and the right way to track the same item across countries.", "items": { "type": "string" } }, "bundleIds": { "title": "App bundle IDs", "type": "array", "description": "iOS bundle identifiers, e.g. com.spotify.client. Useful when you know the app but not its numeric Apple ID.", "items": { "type": "string" } }, "kind": { "title": "What to look up", "enum": [ "app", "ipadApp", "macApp", "podcast", "song", "album", "ebook", "movie", "audiobook" ], "type": "string", "description": "Which part of Apple's catalogue to query.", "default": "app" }, "countries": { "title": "Storefronts", "type": "array", "description": "Two-letter country codes, e.g. us, gb, jp, th. Every query runs once per storefront and each result is returned as its own row, so price, rating, localised name and availability can be compared side by side. Use the single value \"all\" for the 30 largest storefronts.", "items": { "type": "string" } }, "limitPerTerm": { "title": "Results per term per storefront", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many results each search term returns in each storefront. Ignored for ID and bundle ID lookups, which return one item each.", "default": 25 }, "includePodcastEpisodes": { "title": "Also fetch podcast episodes", "type": "boolean", "description": "For podcasts, follow the RSS feed Apple points to and return individual episodes as extra rows. Only applies when the results are podcasts.", "default": false }, "episodesPerShow": { "title": "Episodes per show", "minimum": 1, "maximum": 300, "type": "integer", "description": "How many recent episodes to return per podcast when the option above is on.", "default": 20 }, "includeDescription": { "title": "Include long description", "type": "boolean", "description": "Keep the full store description on each row. Turn off for a lighter dataset.", "default": true }, "concurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "Apple publishes a rate limit of roughly 20 calls per minute. The Actor paces itself and backs off automatically, so raise this only if you are running small jobs.", "default": 4 } } }, "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 } } } } } } } } } }