Get User's Saved Albums
Get a list of the albums saved in the current Spotify user's 'Your Music' library.
Authorization
oauth_2_0 user-library-readSpotify supports OAuth 2.0 for authenticating all API requests.
In: header
Scope: user-library-read
Query Parameters
The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
1 <= value <= 5020The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.
0An 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.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/me/albums"{ "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", "album": { "album_type": "compilation", "total_tracks": 9, "available_markets": [ "CA", "BR", "IT" ], "external_urls": { "spotify": "string" }, "href": "string", "id": "2up3OPMp9Tb4dAKM2erWXQ", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n", "height": 300, "width": 300 } ], "name": "string", "release_date": "1981-12", "release_date_precision": "year", "restrictions": { "reason": "market" }, "type": "album", "uri": "spotify:album:2up3OPMp9Tb4dAKM2erWXQ", "artists": [ { "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "name": "string", "type": "artist", "uri": "string" } ], "tracks": { "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": [ { "artists": [ { "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "name": "string", "type": "artist", "uri": "string" } ], "available_markets": [ "string" ], "disc_number": 0, "duration_ms": 0, "explicit": true, "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "is_playable": true, "linked_from": { "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "type": "string", "uri": "string" }, "restrictions": { "reason": "string" }, "name": "string", "preview_url": "string", "track_number": 0, "type": "string", "uri": "string", "is_local": true } ] }, "copyrights": [ { "text": "string", "type": "string" } ], "external_ids": { "isrc": "string", "ean": "string", "upc": "string" }, "genres": [ "Egg punk", "Noise rock" ], "label": "string", "popularity": 0 } } ]}