v1

latestOpenAPI 3.0.32026-07-139687282.9 KB

Chapters

Get a Chapter

Get Spotify catalog information for a single audiobook chapter. Chapters are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.

get/chapters/{id}

Path parameters

idstring required

The Spotify ID for the chapter.

Example:0D5wENdkdwbqlrHoaJ9g29

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

A Chapter

audio_preview_urlstring nullable required

A URL to a 30 second preview (MP3 format) of the chapter. null if not available.

available_marketsstring[]

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

chapter_numberinteger required

The number of the chapter

descriptionstring required

A description of the chapter. 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 chapter. This field may contain HTML tags.

duration_msinteger required

The chapter length in milliseconds.

explicitboolean required

Whether or not the chapter 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 chapter.

idstring required

The Spotify ID for the chapter.

is_playableboolean required

True if the chapter is playable in the given market. Otherwise false.

languagesstring[] required

A list of the languages used in the chapter, identified by their ISO 639-1 code.

namestring required

The name of the chapter.

release_datestring required

The date the chapter was first released, for example "1981-12-15". Depending on the precision, it might be shown as "1981" or "1981-12".

release_date_precision'year' | 'month' | 'day' required

The precision with which release_date value is known.

type'episode' required

The object type.

uristring required

The Spotify URI for the chapter.

Example response

{
  "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",
  "audiobook": {
    "edition": "Unabridged",
    "images": [
      {
        "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
        "height": 300,
        "width": 300
      }
    ]
  }
}