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.
Access your saved content.
Request
- limitinteger
The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
Example value:10
Default value:20
Range:0
-50
- offsetinteger
The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.
Example value:5
Default value:0
Response
Pages of shows
- hrefstringRequired
A link to the Web API endpoint returning the full result of the request
Example value:"https://api.spotify.com/v1/me/shows?offset=0&limit=20"
- limitintegerRequired
The maximum number of items in the response (as set in the query or by default).
Example value:20
- nextstringRequiredNullable
URL to the next page of items. (
null
if none)Example value:"https://api.spotify.com/v1/me/shows?offset=1&limit=1"
- offsetintegerRequired
The offset of the items returned (as set in the query or by default)
Example value:0
- previousstringRequiredNullable
URL to the previous page of items. (
null
if none)Example value:"https://api.spotify.com/v1/me/shows?offset=1&limit=1"
- totalintegerRequired
The total number of items available to return.
Example value:4
- Required
- added_atstring [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.
Information about the show.