# Spotify Podcast Episodes API (https://www.socialcrawl.dev/platforms/spotify/podcast-episodes)

> Returns episodes for a Spotify podcast. Pass the `cursor` from the previous response to fetch the next page.

TL;DR: `GET /v1/spotify/podcast/episodes` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | no | Spotify podcast (show) ID. |
| `url` | no | Spotify podcast (show) URL. |
| `cursor` | no | Cursor returned by the previous response. Omit for page 1. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/spotify/podcast/episodes" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

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

Send a GET request to /v1/spotify/podcast/episodes with the show's id or url parameter. The response returns a page of episodes as unified JSON, plus a cursor for the next page.

### How does pagination work on the episodes endpoint?

Each response includes a cursor value. Pass it as the cursor parameter on your next request to fetch the following page; omit it to start from page one. Repeat until no cursor is returned.

### What fields does each episode include?

Episodes arrive as a unified PostList — each entry carries the episode title, description, and publish metadata in the same JSON shape SocialCrawl uses across 40+ platforms.

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

Each page request costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card, so a 100-episode show paged 10 at a time costs about 10 credits.

### Can I pass the show URL instead of an ID?

Yes. The endpoint accepts either the show ID or the full open.spotify.com/show URL, so you can chain it directly after /v1/spotify/podcast or /v1/spotify/search results.

See the full Spotify API: https://www.socialcrawl.dev/platforms/spotify

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to list all episodes of a Spotify podcast with an API
- What does the SocialCrawl Spotify Podcast Episodes API return?