Audiobooks
Get User's Saved Audiobooks
Get a list of the audiobooks saved in the current Spotify user's 'Your Music' library.
Authorization
oauth_2_0 user-library-readAuthorizationBearer <token>
Spotify supports OAuth 2.0 for authenticating all API requests.
In: header
Scope: user-library-read
Query Parameters
limit?Limit
The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
Range
1 <= value <= 50Default
20offset?Offset
The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.
Default
0Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/me/audiobooks"{ "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": [ { "added_at": "2019-08-24T14:15:22Z", "audiobook": { "authors": [ { "name": "string" } ], "available_markets": [ "string" ], "copyrights": [ { "text": "string", "type": "string" } ], "description": "string", "html_description": "string", "edition": "Unabridged", "explicit": true, "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n", "height": 300, "width": 300 } ], "languages": [ "string" ], "media_type": "string", "name": "string", "narrators": [ { "name": "string" } ], "publisher": "string", "type": "audiobook", "uri": "string", "total_chapters": 0, "chapters": { "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", "available_markets": [ "string" ], "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", "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", "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_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", "resume_point": { "fully_played": true, "resume_position_ms": 0 }, "type": "episode", "uri": "spotify:episode:0zLhl3WsOCQHbe1BPTiHgr", "restrictions": { "reason": "string" } } ] } } } ]}
