Get Multiple Shows - Spotify Web API

Get Spotify catalog information for several shows based on their Spotify IDs.

{ "shows": [ { "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" } ] }

请求参数

Query 参数

ids

必需

A comma-separated list of the Spotify IDs for the shows. Maximum: 50 IDs.

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 object whose key is `shows` and whose value is an array of [simple show object](https://developer.spotify.com/documentation/web-api/reference/#object-sim

application/json

Body

shows

array[object (SimplifiedShowObject) {16}]

可选

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.

🔴500500