Get User's Saved Albums
Get a list of the albums saved in the current Spotify user's 'Your Music' library.
Access your saved content.
Request
- limitinteger
The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
Default:limit=20
Range:0
-50
Example:limit=10
- offsetinteger
The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.
Default:offset=0
Example:offset=5
- marketstring
An ISO 3166-1 alpha-2 country code. If a country code is specified, only content that is 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.Example:market=ES
Response
Pages of albums
- hrefstringRequired
A link to the Web API endpoint returning the full result of the request
Example:"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:20
- nextstringRequiredNullable
URL to the next page of items. (
null
if none)Example:"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:0
- previousstringRequiredNullable
URL to the previous page of items. (
null
if none)Example:"https://api.spotify.com/v1/me/shows?offset=1&limit=1"
- totalintegerRequired
The total number of items available to return.
Example:4
- Required
- added_atstring [date-time]
The date and time the album 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 album.
- album_typestringRequired
The type of the album.
Allowed values:"album"
,"single"
,"compilation"
Example:"compilation"
- total_tracksintegerRequired
The number of tracks in the album.
Example:9
- available_marketsarray of stringsRequired
The markets in which the album is available: ISO 3166-1 alpha-2 country codes. NOTE: an album is considered available in a market when at least 1 of its tracks is available in that market.
Example:["CA","BR","IT"]
- Required
Known external URLs for this album.
- spotifystring
The Spotify URL for the object.
- hrefstringRequired
A link to the Web API endpoint providing full details of the album.
- idstringRequired
The Spotify ID for the album.
Example:"2up3OPMp9Tb4dAKM2erWXQ"
- Required
The cover art for the album in various sizes, widest first.
- namestringRequired
The name of the album. In case of an album takedown, the value may be an empty string.
- release_datestringRequired
The date the album was first released.
Example:"1981-12"
- release_date_precisionstringRequired
The precision with which
release_date
value is known.Allowed values:"year"
,"month"
,"day"
Example:"year"
Included in the response when a content restriction is applied.
- reasonstring
The reason for the restriction. Albums may be restricted if the content is not available in a given market, to the user's subscription type, or when the user's account is set to not play explicit content. Additional reasons may be added in the future.
Allowed values:"market"
,"product"
,"explicit"
- typestringRequired
The object type.
Allowed values:"album"
- uristringRequired
The Spotify URI for the album.
Example:"spotify:album:2up3OPMp9Tb4dAKM2erWXQ"
- Required
The artists of the album. Each artist object includes a link in
href
to more detailed information about the artist. - Required
The tracks of the album.
- hrefstringRequired
A link to the Web API endpoint returning the full result of the request
Example:"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:20
- nextstringRequiredNullable
URL to the next page of items. (
null
if none)Example:"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:0
- previousstringRequiredNullable
URL to the previous page of items. (
null
if none)Example:"https://api.spotify.com/v1/me/shows?offset=1&limit=1"
- totalintegerRequired
The total number of items available to return.
Example:4
- Required
- Required
The copyright statements of the album.
- Required
Known external IDs for the album.
- isrcstring
- eanstring
- upcstring
- genresarray of stringsRequired
A list of the genres the album is associated with. If not yet classified, the array is empty.
Example:["Egg punk","Noise rock"]
- labelstringRequired
The label associated with the album.
- popularityintegerRequired
The popularity of the album. The value will be between 0 and 100, with 100 being the most popular.