Get a Show - Spotify Web API

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

{ "available_markets": [ "string" ], "copyrights": [ { "text": "string", "type": "string" } ], "description": "string", "episodes": { "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 }, "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" }

请求参数

Path 参数

必需

The Spotify ID for the show.

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 a [show object](https://developer.spotify.com/documentation/web-api/reference/#object-showobject) in JSON format. On error, the header status code is an

application/json

Body

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.

text

string

可选

The copyright text for this content.

type

string

可选

The type of copyright: C = the copyright, P = the sound recording (performance) copyright.

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.

episodes

object

可选

A list of the show's episodes.

href

string

可选

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

items

array[object (SimplifiedEpisodeObject) {20}]

可选

The requested data.

limit

integer <int32>

可选

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

string

可选

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

offset

integer <int32>

可选

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

string

可选

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

total

integer <int32>

可选

The total number of items available to return.

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.

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 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.

🔴500500