Web API
Spotify for Developers
HomeSDKsAPI ReferenceContext Plugin
Library

Get User's Saved Shows

GET
/me/shows

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.

Authorization

oauth_2_0 user-library-read
AuthorizationBearer <token>

Spotify supports OAuth 2.0 for authenticating all API requests.

In: header

Scope: user-library-read

Query Parameters

limit?Limit

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

Range1 <= value <= 50
Default20
offset?Offset

The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.

Default0

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/me/shows"
{  "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20\n",  "limit": 20,  "next": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",  "offset": 0,  "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",  "total": 4,  "items": [    {      "added_at": "2019-08-24T14:15:22Z",      "show": {        "available_markets": [          "string"        ],        "copyrights": [          {            "text": "string",            "type": "string"          }        ],        "description": "string",        "html_description": "string",        "explicit": true,        "external_urls": {          "spotify": "string"        },        "href": "string",        "id": "string",        "images": [          {            "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",            "height": 300,            "width": 300          }        ],        "is_externally_hosted": true,        "languages": [          "string"        ],        "media_type": "string",        "name": "string",        "publisher": "string",        "type": "show",        "uri": "string",        "total_episodes": 0      }    }  ]}

Create Playlist POST

Create a playlist for a Spotify user. (The playlist will be empty until you [add tracks](https://developer.spotify.com/documentation/web-api/reference/add-tracks-to-playlist).) Each user is generally limited to a maximum of 11000 playlists.

Remove User's Saved Shows DELETE

Delete one or more shows from current Spotify user's library.