Sign in

v1

latestOpenAPI 3.0.32026-07-139687282.9 KB
Audiobooks

Get an Audiobook

Get Spotify catalog information for a single audiobook. Audiobooks are only available within the US, UK, Canada, 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.

html_descriptionstring required

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

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.

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.

type'audiobook' required

The object type.

uristring required

The Spotify URI for the audiobook.

total_chaptersinteger required

The number of chapters in this audiobook.

Example response

{
  "edition": "Unabridged",
  "images": [
    {
      "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
      "height": 300,
      "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": "We kept on ascending, with occasional periods of quick descent, but in the main always ascending. Suddenly, I became conscious of the fact that the driver was in the act of pulling up the horses in the courtyard of a vast ruined castle, from whose tall black windows came no ray of light, and whose broken battlements showed a jagged line against the moonlit sky.\n",
        "html_description": "<p>We kept on ascending, with occasional periods of quick descent, but in the main always ascending. Suddenly, I became conscious of the fact that the driver was in the act of pulling up the horses in the courtyard of a vast ruined castle, from whose tall black windows came no ray of light, and whose broken battlements showed a jagged line against the moonlit sky.</p>\n",
        "duration_ms": 1686230,
        "href": "https://api.spotify.com/v1/episodes/5Xt5DXGzch68nYYamXrNxZ",
        "id": "5Xt5DXGzch68nYYamXrNxZ",
        "images": [
          {
            "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
            "height": 300,
            "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"
      }
    ]
  }
}