v1

latestOpenAPI 3.0.32026-07-148993228.8 KB

Audiobooks

Get an Audiobook

Get Spotify catalog information for a single audiobook.<br /> Note: Audiobooks are only available for the US, UK, Ireland, New Zealand and Australia markets.

get/audiobooks/{id}

Path parameters

idstring required

The Spotify ID for the audiobook.

Example:7iHfbu1YPACw6oZPAFJtqe

Query parameters

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

An Audiobook

available_marketsstring[] required

A list of the countries in which the audiobook can be played, identified by their ISO 3166-1 alpha-2 code.

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.

editionstring

The edition of the audiobook.

explicitboolean required

Whether or not the audiobook has explicit content (true = yes it does; false = no it does not OR unknown).

hrefstring required

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

html_descriptionstring required

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

idstring required

The Spotify ID for the audiobook.

languagesstring[] 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.

publisherstring required

The publisher of the audiobook.

total_chaptersinteger required

The number of chapters in this audiobook.

type'audiobook' required

The object type.

uristring required

The Spotify URI for the audiobook.

Example response

{
  "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"
      }
    ]
  }
}