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.
Example value: 10Default value: 20Range: 0 - 50
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.
Example value: 5Default value: 0

Response

Pages of audiobooks

href
string
Required
A link to the Web API endpoint returning the full result of the request
Example value: "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 value: 20
next
string
Required
Nullable
URL to the next page of items. ( null if none)
Example value: "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 value: 0
previous
string
Required
Nullable
URL to the previous page of items. ( null if none)
Example value: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
total
integer
Required
The total number of items available to return.
Example value: 4
Required
- Required
  The author(s) for the audiobook.
- 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.
- 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 value: "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.
- 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.
- 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.
- 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.