Get User's Saved Shows - Spotify Web API

Get a list of shows saved in the current Spotify user's library. Optional parameters can be used to limit the number of shows returned.

{ "href": "string", "items": [ { "added_at": "2019-08-24T14:15:22Z", "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" } } ], "limit": 0, "next": "string", "offset": 0, "previous": "string", "total": 0 }

请求参数

Query 参数

limit

可选

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

offset

可选

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

Header 参数

Authorization

必需

A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. The access token must have been isued on behalf of the user. The user-libary-read scope must have been authorised by the user.

返回响应

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

application/json

Body

href

string

可选

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

items

array[object (SavedShowObject) {2}]

可选

The requested data.

added_at

string <date-time>

可选

The date and time the show was saved. Timestamps are returned in ISO 8601 format as Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ. If the time is imprecise (for example, the date/time of an album release), an additional field indicates the precision; see for example, release_date in an album object.

show

object (SimplifiedShowObject)

可选

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.

🔴500500