Skip to content
Web APIReferences / 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.