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

Modified at 2022-09-12 10:04:50

Remove User's Saved Tracks

Save Tracks for User