Spotify Web API
  1. category-library
Spotify Web API
  • category-albums
    • Get Multiple Albums
      GET
    • Get an Album
      GET
    • Get an Album's Tracks
      GET
  • category-artists
    • Get Multiple Artists
      GET
    • Get an Artist
      GET
    • Get an Artist's Albums
      GET
    • Get an Artist's Related Artists
      GET
    • Get an Artist's Top Tracks
      GET
  • category-tracks
    • Get Audio Analysis for a Track
      GET
    • Get Audio Features for Several Tracks
      GET
    • Get Audio Features for a Track
      GET
    • Get Several Tracks
      GET
    • Get a Track
      GET
  • category-browse
    • Get All Categories
    • Get a Category
    • Get a Category's Playlists
    • Get All Featured Playlists
    • Get All New Releases
    • Get Recommendations
    • Get Recommendation Genres
  • category-episodes
    • Get Multiple Episodes
    • Get an Episode
  • category-markets
    • Get Available Markets
  • category-users-profile
    • Get Current User's Profile
    • Get a User's Profile
  • category-library
    • Remove Albums for Current User
      DELETE
    • Get User's Saved Albums
      GET
    • Save Albums for Current User
      PUT
    • Check User's Saved Albums
      GET
    • Remove User's Saved Episodes
      DELETE
    • Get User's Saved Episodes
      GET
    • Save Episodes for User
      PUT
    • Check User's Saved Episodes
      GET
    • Remove User's Saved Shows
      DELETE
    • Get User's Saved Shows
      GET
    • Save Shows for Current User
      PUT
    • Check User's Saved Shows
      GET
    • Remove User's Saved Tracks
      DELETE
    • Get User's Saved Tracks
      GET
    • Save Tracks for User
      PUT
    • Check User's Saved Tracks
      GET
  • category-follow
    • Unfollow Artists or Users
    • Get User's Followed Artists
    • Follow Artists or Users
    • Get Following State for Artists/Users
    • Unfollow Playlist
    • Follow a Playlist
    • Check if Users Follow a Playlist
  • category-player
    • Get Information About The User's Current Playback
    • Transfer a User's Playback
    • Get the User's Currently Playing Track
    • Get a User's Available Devices
    • Skip User’s Playback To Next Track
    • Pause a User's Playback
    • Start/Resume a User's Playback
    • Skip User’s Playback To Previous Track
    • Add an item to queue
    • Get Current User's Recently Played Tracks
    • Set Repeat Mode On User’s Playback
    • Seek To Position In Currently Playing Track
    • Toggle Shuffle For User’s Playback
    • Set Volume For User's Playback
  • category-playlists
    • Get a List of Current User's Playlists
    • Get a Playlist
    • Change a Playlist's Details
    • Get a Playlist Cover Image
    • Upload a Custom Playlist Cover Image
    • Remove Items from a Playlist
    • Get a Playlist's Items
    • Add Items to a Playlist
    • Reorder or Replace a Playlist's Items
    • Get a List of a User's Playlists
    • Create a Playlist
  • category-personalization
    • Get a User's Top Artists and Tracks
  • category-search
    • Search for an Item
  • category-shows
    • Get Multiple Shows
    • Get a Show
    • Get a Show's Episodes
  1. category-library

Get User's Saved Tracks

Developing
GET
/me/tracks
category-library
Get a list of the songs saved in the current Spotify user's 'Your Music' library.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.spotify.com/v1/me/tracks' \
--header 'Authorization;'
Response Response Example
200 - Example 1
{
    "href": "string",
    "items": [
        {
            "added_at": "2019-08-24T14:15:22Z",
            "track": {
                "album": {
                    "album_group": "string",
                    "album_type": "string",
                    "artists": [
                        {
                            "external_urls": {
                                "spotify": "string"
                            },
                            "href": "string",
                            "id": "string",
                            "name": "string",
                            "type": "string",
                            "uri": "string"
                        }
                    ],
                    "available_markets": [
                        "string"
                    ],
                    "external_urls": {
                        "spotify": "string"
                    },
                    "href": "string",
                    "id": "string",
                    "images": [
                        {
                            "height": 0,
                            "url": "string",
                            "width": 0
                        }
                    ],
                    "name": "string",
                    "release_date": "string",
                    "release_date_precision": "string",
                    "restrictions": {
                        "reason": "string"
                    },
                    "total_tracks": 0,
                    "type": "string",
                    "uri": "string"
                },
                "artists": [
                    {
                        "external_urls": {
                            "spotify": "string"
                        },
                        "followers": {
                            "href": "string",
                            "total": 0
                        },
                        "genres": [
                            "string"
                        ],
                        "href": "string",
                        "id": "string",
                        "images": [
                            {
                                "height": 0,
                                "url": "string",
                                "width": 0
                            }
                        ],
                        "name": "string",
                        "popularity": 0,
                        "type": "string",
                        "uri": "string"
                    }
                ],
                "available_markets": [
                    "string"
                ],
                "disc_number": 0,
                "duration_ms": 0,
                "explicit": true,
                "external_ids": {
                    "ean": "string",
                    "isrc": "string",
                    "upc": "string"
                },
                "external_urls": {
                    "spotify": "string"
                },
                "href": "string",
                "id": "string",
                "is_local": true,
                "is_playable": true,
                "linked_from": {
                    "external_urls": {
                        "spotify": "string"
                    },
                    "href": "string",
                    "id": "string",
                    "type": "string",
                    "uri": "string"
                },
                "name": "string",
                "popularity": 0,
                "preview_url": "string",
                "restrictions": {
                    "reason": "string"
                },
                "track_number": 0,
                "type": "string",
                "uri": "string"
            }
        }
    ],
    "limit": 0,
    "next": "string",
    "offset": 0,
    "previous": "string",
    "total": 0
}

Request

Query Params
market
string 
optional
An ISO 3166-1 alpha-2 country code or the string from_token. Provide this parameter if you want to apply Track Relinking.
limit
integer 
optional
The maximum number of objects to return. Default: 20. Minimum: 1. Maximum: 50.
offset
integer 
optional
The index of the first object to return. Default: 0 (i.e., the first object). Use with limit to get the next set of objects.
Header Params
Authorization
string 
required
A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. The user-library-read scope must have been authorized by the user.

Responses

🟢200On success, the HTTP status code in the response header is `200` OK and the response body contains an array of [saved track objects](https://developer.spotify.com/documentation/web-api/reference/#object-savedtrackobject) (wrapped in a [paging object](http
application/json
Body
href
string 
optional
A link to the Web API endpoint returning the full result of the request
items
array[object (SavedTrackObject) {2}] 
optional
The requested data.
added_at
string <date-time>
optional
The date and time the track 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.
track
object (TrackObject) 
optional
limit
integer <int32>
optional
The maximum number of items in the response (as set in the query or by default).
next
string 
optional
URL to the next page of items. ( null if none)
offset
integer <int32>
optional
The offset of the items returned (as set in the query or by default)
previous
string 
optional
URL to the previous page of items. ( null if none)
total
integer <int32>
optional
The total number of items available to return.
🔴500500
Previous
Remove User's Saved Tracks
Next
Save Tracks for User
Built with