{ "openapi": "3.0.1", "info": { "title": "Apple Podcasts Top Charts Scraper (All Countries & Genres)", "description": "Scrape Apple Podcasts top charts for any country and genre, plus podcast search and lookup. Get rank, publisher, RSS feed URL, episode count, latest episode date and recent episodes. Official Apple data, no login.", "version": "0.1", "x-build-id": "PLsSIhdII84ViIPgz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/echolab~apple-podcasts-charts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-echolab-apple-podcasts-charts", "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/echolab~apple-podcasts-charts/runs": { "post": { "operationId": "runs-sync-echolab-apple-podcasts-charts", "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/echolab~apple-podcasts-charts/run-sync": { "post": { "operationId": "run-sync-echolab-apple-podcasts-charts", "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": { "mode": { "title": "Mode", "enum": [ "charts", "search", "lookup" ], "type": "string", "description": "Choose charts, search or lookup.", "default": "charts" }, "countries": { "title": "Chart countries", "type": "array", "description": "Explicit ISO-2 storefront codes. No all shortcut. Availability depends on Apple.", "items": { "type": "string" }, "default": [ "us" ] }, "genres": { "title": "Chart genres", "type": "array", "description": "Apple genre IDs or names; all means overall. Verified main IDs: 26 Podcasts; 1301 Arts; 1321 Business; 1303 Comedy; 1304 Education; 1483 Fiction; 1511 Government; 1512 Health & Fitness; 1487 History; 1305 Kids & Family; 1502 Leisure; 1310 Music; 1489 News; 1314 Religion & Spirituality; 1533 Science; 1324 Society & Culture; 1545 Sports; 1309 TV & Film; 1318 Technology; 1488 True Crime", "items": { "type": "string" }, "default": [ "all" ] }, "limit": { "title": "Results per chart or search", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum entries per chart or search term (Apple may return fewer).", "default": 100 }, "country": { "title": "Search / lookup country", "type": "string", "description": "ISO-2 storefront for search and lookup.", "default": "us" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Required non-empty list in search mode.", "items": { "type": "string" }, "default": [] }, "podcastIds": { "title": "Podcast IDs / URLs", "type": "array", "description": "Required in lookup mode; numeric IDs or podcasts.apple.com URLs.", "items": { "type": "string" }, "default": [] }, "includeLatestEpisodes": { "title": "Latest episodes", "minimum": 0, "maximum": 20, "type": "integer", "description": "Attach up to this many episodes from Apple lookup; never fetches the RSS feed.", "default": 0 }, "requestDelayMs": { "title": "Minimum HTTP request interval", "minimum": 2500, "maximum": 60000, "type": "integer", "description": "Global spacing for all Apple requests, including retries. Minimum 2500 ms protects the shared IP rate limit.", "default": 2500 } } }, "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 } } } } } } } } } }