Sign in

v1

latestOpenAPI 3.0.32026-07-139687282.9 KB
Episodes

Get Episode

Get Spotify catalog information for a single episode identified by its unique Spotify ID.

get/episodes/{id}

Path parameters

idstring required

The Spotify ID for the episode.

Example:512ojhOuo1ktJprKbVcKyQ

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 episode

audio_preview_urlstring nullable required

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

descriptionstring required

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

duration_msinteger required

The episode length in milliseconds.

explicitboolean required

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

idstring required

The Spotify ID for the episode.

is_externally_hostedboolean required

True if the episode is hosted outside of Spotify's CDN.

is_playableboolean required

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

languagestring

The language used in the episode, identified by a ISO 639 code. This field is deprecated and might be removed in the future. Please use the languages field instead.

languagesstring[] required

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

namestring required

The name of the episode.

release_datestring required

The date the episode 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 episode.

Example response

{
  "audio_preview_url": "https://p.scdn.co/mp3-preview/2f37da1d4221f40b9d1a98cd191f4d6f1646ad17",
  "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",
  "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",
  "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
    }
  ],
  "language": "en",
  "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",
  "show": {
    "images": [
      {
        "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
        "height": 300,
        "width": 300
      }
    ]
  }
}