Spotify Web API

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 Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.spotify.com/v1/me/tracks' \
--header 'Authorization;'

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).

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)

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

Remove User's Saved Tracks

Save Tracks for User