> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/spotify/podcast-episodes>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/spotify/podcast-episodes.mdx>

---

# Spotify Podcast Episodes API

A podcast's full episode list, 50 a page, from its Spotify id or share link.

`GET /v1/spotify/podcast/episodes` takes `podcastId` or a public `url` (`https://open.spotify.com/show/…`). Each page holds up to 50 episodes in the podcast's own order (newest first for most podcasts), each with `episodeId`, `title`, `description`, `releaseDate`, `durationMs`, `explicit`, `playable`, `paywalled`, `mediaTypes`, `coverArtUrl`, `previewUrl` and `episodeUrl`. `data.totalCount` is the number of episodes the podcast has.

Pass `page.nextCursor` as `cursor`, with the same podcast, to get the next page; `page.hasMore` is false on the last one. An id that does not resolve answers `lookupStatus: not_found`.

## Request

- **Endpoint:** `GET /v1/spotify/podcast/episodes`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by podcast id or URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/spotify/podcast/episodes/get)
- **Platform page:** [/platforms/spotify](https://www.socialfetch.dev/platforms/spotify)

## FAQ

### How do I list a Spotify podcast's episodes through an API?

Call GET /v1/spotify/podcast/episodes with your Social Fetch API key (x-api-key) and podcastId or a public open.spotify.com/show/… url. Follow page.nextCursor for more pages.

### How much does the Spotify Podcast Episodes API cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.

### How many episodes come back per request?

Up to 50. data.totalCount tells you how many the podcast has, so a 900-episode podcast takes 19 pages.

### Do I get the episode audio?

No. You get each episode's metadata, a short preview URL when Spotify offers one, and its public Spotify link.
