Get a Chapter
Get Spotify catalog information for a single chapter.
Note: Chapters are only available for the US, UK, Ireland, New Zealand and Australia markets.
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
Request
- idstringRequired
The Spotify ID for the chapter.
Example value:"0D5wENdkdwbqlrHoaJ9g29"
- 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 value:"ES"
Response
A Chapter
- audio_preview_urlstringRequired
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 value:"https://p.scdn.co/mp3-preview/2f37da1d4221f40b9d1a98cd191f4d6f1646ad17"
- available_marketsarray of strings
A list of the countries in which the chapter can be played, identified by their ISO 3166-1 alpha-2 code.
- chapter_numberintegerRequired
The number of the chapter
Example value:1
- 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 value:"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 value:"<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 value: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 value:"https://api.spotify.com/v1/episodes/5Xt5DXGzch68nYYamXrNxZ"
- idstringRequired
The Spotify ID for the episode.
Example value:"5Xt5DXGzch68nYYamXrNxZ"
- Required
The cover art for the episode in various sizes, widest first.
- urlstringRequired
The source URL of the image.
Example value:"https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228"
- heightintegerRequiredNullable
The image height in pixels.
Example value:300
- widthintegerRequiredNullable
The image width in pixels.
Example value:300
- is_playablebooleanRequired
True if the episode is playable in the given market. Otherwise false.
- languagesarray of stringsRequired
A list of the languages used in the episode, identified by their ISO 639-1 code.
- namestringRequired
The name of the episode.
Example value:"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 value:"1981-12-15"
- release_date_precisionstringRequired
The precision with which
release_date
value is known.Example value:"day"
Allowed values:"year"
,"month"
,"day"
- Required
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 value:"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.payment_required
- Payment is required to play the content item.
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 audiobook for which the chapter belongs.
- Required
The author(s) for the audiobook.
- available_marketsarray of stringsRequired
A list of the countries in which the audiobook can be played, identified by their ISO 3166-1 alpha-2 code.
- Required
The copyright statements of the audiobook.
- descriptionstringRequired
A description of the audiobook. HTML tags are stripped away from this field, use
html_description
field in case HTML tags are needed. - html_descriptionstringRequired
A description of the audiobook. This field may contain HTML tags.
- editionstring
The edition of the audiobook.
Example value:"Unabridged"
- explicitbooleanRequired
Whether or not the audiobook has explicit content (true = yes it does; false = no it does not OR unknown).
- Required
External URLs for this audiobook.
- hrefstringRequired
A link to the Web API endpoint providing full details of the audiobook.
- idstringRequired
The Spotify ID for the audiobook.
- Required
The cover art for the audiobook in various sizes, widest first.
- languagesarray of stringsRequired
A list of the languages used in the audiobook, identified by their ISO 639 code.
- media_typestringRequired
The media type of the audiobook.
- namestringRequired
The name of the audiobook.
- Required
The narrator(s) for the audiobook.
- publisherstringRequired
The publisher of the audiobook.
- typestringRequired
The object type.
Allowed values:"audiobook"
- uristringRequired
The Spotify URI for the audiobook.
- total_chaptersintegerRequired
The number of chapters in this audiobook.