Shows · GET
Show episodes
GET /shows/{id}/episodes
About
Show episodes is a GET endpoint in the Shows group of the Spotify Data API. It takes 3 parameters: id in the path (required), plus offset and limit (optional). No recorded sample exists for it; press Run to fetch a live response.
Parameters 3
- id Required
- In
- path
- Default
- —
- offset Optional
- In
- query
- Default
- 0
- limit Optional
- In
- query
- Default
- 10
Request
Against https://spotify-proxy.checkleaked.cc, with the same example values the Run button sends.
| curl -X GET \ |
| "https://spotify-proxy.checkleaked.cc/shows/4rOoJ6Egrf8K2IrywzwOMk/episodes?offset=0&limit=10" \ |
| -H "x-api-key: $SPOTIFY_API_KEY" |
Sample response
Live only
This endpoint has no recorded sample. Press Run to fetch a real response.
Errors
- 400
- “id” is required — a request that omits it, or sends a value of the wrong type, is rejected before it reaches Spotify.
- 404
- No Spotify item exists for the “id” that was sent. Spotify ids are 22 characters of base62, so a share link has to be reduced to the id in it first.
- 401 / 403
- The key is missing, wrong, or on a plan that does not include this endpoint. On RapidAPI the header is X-RapidAPI-Key; on the Direct Portal it is an Authorization: Bearer token; on Apify the actor supplies it.
- 429
- Rate limited. The demo on this site allows 100 requests per 15 minutes and 500 per day per visitor, inside a budget shared by every visitor. With a key it is 5 requests per second on every RapidAPI plan and 10 per second on the Direct Portal.
- 5xx
- Spotify itself failed or timed out. These are transient; retry once with a short backoff rather than immediately.
Related endpoints
The other 2 operations in the Shows group.