Get Spotify catalog information about an album’s tracks. Optional parameters can be used to limit the number of tracks returned.

Endpoint

GET https://api.spotify.com/v1/albums/{id}/tracks

Request Parameters

Path parameter
Value
id
The Spotify ID for the album.

Query parameter
Value
limit
Optional. The maximum number of tracks to return. Default: 20. Minimum: 1. Maximum: 50.
offset
Optional. The index of the first track to return. Default: 0 (the first object). Use with limit to get the next set of tracks.
marketOptional. An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.

Response Format

On success, the HTTP status code in the response header is 200 OK and the response body contains an array of simplified track objects (wrapped in a paging object) in JSON format. On error, the header status code is an error code and the response body contains an error object.

Example Request

curl -X GET "https://api.spotify.com/v1/albums/6akEvsycLGftJxYudPjmqK/tracks?limit=2"
{
  "href": "https://api.spotify.com/v1/albums/6akEvsycLGftJxYudPjmqK/tracks?offset=0&limit=2",
  "items": [ {
    "artists": [ {
      "external_urls": {
        "spotify": "https://open.spotify.com/artist/08td7MxkoHQkXnWAYD8d6Q"
      },
      "href": "https://api.spotify.com/v1/artists/08td7MxkoHQkXnWAYD8d6Q",
      "id": "08td7MxkoHQkXnWAYD8d6Q",
      "name": "Tania Bowra",
      "type": "artist",
      "uri": "spotify:artist:08td7MxkoHQkXnWAYD8d6Q"
    } ],
    "available_markets": [ "AD", "AR", "AT", "AU", "BE", "BG", "BO", "BR", "CA", "CH", "CL", "CO", "CR", "CY", "CZ", "DE", "DK", "DO", "EC", "EE", "ES", "FI", "FR", "GB", "GR", "GT", "HK", "HN", "HU", "IE", "IS", "IT", "LI", "LT", "LU", "LV", "MC", "MT", "MX", "MY", "NI", "NL", "NO", "NZ", "PA", "PE", "PH", "PL", "PT", "PY", "RO", "SE", "SG", "SI", "SK", "SV", "TR", "TW", "US", "UY" ],
    "disc_number": 1,
    "duration_ms": 276773,
    "explicit": false,
    "external_urls": {
      "spotify": "https://open.spotify.com/track/2TpxZ7JUBn3uw46aR7qd6V"
    },
    "href": "https://api.spotify.com/v1/tracks/2TpxZ7JUBn3uw46aR7qd6V",
    "id": "2TpxZ7JUBn3uw46aR7qd6V",
    "name": "All I Want",
    "preview_url": "https://p.scdn.co/mp3-preview/6d00206e32194d15df329d4770e4fa1f2ced3f57",
    "track_number": 1,
    "type": "track",
    "uri": "spotify:track:2TpxZ7JUBn3uw46aR7qd6V"
  }, {
    "artists": [ {
      "external_urls": {
        "spotify": "https://open.spotify.com/artist/08td7MxkoHQkXnWAYD8d6Q"
      },
      "href": "https://api.spotify.com/v1/artists/08td7MxkoHQkXnWAYD8d6Q",
      "id": "08td7MxkoHQkXnWAYD8d6Q",
      "name": "Tania Bowra",
      "type": "artist",
      "uri": "spotify:artist:08td7MxkoHQkXnWAYD8d6Q"
    } ],
    "available_markets": [ "AD", "AR", "AT", "AU", "BE", "BG", "BO", "BR", "CA", "CH", "CL", "CO", "CR", "CY", "CZ", "DE", "DK", "DO", "EC", "EE", "ES", "FI", "FR", "GB", "GR", "GT", "HK", "HN", "HU", "IE", "IS", "IT", "LI", "LT", "LU", "LV", "MC", "MT", "MX", "MY", "NI", "NL", "NO", "NZ", "PA", "PE", "PH", "PL", "PT", "PY", "RO", "SE", "SG", "SI", "SK", "SV", "TR", "TW", "US", "UY" ],
    "disc_number": 1,
    "duration_ms": 247680,
    "explicit": false,
    "external_urls": {
      "spotify": "https://open.spotify.com/track/4PjcfyZZVE10TFd9EKA72r"
    },
    "href": "https://api.spotify.com/v1/tracks/4PjcfyZZVE10TFd9EKA72r",
    "id": "4PjcfyZZVE10TFd9EKA72r",
    "name": "Someday",
    "preview_url": "https://p.scdn.co/mp3-preview/2b15de922bf4f4b8cfe09c8448079b8ff7a45a5f",
    "track_number": 2,
    "type": "track",
    "uri": "spotify:track:4PjcfyZZVE10TFd9EKA72r"
  } ],
  "limit": 2,
  "next": "https://api.spotify.com/v1/albums/6akEvsycLGftJxYudPjmqK/tracks?offset=2&limit=2",
  "offset": 0,
  "previous": null,
  "total": 11
}

Try it in our Web API Console

track object (simplified)

Key
Value Type
Value Description
artists
an array of simple artist objectsThe artists who performed the track. Each artist object includes a link in href to more detailed information about the artist.
available_marketsarray of stringsA list of the countries in which the track can be played, identified by their ISO 3166-1 alpha-2 code.
disc_number
integerThe disc number (usually 1 unless the album consists of more than one disc).
duration_ms
integerThe track length in milliseconds.
explicit
Boolean
Whether or not the track has explicit lyrics (true = yes it does; false = no it does not OR unknown).
external_urlsan external URL objectExternal URLs for this track.
hrefstringA link to the Web API endpoint providing full details of the track.
id
string
The Spotify ID for the track.
is_playablebooleanPart of the response when Track Relinking is applied. If true, the track is playable in the given market. Otherwise false.
linked_froma linked track objectPart of the response when Track Relinking is applied, and the requested track has been replaced with different track. The track in the linked_from object contains information about the originally requested track.
name
string
The name of the track.
preview_url
string
A URL to a 30 second preview (MP3 format) of the track.
track_number
integerThe number of the track. If an album has several discs, the track number is the number on the specified disc.
type
string
The object type: "track".
uristringThe Spotify URI for the track.

paging object

Key
Value Type
Value Description
hrefstringA link to the Web API endpoint returning the full result of the request.
itemsan array of objectsThe requested data.
limitintegerThe maximum number of items in the response (as set in the query or by default).
next
string
URL to the next page of items. (null if none)
offsetintegerThe offset of the items returned (as set in the query or by default).
previous
string
URL to the previous page of items. (null if none)
total
integer
The total number of items available to return.