GET/apple-podcasts/chartsapiKey1 credit/request
Returns Apple Podcasts show chart rankings for a `collection`, either `toppodcasts` or `topaudiopodcasts`. Narrow with `category` (a numeric Apple podcast genre ID), `country` and `limit`. Each entry has `name`, `artist_name`, `genre`, `genre_id`, `description`, `release_date`, `artwork_url` and `url`.
Optional: collection, category, country, limit.
Sampled 14 Oct 2026: 40 items. Filled in every item: id, name, artist_name, url, description, artwork_url, genre, genre_id and 4 more. Not in every item: artist_url (15). In the sample: release_date: 2026-09-29 to 2026-11-22; name: “The Daily” and 39 other values; artist_url: podcasts.apple.com; free: true in 40 of 40; description: median 601 characters; artist_name: “The New York Times” and 38 other values; url: podcasts.apple.com; artwork_url: is1-ssl.mzstatic.com.
Open in Playground
GET/apple-podcasts/charts/rankingsapiKey1 credit/request
Returns Apple Podcasts chart rankings from the modern podcasts.apple.com charts page, covering chart algorithms (`top`, `top-subscriber`, `top-series`) crossed with entity types (`podcasts`, `podcast-episodes`, `podcast-channels`) and an optional genre filter. A richer, differently-sourced capability than the legacy RSS-based `/apple-podcasts/charts` endpoint.
Optional: chart, type, genre, country, limit.
Sampled 14 Oct 2026: 24 items. Filled in every item: rank, id, kind, name, artist_name, url, artwork_url, genres and 1 more. In the sample: release_date: 2026-10-06 to 2026-11-04; rank: 1 to 24, median 12; name: “The Daily” and 23 other values; url: podcasts.apple.com; genres: median 3 entries; artist_name: “The New York Times” and 22 other values; artwork_url: is1-ssl.mzstatic.com.
Open in Playground
GET/apple-podcasts/episodes/searchapiKey1 credit/request
Searches Apple Podcasts episodes by `term`, which is required. `country`, `lang`, `limit` and `page` (1-based) refine the search. Each episode has its `title`, `show_name`, `show_id`, `description`, `duration_millis`, `release_date`, `episode_url`, `preview_url`, `feed_url`, genres and artwork.
Required: term. Optional: country, lang, limit, page.
Sampled 14 Oct 2026: 40 items. Filled in every item: id, show_id, show_name, title, url, show_url, feed_url, episode_url and 14 more. Not in every item: duration_millis (39). In the sample: release_date: 2017-10-19 to 2026-10-04; show_name: Dan Carlin's Hardcore History:… (23), Dan Carlin's Hardcore History (13), The Lore Vault: Hardcore Histor… (3) and 1 more; duration_millis: 952,000 to 20,752,000, median 5,866,000; title: “Boring History For Sleep | 24 Hours in Ancient Rome (A Day…” and 39 other values; url: podcasts.apple.com; description: median 255 characters; genres: median 1 entry; show_url: itunes.apple.com.
Open in Playground
GET/apple-podcasts/newapiKey1 credit/request
Returns the curated editorial shelves from podcasts.apple.com/{country}/new (New Shows, New Seasons, New Trailers, Essentials, and other seasonal spotlights). Shelves that merely mirror a Charts Rankings query are omitted here since `/apple-podcasts/charts/rankings` already covers that data.
Optional: country.
Sampled 14 Oct 2026: 6 items. Filled in every item: title, items. In the sample: title: median 10 characters; items: median 20 entries.
Open in Playground
GET/apple-podcasts/searchapiKey1 credit/request
Searches Apple Podcasts shows by `term`, which is required. `country`, `lang`, `limit` and `page` (1-based) refine the search. Each show has `collection_name`, `artist_name`, `feed_url`, `primary_genre_name`, `genres`, `track_count`, `release_date`, content advisory rating and several artwork sizes.
Required: term. Optional: country, lang, limit, page.
Sampled 14 Oct 2026: 14 items. Filled in every item: id, artist_name, collection_name, track_name, url, feed_url, artwork_url_30, artwork_url_60 and 12 more. Not in every item: artist_id (2), artist_url (2). In the sample: release_date: 2021-05-26 to 2026-10-19; track_explicitness: cleaned (11), explicit (3); track_count: 1 to 620, median 34; artist_name: “Dan Carlin” and 12 other values; artist_url: podcasts.apple.com; genres: median 3 entries; collection_name: “Dan Carlin's Hardcore History” and 13 other values; track_name: “Dan Carlin's Hardcore History” and 13 other values.
Open in Playground
GET/apple-podcasts/show/{id}apiKey1 credit/request
Returns the details of one Apple Podcasts show by its Apple show `id`: `collection_name`, `artist_name`, `feed_url`, `primary_genre_name`, `genres`, `track_count`, `release_date`, content advisory rating and artwork. `country` and `lang` choose the storefront and language.
Required: id. Optional: country, lang.
Sampled 14 Oct 2026: 22 fields returned with a value. In the sample: release_date: 2026-07-31; track_count: 13; artist_name: “Dan Carlin”; artist_url: podcasts.apple.com; genres: 2 entries; collection_name: “Dan Carlin's Hardcore History”; track_name: “Dan Carlin's Hardcore History”; url: podcasts.apple.com.
Open in Playground
GET/apple-podcasts/show/{id}/episodesapiKey1 credit/request
Returns one Apple Podcasts show by its Apple show `id`, together with a list of its episodes. `limit` sets how many episodes to return; `country` and `lang` choose the storefront and language. Episodes have `title`, `description`, `duration_millis`, `release_date`, `episode_url` and `episode_guid`.
Required: id. Optional: country, lang, limit.
Sampled 14 Oct 2026: 13 items. Filled in every item: id, show_id, show_name, title, url, show_url, feed_url, episode_url and 14 more. Not in every item: duration_millis (12). In the sample: release_date: 2018-07-14 to 2026-07-31; duration_millis: 12,754,000 to 20,752,000, median 15,099,000; title: “Mania for Subjugation IV” and 12 other values; url: podcasts.apple.com; description: median 230 characters; genres: median 1 entry; show_url: itunes.apple.com; feed_url: feeds.feedburner.com.
Open in Playground
GET/apple-podcasts/show/{id}/relatedapiKey1 credit/request
Returns the "You Might Also Like" rail for a single show, sourced from the modern podcasts.apple.com show page's listener-cohort recommendation data.
Required: id. Optional: country, limit.
Sampled 14 Oct 2026: 15 items. Filled in every item: id, name, artist_name, url, artwork_url, genres. In the sample: name: “Common Sense with Dan Carlin” and 14 other values; url: podcasts.apple.com; genres: median 3 entries; artist_name: “Dan Carlin” and 13 other values; artwork_url: is1-ssl.mzstatic.com.
Open in Playground