Shows
Get User's Saved 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-readAuthorizationBearer <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.
Range
1 <= value <= 50Default
20offset?Offset
The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.
Default
0Response 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 } } ]}
