Get Several Episodes
Get Spotify catalog information for several episodes based on their Spotify IDs.
You may not facilitate downloads of Spotify content or enable “stream ripping”
More informationSpotify visual content must be kept in its original form, e.g. you can not crop album artwork, overlay images on album artwork, place a brand/logo on album artwork
More informationPlease keep in mind that metadata, cover art and artist images must be accompanied by a link back to the applicable artist, album, track, or playlist on the Spotify Service. You must also attribute content from Spotify with the logo.
More information
Read your position in content you have played.
Request
- idsstringRequired
A comma-separated list of the Spotify IDs for the episodes. Maximum: 50 IDs.
Example:ids=77o6BIVlYM3msb4MMIL1jH,0Q86acNRm6V9GYx55SXKwf
- marketstring
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.Example:market=ES
Response
A set of episodes
- Required
- audio_preview_urlstringRequiredNullableDeprecated
A URL to a 30 second preview (MP3 format) of the episode.
null
if not available.Important policy noteAudio Preview Clips may not be offered as a standalone service or product.
More information
Example:"https://p.scdn.co/mp3-preview/2f37da1d4221f40b9d1a98cd191f4d6f1646ad17"
- descriptionstringRequired
A description of the episode. HTML tags are stripped away from this field, use
html_description
field in case HTML tags are needed.Example:"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."
- html_descriptionstringRequired
A description of the episode. This field may contain HTML tags.
Example:"<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>"
- duration_msintegerRequired
The episode length in milliseconds.
Example:1686230
- explicitbooleanRequired
Whether or not the episode has explicit content (true = yes it does; false = no it does not OR unknown).
- Required
External URLs for this episode.
- spotifystring
The Spotify URL for the object.
- hrefstringRequired
A link to the Web API endpoint providing full details of the episode.
Example:"https://api.spotify.com/v1/episodes/5Xt5DXGzch68nYYamXrNxZ"
- idstringRequired
The Spotify ID for the episode.
Example:"5Xt5DXGzch68nYYamXrNxZ"
- Required
The cover art for the episode in various sizes, widest first.
- is_externally_hostedbooleanRequired
True if the episode is hosted outside of Spotify's CDN.
- is_playablebooleanRequired
True if the episode is playable in the given market. Otherwise false.
- languagestringDeprecated
The language used in the episode, identified by a ISO 639 code. This field is deprecated and might be removed in the future. Please use the
languages
field instead.Example:"en"
- languagesarray of stringsRequired
A list of the languages used in the episode, identified by their ISO 639-1 code.
Example:["fr","en"]
- namestringRequired
The name of the episode.
Example:"Starting Your Own Podcast: Tips, Tricks, and Advice From Anchor Creators"
- release_datestringRequired
The date the episode was first released, for example
"1981-12-15"
. Depending on the precision, it might be shown as"1981"
or"1981-12"
.Example:"1981-12-15"
- release_date_precisionstringRequired
The precision with which
release_date
value is known.Allowed values:"year"
,"month"
,"day"
Example:"day"
The user's most recent position in the episode. Set if the supplied access token is a user token and has the scope 'user-read-playback-position'.
- fully_playedboolean
Whether or not the episode has been fully played by the user.
- resume_position_msinteger
The user's most recent position in the episode in milliseconds.
- typestringRequired
The object type.
Allowed values:"episode"
- uristringRequired
The Spotify URI for the episode.
Example:"spotify:episode:0zLhl3WsOCQHbe1BPTiHgr"
Included in the response when a content restriction is applied.
- reasonstring
The reason for the restriction. Supported values:
market
- The content item is not available in the given market.product
- The content item is not available for the user's subscription type.explicit
- The content item is explicit and the user's account is set to not play explicit content.
Additional reasons may be added in the future. Note: If you use this field, make sure that your application safely handles unknown values.
- Required
The show on which the episode belongs.
- available_marketsarray of stringsRequired
A list of the countries in which the show can be played, identified by their ISO 3166-1 alpha-2 code.
- Required
The copyright statements of the show.
- descriptionstringRequired
A description of the show. HTML tags are stripped away from this field, use
html_description
field in case HTML tags are needed. - html_descriptionstringRequired
A description of the show. This field may contain HTML tags.
- explicitbooleanRequired
Whether or not the show has explicit content (true = yes it does; false = no it does not OR unknown).
- Required
External URLs for this show.
- spotifystring
The Spotify URL for the object.
- hrefstringRequired
A link to the Web API endpoint providing full details of the show.
- idstringRequired
The Spotify ID for the show.
- Required
The cover art for the show in various sizes, widest first.
- is_externally_hostedbooleanRequired
True if all of the shows episodes are hosted outside of Spotify's CDN. This field might be
null
in some cases. - languagesarray of stringsRequired
A list of the languages used in the show, identified by their ISO 639 code.
- media_typestringRequired
The media type of the show.
- namestringRequired
The name of the episode.
- publisherstringRequired
The publisher of the show.
- typestringRequired
The object type.
Allowed values:"show"
- uristringRequired
The Spotify URI for the show.
- total_episodesintegerRequired
The total number of episodes in the show.
Response sample
{ "episodes": [ { "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.", "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>", "duration_ms": 1686230, "explicit": false, "external_urls": { "spotify": "string" }, "href": "https://api.spotify.com/v1/episodes/5Xt5DXGzch68nYYamXrNxZ", "id": "5Xt5DXGzch68nYYamXrNxZ", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228", "height": 300, "width": 300 } ], "is_externally_hosted": false, "is_playable": false, "language": "en", "languages": ["fr", "en"], "name": "Starting Your Own Podcast: Tips, Tricks, and Advice From Anchor Creators", "release_date": "1981-12-15", "release_date_precision": "day", "resume_point": { "fully_played": false, "resume_position_ms": 0 }, "type": "episode", "uri": "spotify:episode:0zLhl3WsOCQHbe1BPTiHgr", "restrictions": { "reason": "string" }, "show": { "available_markets": ["string"], "copyrights": [ { "text": "string", "type": "string" } ], "description": "string", "html_description": "string", "explicit": false, "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228", "height": 300, "width": 300 } ], "is_externally_hosted": false, "languages": ["string"], "media_type": "string", "name": "string", "publisher": "string", "type": "show", "uri": "string", "total_episodes": 0 } } ]}