Audiobooks
Get an Audiobook
Get Several Audiobooks
Get Audiobook Chapters
ModelsExpand Collapse
type SimplifiedChapterObject struct{…}
ID string
The Spotify ID for the chapter.
DeprecatedAudioPreviewURL string
A URL to a 30 second preview (MP3 format) of the chapter. null if not available.
ChapterNumber int64
The number of the chapter
Description string
A description of the chapter. HTML tags are stripped away from this field, use html_description field in case HTML tags are needed.
DurationMs int64
The chapter length in milliseconds.
Explicit bool
Whether or not the chapter has explicit content (true = yes it does; false = no it does not OR unknown).
ExternalURLs ExternalURLObject
External URLs for this chapter.
Published booloptional
The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists
Spotify stringoptional
The Spotify URL for the object.
Href string
A link to the Web API endpoint providing full details of the chapter.
HTMLDescription string
A description of the chapter. This field may contain HTML tags.
Images []ImageObject
The cover art for the chapter in various sizes, widest first.
Height int64
The image height in pixels.
URL string
The source URL of the image.
Width int64
The image width in pixels.
Published booloptional
The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists
IsPlayable bool
True if the chapter is playable in the given market. Otherwise false.
Languages []string
A list of the languages used in the chapter, identified by their ISO 639-1 code.
Name string
The name of the chapter.
ReleaseDate string
The date the chapter was first released, for example "1981-12-15". Depending on the precision, it might be shown as "1981" or "1981-12".
ReleaseDatePrecision SimplifiedChapterObjectReleaseDatePrecision
The precision with which release_date value is known.
Type Episode
The object type.
Uri string
The Spotify URI for the chapter.
AvailableMarkets []stringoptional
A list of the countries in which the chapter can be played, identified by their ISO 3166-1 alpha-2 code.
Published booloptional
The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists
Included in the response when a content restriction is applied.
Published booloptional
The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists
Reason stringoptional
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.
The user's most recent position in the chapter. Set if the supplied access token is a user token and has the scope 'user-read-playback-position'.
FullyPlayed booloptional
Whether or not the episode has been fully played by the user.
Published booloptional
The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists
ResumePositionMs int64optional
The user's most recent position in the episode in milliseconds.