Get an Episode

GET

/episodes/{id}

category-episodes

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

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

200 - 示例 1

{
  "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
  },
  "show": {
    "available_markets": [
      "string"
    ],
    "copyrights": [
      {
        "text": "string",
        "type": "string"
      }
    ],
    "description": "string",
    "explicit": true,
    "external_urls": {
      "spotify": "string"
    },
    "href": "string",
    "html_description": "string",
    "id": "string",
    "images": [
      {
        "height": 0,
        "url": "string",
        "width": 0
      }
    ],
    "is_externally_hosted": true,
    "languages": [
      "string"
    ],
    "media_type": "string",
    "name": "string",
    "publisher": "string",
    "type": "string",
    "uri": "string"
  },
  "type": "string",
  "uri": "string"
}

请求参数

Path 参数

必需

The Spotify ID for the episode.

Query 参数

market

可选

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.

Header 参数

Authorization

必需

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

返回响应

🟢200On success, the HTTP status code in the response header is `200` OK and the response body contains an [episode object](https://developer.spotify.com/documentation/web-api/reference/#object-episodeobject) in JSON format. On error, the header status code

application/json

Body

audio_preview_url

string

可选

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

description

string

可选

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>

可选

The episode length in milliseconds.

explicit

boolean

可选

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

external_urls

object (ExternalUrlObject)

可选

spotify

string

可选

The Spotify URL for the object.

href

string

可选

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

html_description

string

可选

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

string

可选

The Spotify ID for the episode.

images

array[object (ImageObject) {3}]

可选

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

height

integer <int32>

可选

The image height in pixels. If unknown: null or not returned.

url

string

可选

The source URL of the image.

width

integer <int32>

可选

The image width in pixels. If unknown: null or not returned.

is_externally_hosted

boolean

可选

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

is_playable

boolean

可选

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

language

string

可选

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]

可选

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

name

string

可选

The name of the episode.

release_date

string

可选

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

可选

The precision with which release_date value is known: "year", "month", or "day".

restrictions

object (EpisodeRestrictionObject)

可选

reason

string

可选

The reason for the restriction. Supported values:

market - The content item is not available in the given market.

product - The content item is not available for the user's subscription type.

explicit - The content item is explicit and the user's account is set to not play explicit content.
Additional reasons may be added in the future. Note: If you use this field, make sure that your application safely handles unknown values.

resume_point

object (ResumePointObject)

可选

fully_played

boolean

可选

Whether or not the episode has been fully played by the user.

resume_position_ms

integer <int32>

可选

The user's most recent position in the episode in milliseconds.

show

object (SimplifiedShowObject)

可选

available_markets

array[string]

可选

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

copyrights

array[object (CopyrightObject) {2}]

可选

The copyright statements of the show.

description

string

可选

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

explicit

boolean

可选

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

external_urls

object (ExternalUrlObject)

可选

href

string

可选

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

html_description

string

可选

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

string

可选

The Spotify ID for the show.

images

array[object (ImageObject) {3}]

可选

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

is_externally_hosted

boolean

可选

True if all of the show's episodes are hosted outside of Spotify's CDN. This field might be null in some cases.

languages

array[string]

可选

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

media_type

string

可选

The media type of the show.

name

string

可选

The name of the episode.

publisher

string

可选

The publisher of the show.

type

string

可选

The object type: "show".

uri

string

可选

The Spotify URI for the show.

type

string

可选

The object type: "episode".

uri

string

可选

The Spotify URI for the episode.

🔴500500

修改于 2021-08-02 10:49:33

Get Multiple Episodes

Get Available Markets