Get Several Chapters
chapters.bulk_retrieve(ChapterBulkRetrieveParams**kwargs) -> ChapterBulkRetrieveResponse
GET/chapters
Get Spotify catalog information for several audiobook chapters identified by their Spotify IDs. Chapters are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.
Parameters
Returns
Get Several Chapters
import os
from spotted import Spotted
client = Spotted(
access_token=os.environ.get("SPOTIFY_ACCESS_TOKEN"), # This is the default and can be omitted
)
response = client.chapters.bulk_retrieve(
ids="0IsXVP0JmcB2adSE338GkK,3ZXb8FKZGU0EHALYX6uCzU,0D5wENdkdwbqlrHoaJ9g29",
)
print(response.chapters){
"chapters": [
{
"id": "5Xt5DXGzch68nYYamXrNxZ",
"audio_preview_url": "https://p.scdn.co/mp3-preview/2f37da1d4221f40b9d1a98cd191f4d6f1646ad17",
"audiobook": {
"id": "id",
"authors": [
{
"name": "name",
"published": true
}
],
"available_markets": [
"string"
],
"copyrights": [
{
"published": true,
"text": "text",
"type": "type"
}
],
"description": "description",
"explicit": true,
"external_urls": {
"published": true,
"spotify": "spotify"
},
"href": "href",
"html_description": "html_description",
"images": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
"width": 300,
"published": true
}
],
"languages": [
"string"
],
"media_type": "media_type",
"name": "name",
"narrators": [
{
"name": "name",
"published": true
}
],
"publisher": "publisher",
"total_chapters": 0,
"type": "audiobook",
"uri": "uri",
"edition": "Unabridged",
"published": true
},
"chapter_number": 1,
"description": "We kept on ascending, with occasional periods of quick descent, but in the main always ascending. Suddenly, I became conscious of the fact that the driver was in the act of pulling up the horses in the courtyard of a vast ruined castle, from whose tall black windows came no ray of light, and whose broken battlements showed a jagged line against the moonlit sky.\n",
"duration_ms": 1686230,
"explicit": true,
"external_urls": {
"published": true,
"spotify": "spotify"
},
"href": "https://api.spotify.com/v1/episodes/5Xt5DXGzch68nYYamXrNxZ",
"html_description": "<p>We kept on ascending, with occasional periods of quick descent, but in the main always ascending. Suddenly, I became conscious of the fact that the driver was in the act of pulling up the horses in the courtyard of a vast ruined castle, from whose tall black windows came no ray of light, and whose broken battlements showed a jagged line against the moonlit sky.</p>\n",
"images": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
"width": 300,
"published": true
}
],
"is_playable": true,
"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",
"type": "episode",
"uri": "spotify:episode:0zLhl3WsOCQHbe1BPTiHgr",
"available_markets": [
"string"
],
"published": true,
"restrictions": {
"published": true,
"reason": "reason"
},
"resume_point": {
"fully_played": true,
"published": true,
"resume_position_ms": 0
}
}
]
}Returns Examples
{
"chapters": [
{
"id": "5Xt5DXGzch68nYYamXrNxZ",
"audio_preview_url": "https://p.scdn.co/mp3-preview/2f37da1d4221f40b9d1a98cd191f4d6f1646ad17",
"audiobook": {
"id": "id",
"authors": [
{
"name": "name",
"published": true
}
],
"available_markets": [
"string"
],
"copyrights": [
{
"published": true,
"text": "text",
"type": "type"
}
],
"description": "description",
"explicit": true,
"external_urls": {
"published": true,
"spotify": "spotify"
},
"href": "href",
"html_description": "html_description",
"images": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
"width": 300,
"published": true
}
],
"languages": [
"string"
],
"media_type": "media_type",
"name": "name",
"narrators": [
{
"name": "name",
"published": true
}
],
"publisher": "publisher",
"total_chapters": 0,
"type": "audiobook",
"uri": "uri",
"edition": "Unabridged",
"published": true
},
"chapter_number": 1,
"description": "We kept on ascending, with occasional periods of quick descent, but in the main always ascending. Suddenly, I became conscious of the fact that the driver was in the act of pulling up the horses in the courtyard of a vast ruined castle, from whose tall black windows came no ray of light, and whose broken battlements showed a jagged line against the moonlit sky.\n",
"duration_ms": 1686230,
"explicit": true,
"external_urls": {
"published": true,
"spotify": "spotify"
},
"href": "https://api.spotify.com/v1/episodes/5Xt5DXGzch68nYYamXrNxZ",
"html_description": "<p>We kept on ascending, with occasional periods of quick descent, but in the main always ascending. Suddenly, I became conscious of the fact that the driver was in the act of pulling up the horses in the courtyard of a vast ruined castle, from whose tall black windows came no ray of light, and whose broken battlements showed a jagged line against the moonlit sky.</p>\n",
"images": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
"width": 300,
"published": true
}
],
"is_playable": true,
"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",
"type": "episode",
"uri": "spotify:episode:0zLhl3WsOCQHbe1BPTiHgr",
"available_markets": [
"string"
],
"published": true,
"restrictions": {
"published": true,
"reason": "reason"
},
"resume_point": {
"fully_played": true,
"published": true,
"resume_position_ms": 0
}
}
]
}