Audiobooks

Get User's Saved Audiobooks

GET
/me/audiobooks

Get a list of the audiobooks saved in the current Spotify user's 'Your Music' library.

Authorization

oauth_2_0 user-library-read
AuthorizationBearer <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.

Range1 <= value <= 50
Default20
offset?Offset

The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.

Default0

Response 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"              }            }          ]        }      }    }  ]}