Get a Show's Episodes

Developing

GET

/shows/{id}/episodes

category-shows

Get Spotify catalog information about an show's episodes. Optional parameters can be used to limit the number of episodes returned.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.spotify.com/v1/shows//episodes' \
--header 'Authorization;'

Response Example

200 - Example 1

{
  "href": "string",
  "items": [
    {
      "audio_preview_url": "string",
      "description": "string",
      "duration_ms": 0,
      "explicit": true,
      "external_urls": {
        "spotify": "string"
      },
      "href": "string",
      "html_description": "string",
      "id": "string",
      "images": [
        {
          "height": 0,
          "url": "string",
          "width": 0
        }
      ],
      "is_externally_hosted": true,
      "is_playable": true,
      "language": "string",
      "languages": [
        "string"
      ],
      "name": "string",
      "release_date": "string",
      "release_date_precision": "string",
      "restrictions": {
        "reason": "string"
      },
      "resume_point": {
        "fully_played": true,
        "resume_position_ms": 0
      },
      "type": "string",
      "uri": "string"
    }
  ],
  "limit": 0,
  "next": "string",
  "offset": 0,
  "previous": "string",
  "total": 0
}

Request

Path Params

string

required

The Spotify ID for the show.

Query Params

market

string

optional

An ISO 3166-1 alpha-2 country code. If a country code is specified, only shows and episodes that are available in that market will be returned.
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.
Note: If neither market or user country are provided, the content is considered unavailable for the client.
Users can view the country that is associated with their account in the account settings.

limit

integer

optional

The maximum number of episodes to return. Default: 20. Minimum: 1. Maximum: 50.

offset

integer

optional

The index of the first episode to return. Default: 0 (the first object). Use with limit to get the next set of episodes.

Header Params

Authorization

string

required

valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details.

Responses

🟢200On success, the HTTP status code in the response header is `200` OK and the response body contains an array of [simplified episode objects](https://developer.spotify.com/documentation/web-api/reference/#object-simplifiedepisodeobject) (wrapped in a [pagin

application/json

Body

href

string

optional

A link to the Web API endpoint returning the full result of the request

items

array[object (SimplifiedEpisodeObject) {20}]

optional

The requested data.

audio_preview_url

string

optional

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

description

string

optional

A description of the episode. HTML tags are stripped away from this field, use html_description field in case HTML tags are needed.

duration_ms

integer <int32>

optional

The episode length in milliseconds.

explicit

boolean

optional

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

external_urls

object (ExternalUrlObject)

optional

href

string

optional

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

html_description

string

optional

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

string

optional

The Spotify ID for the episode.

images

array[object (ImageObject) {3}]

optional

The cover art for the episode in various sizes, widest first.

is_externally_hosted

boolean

optional

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

is_playable

boolean

optional

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

language

string

optional

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

languages

array[string]

optional

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

name

string

optional

The name of the episode.

release_date

string

optional

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

string

optional

The precision with which release_date value is known.

restrictions

object (EpisodeRestrictionObject)

optional

resume_point

object (ResumePointObject)

optional

type

string

optional

The object type.

uri

string

optional

The Spotify URI for the episode.

limit

integer <int32>

optional

The maximum number of items in the response (as set in the query or by default).

string

optional

URL to the next page of items. ( null if none)

offset

integer <int32>

optional

The offset of the items returned (as set in the query or by default)

string

optional

URL to the previous page of items. ( null if none)

total

integer <int32>

optional

The total number of items available to return.

🔴500500

Modified at 2022-09-12 10:04:50

Get a Show