Get Show Episodes
Get Spotify catalog information about an show’s episodes. Optional parameters can be used to limit the number of episodes returned.
Authorization
oauth_2_0 user-read-playback-positionSpotify supports OAuth 2.0 for authenticating all API requests.
In: header
Scope: user-read-playback-position
Path Parameters
The Spotify ID for the show.
Query Parameters
An ISO 3166-1 alpha-2 country code. If a country code is specified, only content that is available in that market will be returned. If a valid user access token is specified in the request header, the country associated with the user account will take priority over this parameter. Note: If neither market or user country are provided, the content is considered unavailable for the client. Users can view the country that is associated with their account in the account settings.
The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
1 <= value <= 5020The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.
0Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/shows/38bS44xjbVVZ3No3ByF1dJ/episodes"{ "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20\n", "limit": 20, "next": "https://api.spotify.com/v1/me/shows?offset=1&limit=1", "offset": 0, "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1", "total": 4, "items": [ { "audio_preview_url": "https://p.scdn.co/mp3-preview/2f37da1d4221f40b9d1a98cd191f4d6f1646ad17", "description": "A Spotify podcast sharing fresh insights on important topics of the moment—in a way only Spotify can. You’ll hear from experts in the music, podcast and tech industries as we discover and uncover stories about our work and the world around us.\n", "html_description": "<p>A Spotify podcast sharing fresh insights on important topics of the moment—in a way only Spotify can. You’ll hear from experts in the music, podcast and tech industries as we discover and uncover stories about our work and the world around us.</p>\n", "duration_ms": 1686230, "explicit": true, "external_urls": { "spotify": "string" }, "href": "https://api.spotify.com/v1/episodes/5Xt5DXGzch68nYYamXrNxZ", "id": "5Xt5DXGzch68nYYamXrNxZ", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n", "height": 300, "width": 300 } ], "is_externally_hosted": true, "is_playable": true, "language": "en", "languages": [ "fr", "en" ], "name": "Starting Your Own Podcast: Tips, Tricks, and Advice From Anchor Creators\n", "release_date": "1981-12-15", "release_date_precision": "day", "resume_point": { "fully_played": true, "resume_position_ms": 0 }, "type": "episode", "uri": "spotify:episode:0zLhl3WsOCQHbe1BPTiHgr", "restrictions": { "reason": "string" } } ]}Check User's Saved Episodes GET
Check if one or more episodes is already saved in the current Spotify user's 'Your Episodes' library.<br/> This API endpoint is in __beta__ and could change without warning. Please share any feedback that you have, or issues that you discover, in our [developer community forum](https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer)..
Get Available Genre Seeds GET
Retrieve a list of available genres seed parameter values for [recommendations](https://developer.spotify.com/documentation/web-api/reference/get-recommendations).