{ "openapi": "3.0.1", "info": { "title": "Apple Podcasts Scraper: Shows, Ratings, Charts & Episodes", "description": "Scrape Apple Podcasts without login: keyword search, show lookup by URL or ID, top charts by country and genre, star ratings with counts and histogram, RSS feed URL, and full episode archives with audio URLs, duration and transcript links. $0.50 per 1,000 podcasts, $0.20 per 1,000 episodes.", "version": "1.0", "x-build-id": "YBtN4cWlDb8VkRxXX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/best_apis~apple-podcasts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-best_apis-apple-podcasts-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/best_apis~apple-podcasts-scraper/runs": { "post": { "operationId": "runs-sync-best_apis-apple-podcasts-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/best_apis~apple-podcasts-scraper/run-sync": { "post": { "operationId": "run-sync-best_apis-apple-podcasts-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": { "searchTerms": { "title": "Search podcasts", "type": "array", "description": "Keywords to search Apple Podcasts (e.g. true crime, AI, marketing). Up to 200 results per term and country, in Apple's ranking order.", "items": { "type": "string" } }, "podcasts": { "title": "Podcast URLs or IDs", "type": "array", "description": "Apple Podcasts show links (https://podcasts.apple.com/us/podcast/.../id1434243584) or numeric IDs. Looked up in bulk.", "items": { "type": "string" } }, "chart": { "title": "Top chart", "enum": [ "", "top" ], "type": "string", "description": "Add Apple's Top Podcasts chart for each country (rank 1 to 200). With empty input the Actor returns today's US top 20.", "default": "" }, "chartGenre": { "title": "Chart genre", "enum": [ "", "1301", "1321", "1303", "1304", "1483", "1511", "1512", "1487", "1305", "1502", "1310", "1489", "1314", "1533", "1324", "1545", "1318", "1488", "1309" ], "type": "string", "description": "Optional genre for the top chart.", "default": "" }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter store countries (us, gb, de, fr, in, br...). Search, lookup and charts run once per country.", "default": [ "us" ], "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Max results per search / chart", "minimum": 1, "maximum": 200, "type": "integer", "description": "Per search term and per chart, per country (Apple's maximum is 200).", "default": 50 }, "includeRatings": { "title": "Include ratings", "type": "boolean", "description": "Add star rating, number of ratings, 1-5 star histogram and update frequency from the public show page.", "default": true }, "includeEpisodes": { "title": "Include episodes", "type": "boolean", "description": "Add episode rows for every podcast found, from the show's public RSS feed (full archive: audio URL, duration, season and episode number, transcript and chapter links), with Apple's index as fallback.", "default": false }, "maxEpisodesPerPodcast": { "title": "Max episodes per podcast", "minimum": 1, "type": "integer", "description": "Newest episodes first.", "default": 50 }, "episodesPublishedAfter": { "title": "Episodes published after", "type": "string", "description": "Optional. Only episodes newer than this: a date (2026-01-01) or a relative time like \"7 days\", \"3 months\"." }, "maxItems": { "title": "Max rows in total", "minimum": 1, "type": "integer", "description": "Hard cap for the whole run (podcasts + episodes), so cost stays predictable.", "default": 5000 } } }, "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 } } } } } } } } } }