GET/spotify-podcasts/categoriesapiKey3 credits/request
Returns the Spotify podcast categories page as sections of items such as Arts, for `uri` (default `spotify:page:0JQ5DArNBzkmxXHCqFLx2U`). Each section has a title, `totalCount` and items with title, image and Spotify URL. `page_limit` and `section_limit` default to 10 and run 1 to 50; the offsets default to 0.
Optional: uri, page_offset, page_limit, section_offset, section_limit, include_episode_content_ratings_v2.
Sampled 14 Oct 2026: 8 items. Filled in every item: uri, type, title, totalCount, items. In the sample: totalCount: 1 to 11, median 5; uri: “spotify:section:0JQ5DAwD41j3pUtXUsNyCn” and 7 other values; items: median 5 entries; title: “Arts & Entertainment” and 7 other values.
Open in Playground
GET/spotify-podcasts/chartsapiKey3 credits/request
Returns Spotify podcast chart rankings from podcastcharts.byspotify.com. The chart and region parameters are validated against Spotify's supported podcast chart slugs and countries. Category charts are available only in au, br, de, gb, mx, se, and us.
Optional: chart (20 allowed values: top-podcasts, top-episodes, trending, arts, business, comedy, education, fiction, health-fitness, history, leisure, music, news, religion-spirituality, science, society-culture, sports, technology, true-crime, tv-film), region (26 allowed values: ar, au, at, br, ca, cl, co, dk, fi, fr, de, in, id, ie, it, jp, mx, nz, no, ph, pl, es, se, nl, gb, us), limit.
Sampled 14 Oct 2026: 50 items. Filled in every item: rank, uri, rankMove, name, publisher, imageUrl, description, externalUrl and 6 more. In the sample: rankMove: UNCHANGED (32), UP (10), DOWN (8); rank: 1 to 50, median 25; uri: “spotify:show:353ryGdZNlebaiqkCcy3Yc” and 49 other values; imageUrl: i.scdn.co; description: median 368 characters; name: “Live Free with Josh Howerton” and 49 other values; publisher: “Lakepointe Church” and 44 other values; externalUrl: open.spotify.com.
Open in Playground
GET/spotify-podcasts/episodeapiKey2 credits/request
Returns public episode metadata. Provide either uri or id; defaults to a known public episode when omitted.
Optional: uri, id.
Sampled 14 Oct 2026: 29 fields returned with a value. In the sample: releaseDate: 2026-05-08; durationMs: 9,761,982; uri: “spotify:episode:2C2Y5kNq7qCVOVhbA0G3os”; imageUrl: i.scdn.co; isExplicit: true; description: 529 characters; mediaTypes: 2 entries; type: “Episode”.
Open in Playground
GET/spotify-podcasts/homeapiKey3 credits/request
Returns the Spotify podcasts home page as sections of items, for `uri` (default `spotify:genre:podcasts-web`). Each section has a title and items with type, title, publisher, images and Spotify URL. `page_limit` and `section_limit` default to 10 and run 1 to 50; the offsets default to 0.
Optional: uri, page_offset, page_limit, section_offset, section_limit, include_episode_content_ratings_v2.
Sampled 14 Oct 2026: 2 items. Filled in every item: uri, type, totalCount, items. Not in every item: title (1). In the sample: totalCount: 1 to 9, median 1; uri: “spotify:section:0JQ5DAwD41iTh6T8ay5IzN” and 1 other value; items: median 1 entry; type: “BrowseGridSectionData” and 1 other value; title: “Categories”.
Open in Playground
GET/spotify-podcasts/searchapiKey3 credits/request
Searches Spotify podcasts for `q`, returning matching `shows`, `episodes` and `topResults`, with counts in `meta`. `limit` and `number_of_top_results` run 1 to 50. Optional flags (`include_pre_releases`, `include_audiobooks`, `include_authors`) widen the results. Episodes carry duration and release date; shows carry publisher.
Required: q. Optional: offset, limit, number_of_top_results, include_pre_releases, include_album_pre_releases, include_audiobooks, include_authors, include_episode_content_ratings_v2.
Sampled 14 Oct 2026: 30 items. Filled in every item: uri, type, name, description, releaseDate, durationMs, imageUrl, images and 1 more. Not in every item: isExplicit (4). In the sample: releaseDate: 2024-09-01 to 2026-10-09; durationMs: 187,872 to 7,236,081, median 1,882,592; uri: “spotify:episode:4C818y0PmyB0ZiadQ2CSZy” and 29 other values; imageUrl: i.scdn.co; isExplicit: true in 4 of 4; description: median 873 characters; images: median 3 entries; name: “Hoe gebruik je ChatGPT zonder jezelf kwijt te raken? (met S…” and 29 other values.
Open in Playground
GET/spotify-podcasts/showapiKey2 credits/request
Returns metadata for one Spotify podcast show by `uri` (default `spotify:show:1QQJ7FElLE0K6CIfZNCxU4`): name, publisher, description, media type, explicit flag, `totalEpisodes`, cover images and Spotify URL. The two `include_` flags request extra content capability and content rating fields when Spotify supplies them.
Optional: uri, include_content_capability_trait, include_episode_content_ratings_v2.
Sampled 14 Oct 2026: 3 items. Filled in every item: url, width, height. In the sample: url: i.scdn.co.
Open in Playground
GET/spotify-podcasts/show/episodesapiKey3 credits/request
Returns the episodes of a Spotify podcast by show URI, with `offset` and `limit` (1-50). Each episode has its name, description, release date, duration in milliseconds, explicit and playable flags, Spotify URI, external URL and images; `total` gives the show's episode count.
Optional: uri, offset, limit, include_episode_content_ratings_v2.
Sampled 14 Oct 2026: 40 items. Filled in every item: uri, type, name, description, releaseDate, durationMs, isPlayable, imageUrl and 2 more. In the sample: releaseDate: 2025-05-14 to 2026-09-30; durationMs: 4,113,984 to 9,686,909, median 5,394,560; uri: “spotify:episode:5KXGqN5XKXUR1glKTDlByL” and 39 other values; imageUrl: i.scdn.co; isPlayable: true in 40 of 40; description: median 639 characters; images: median 3 entries; name: “C03 - Ep. 53 - Under Oondar Fire - Headin' to the Weddin'” and 39 other values.
Open in Playground
GET/spotify-podcasts/show/recommendationsapiKey2 credits/request
Lists shows and episodes that Spotify recommends alongside a podcast show given by `uri`. Each recommendation has a type, title, publisher, description, images and Spotify URL, and `meta.count` gives the number returned. The response echoes the show `uri` it was requested for.
Optional: uri.
Sampled 14 Oct 2026: 9 items. Filled in every item: uri, type, title, subtitle, publisher, imageUrl, images, externalUrl. In the sample: uri: “spotify:show:15T8pm3JcVIxSGIebmdKDg” and 8 other values; imageUrl: i.scdn.co; images: median 3 entries; title: “Legends of Avantris” and 8 other values; subtitle: “Avantris Entertainment” and 8 other values; publisher: “Avantris Entertainment” and 8 other values; externalUrl: open.spotify.com.
Open in Playground