{ "openapi": "3.0.1", "info": { "title": "Apple Podcasts API & Scraper — Shows, Episodes & Charts", "description": "Apple Podcasts shows by link, search or top chart (any country and genre) with rating, publisher, genres and feed, plus their episodes with audio links. No login. Unofficial Apple Podcasts API.", "version": "0.1", "x-build-id": "oLX1mI1UccIdoBJdy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/highbrow_fame~apple-podcasts-shows-episodes/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-highbrow_fame-apple-podcasts-shows-episodes", "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/highbrow_fame~apple-podcasts-shows-episodes/runs": { "post": { "operationId": "runs-sync-highbrow_fame-apple-podcasts-shows-episodes", "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/highbrow_fame~apple-podcasts-shows-episodes/run-sync": { "post": { "operationId": "run-sync-highbrow_fame-apple-podcasts-shows-episodes", "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": { "podcasts": { "title": "Podcasts", "type": "array", "description": "Apple Podcasts show links (https://podcasts.apple.com/us/podcast/…/id1200361736) or show ids (1200361736). The store in the link is kept.", "items": { "type": "string" } }, "searchTerms": { "title": "Search words", "type": "array", "description": "What you would type into the Apple Podcasts search: every show found is delivered, in Apple's order (Apple gives up to about 100 shows per search word).", "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max results per search or chart", "minimum": 1, "maximum": 200, "type": "integer", "description": "Stops each search word, chart or episode search after this many results. Charts hold up to 200 shows, searches about 100.", "default": 200 }, "chartCountries": { "title": "Top charts: countries", "type": "array", "description": "Two-letter store codes (us, gb, de, fr, jp…). Delivers each country's Top Shows chart — up to 200 shows, with their rank — for every genre chosen below.", "items": { "type": "string" } }, "chartGenres": { "title": "Top charts: genres", "uniqueItems": true, "type": "array", "description": "Optional. One chart per country and genre. Leave empty for the all-podcasts chart.", "items": { "type": "string", "enum": [ "1301", "1482", "1402", "1459", "1306", "1405", "1406", "1321", "1410", "1493", "1412", "1491", "1492", "1494", "1303", "1496", "1495", "1497", "1304", "1501", "1499", "1498", "1500", "1483", "1486", "1484", "1485", "1511", "1512", "1513", "1514", "1518", "1517", "1515", "1516", "1487", "1305", "1519", "1521", "1522", "1520", "1502", "1510", "1503", "1504", "1506", "1507", "1505", "1508", "1509", "1310", "1523", "1524", "1525", "1489", "1490", "1526", "1531", "1530", "1527", "1529", "1528", "1314", "1438", "1439", "1463", "1440", "1441", "1532", "1444", "1533", "1538", "1539", "1540", "1541", "1536", "1534", "1537", "1542", "1535", "1324", "1543", "1302", "1443", "1320", "1544", "1545", "1549", "1548", "1554", "1560", "1547", "1553", "1550", "1552", "1551", "1546", "1558", "1556", "1557", "1559", "1555", "1318", "1488", "1309", "1562", "1564", "1565", "1563", "1561" ], "enumTitles": [ "Arts", "Arts › Books", "Arts › Design", "Arts › Fashion & Beauty", "Arts › Food", "Arts › Performing Arts", "Arts › Visual Arts", "Business", "Business › Careers", "Business › Entrepreneurship", "Business › Investing", "Business › Management", "Business › Marketing", "Business › Non-Profit", "Comedy", "Comedy › Comedy Interviews", "Comedy › Improv", "Comedy › Stand-Up", "Education", "Education › Courses", "Education › How To", "Education › Language Learning", "Education › Self-Improvement", "Fiction", "Fiction › Comedy Fiction", "Fiction › Drama", "Fiction › Science Fiction", "Government", "Health & Fitness", "Health & Fitness › Alternative Health", "Health & Fitness › Fitness", "Health & Fitness › Medicine", "Health & Fitness › Mental Health", "Health & Fitness › Nutrition", "Health & Fitness › Sexuality", "History", "Kids & Family", "Kids & Family › Education for Kids", "Kids & Family › Parenting", "Kids & Family › Pets & Animals", "Kids & Family › Stories for Kids", "Leisure", "Leisure › Animation & Manga", "Leisure › Automotive", "Leisure › Aviation", "Leisure › Crafts", "Leisure › Games", "Leisure › Hobbies", "Leisure › Home & Garden", "Leisure › Video Games", "Music", "Music › Music Commentary", "Music › Music History", "Music › Music Interviews", "News", "News › Business News", "News › Daily News", "News › Entertainment News", "News › News Commentary", "News › Politics", "News › Sports News", "News › Tech News", "Religion & Spirituality", "Religion & Spirituality › Buddhism", "Religion & Spirituality › Christianity", "Religion & Spirituality › Hinduism", "Religion & Spirituality › Islam", "Religion & Spirituality › Judaism", "Religion & Spirituality › Religion", "Religion & Spirituality › Spirituality", "Science", "Science › Astronomy", "Science › Chemistry", "Science › Earth Sciences", "Science › Life Sciences", "Science › Mathematics", "Science › Natural Sciences", "Science › Nature", "Science › Physics", "Science › Social Sciences", "Society & Culture", "Society & Culture › Documentary", "Society & Culture › Personal Journals", "Society & Culture › Philosophy", "Society & Culture › Places & Travel", "Society & Culture › Relationships", "Sports", "Sports › Baseball", "Sports › Basketball", "Sports › Cricket", "Sports › Fantasy Sports", "Sports › Football", "Sports › Golf", "Sports › Hockey", "Sports › Rugby", "Sports › Running", "Sports › Soccer", "Sports › Swimming", "Sports › Tennis", "Sports › Volleyball", "Sports › Wilderness", "Sports › Wrestling", "Technology", "True Crime", "TV & Film", "TV & Film › After Shows", "TV & Film › Film History", "TV & Film › Film Interviews", "TV & Film › Film Reviews", "TV & Film › TV Reviews" ] } }, "episodeSearchTerms": { "title": "Episode search words", "type": "array", "description": "Find single episodes about a topic, a guest or a brand across all shows (Apple gives up to about 100 episodes per word).", "items": { "type": "string" } }, "country": { "title": "Store country", "type": "string", "description": "Two-letter code of the Apple Podcasts store for the searches, the ratings and the show links without a store: us, gb, de, jp, hu…", "default": "us" }, "maxEpisodesPerPodcast": { "title": "Episodes per podcast", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Also deliver the newest episodes of every show found (0 = shows only). Apple lists the newest 200; beyond that the episodes are read from the show's RSS feed.", "default": 0 }, "episodesFromLastDays": { "title": "Only episodes from the last … days", "minimum": 0, "type": "integer", "description": "Optional: only episodes published in this many days (7 = last week). Also applies to the episode search. 0 = any date.", "default": 0 }, "includeRatings": { "title": "Add rating and description", "type": "boolean", "description": "Reads the top of every show's page for its star rating, number of ratings and description in the chosen store. Adds about a second per show.", "default": true }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches, charts or shows to work on at the same time.", "default": 5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Used only to try again after a network error: the first try goes out directly.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }