VOOZH about

URL: https://developer.spotify.com/documentation/web-api/reference/get-users-saved-audiobooks

⇱ Web API Reference | Spotify for Developers

Skip to content
Reference
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

  • limitinteger

    The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.

    Default: limit=20Range: 0 - 50Example: limit=10
  • offsetinteger

    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

  • hrefstring
    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"
  • limitinteger
    Required

    The maximum number of items in the response (as set in the query or by default).

    Example: 20
  • nextstring
    Required
    Nullable

    URL to the next page of items. ( null if none)

    Example: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
  • offsetinteger
    Required

    The offset of the items returned (as set in the query or by default)

    Example: 0
  • previousstring
    Required
    Nullable

    URL to the previous page of items. ( null if none)

    Example: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
  • totalinteger
    Required

    The total number of items available to return.

    Example: 4
  • Required
    • Required

      The author(s) for the audiobook.

      • namestring

        The name of the author.

    • available_marketsarray of strings
      Required
      Deprecated

      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.

      • textstring

        The copyright text for this content.

      • typestring

        The type of copyright: C = the copyright, P = the sound recording (performance) copyright.

    • descriptionstring
      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_descriptionstring
      Required

      A description of the audiobook. This field may contain HTML tags.

    • editionstring

      The edition of the audiobook.

      Example: "Unabridged"
    • explicitboolean
      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.

    • hrefstring
      Required

      A link to the Web API endpoint providing full details of the audiobook.

    • idstring
      Required

      The Spotify ID for the audiobook.

    • Required

      The cover art for the audiobook in various sizes, widest first.

      • urlstring
        Required

        The source URL of the image.

        Example: "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228"
      • heightinteger
        Required
        Nullable

        The image height in pixels.

        Example: 300
      • widthinteger
        Required
        Nullable

        The image width in pixels.

        Example: 300
    • languagesarray of strings
      Required

      A list of the languages used in the audiobook, identified by their ISO 639 code.

    • media_typestring
      Required

      The media type of the audiobook.

    • namestring
      Required

      The name of the audiobook.

    • Required

      The narrator(s) for the audiobook.

      • namestring

        The name of the Narrator.

    • publisherstring
      Required
      Deprecated

      The publisher of the audiobook.

    • typestring
      Required

      The object type.

      Allowed values: "audiobook"
    • uristring
      Required

      The Spotify URI for the audiobook.

    • total_chaptersinteger
      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}]}