Sign in

v1

latestOpenAPI 3.0.32026-07-148993228.8 KB
Audiobooks

Get Several Audiobooks

Get Spotify catalog information for several audiobooks identified by their Spotify IDs.<br /> Note: Audiobooks are only available for the US, UK, Ireland, New Zealand and Australia markets.

get/audiobooks

Query parameters

idsstring required

A comma-separated list of the Spotify IDs. For example: ids=18yVqkdbdRvS24c0Ilj2ci,1HGw3J3NxZO1TP1BTtVhpZ. Maximum: 50 IDs.

Example:18yVqkdbdRvS24c0Ilj2ci,1HGw3J3NxZO1TP1BTtVhpZ,7iHfbu1YPACw6oZPAFJtqe
marketstring

An ISO 3166-1 alpha-2 country code. If a country code is specified, only content that is available in that market will be returned.<br/> If a valid user access token is specified in the request header, the country associated with the user account will take priority over this parameter.<br/> Note: If neither market or user country are provided, the content is considered unavailable for the client.<br/> Users can view the country that is associated with their account in the account settings.

Example:ES

Response

A set of audiobooks

Example response

{
  "audiobooks": [
    {
      "edition": "Unabridged",
      "images": [
        {
          "height": 300,
          "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
          "width": 300
        }
      ],
      "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",
        "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",
            "chapter_number": 1,
            "description": "A Spotify podcast sharing fresh insights on important topics of the moment—in a way only Spotify can. You’ll hear from experts in the music, podcast and tech industries as we discover and uncover stories about our work and the world around us.\n",
            "duration_ms": 1686230,
            "href": "https://api.spotify.com/v1/episodes/5Xt5DXGzch68nYYamXrNxZ",
            "html_description": "<p>A Spotify podcast sharing fresh insights on important topics of the moment—in a way only Spotify can. You’ll hear from experts in the music, podcast and tech industries as we discover and uncover stories about our work and the world around us.</p>\n",
            "id": "5Xt5DXGzch68nYYamXrNxZ",
            "images": [
              {
                "height": 300,
                "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
                "width": 300
              }
            ],
            "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",
            "uri": "spotify:episode:0zLhl3WsOCQHbe1BPTiHgr"
          }
        ]
      }
    }
  ]
}