Web API •References / Audiobooks / Get User's Saved Audiobooks

Get User's Saved Audiobooks

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

Authorization scopes

Request

limit
integer
The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
Default: limit=20Range: 0 - 50Example: limit=10
offset
integer
The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.
Default: offset=0Example: offset=5

Response

Pages of audiobooks

href
string
Required
A link to the Web API endpoint returning the full result of the request
Example: "https://api.spotify.com/v1/me/shows?offset=0&limit=20"
limit
integer
Required
The maximum number of items in the response (as set in the query or by default).
Example: 20
next
string
Required
Nullable
URL to the next page of items. ( null if none)
Example: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
offset
integer
Required
The offset of the items returned (as set in the query or by default)
Example: 0
previous
string
Required
Nullable
URL to the previous page of items. ( null if none)
Example: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
total
integer
Required
The total number of items available to return.
Example: 4
Required
- Required
  The author(s) for the audiobook.
  name
  string
  The name of the author.
- available_markets
  array of strings
  Required
  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.
  text
  string
  The copyright text for this content.
  type
  string
  The type of copyright: C = the copyright, P = the sound recording (performance) copyright.
- description
  string
  Required
  A description of the audiobook. HTML tags are stripped away from this field, use html_description field in case HTML tags are needed.
- html_description
  string
  Required
  A description of the audiobook. This field may contain HTML tags.
- edition
  string
  The edition of the audiobook.
  Example: "Unabridged"
- explicit
  boolean
  Required
  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.
  spotify
  string
  The Spotify URL for the object.
- href
  string
  Required
  A link to the Web API endpoint providing full details of the audiobook.
- id
  string
  Required
  The Spotify ID for the audiobook.
- Required
  The cover art for the audiobook in various sizes, widest first.
  url
  string
  Required
  The source URL of the image.
  Example: "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228"
  height
  integer
  Required
  Nullable
  The image height in pixels.
  Example: 300
  width
  integer
  Required
  Nullable
  The image width in pixels.
  Example: 300
- languages
  array of strings
  Required
  A list of the languages used in the audiobook, identified by their ISO 639 code.
- media_type
  string
  Required
  The media type of the audiobook.
- name
  string
  Required
  The name of the audiobook.
- Required
  The narrator(s) for the audiobook.
  name
  string
  The name of the Narrator.
- publisher
  string
  Required
  The publisher of the audiobook.
- type
  string
  Required
  The object type.
  Allowed values: "audiobook"
- uri
  string
  Required
  The Spotify URI for the audiobook.
- total_chapters
  integer
  Required
  The number of chapters in this audiobook.

Response sample

{  "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20",  "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": [    {      "authors": [        {          "name": "string"        }      ],      "available_markets": ["string"],      "copyrights": [        {          "text": "string",          "type": "string"        }      ],      "description": "string",      "html_description": "string",      "edition": "Unabridged",      "explicit": false,      "external_urls": {        "spotify": "string"      },      "href": "string",      "id": "string",      "images": [        {          "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228",          "height": 300,          "width": 300        }      ],      "languages": ["string"],      "media_type": "string",      "name": "string",      "narrators": [        {          "name": "string"        }      ],      "publisher": "string",      "type": "audiobook",      "uri": "string",      "total_chapters": 0    }  ]}