Get Album Tracks

$ spotted albums list-tracks

GET/albums/{id}/tracks

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

ParametersExpand Collapse

--id: string

The Spotify ID of the album.

--limit: optional number

The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.

minimum1

maximum50

--market: optional string

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

--offset: optional number

The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.

ReturnsExpand Collapse

PagingSimplifiedTrackObject: object { href, limit, next, 5 more }

href: string

A link to the Web API endpoint returning the full result of the request

limit: number

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

offset: number

The 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: number

The total number of items available to return.

items: optional array of SimplifiedTrackObject { id, artists, available_markets, 15 more }

id: optional string

The Spotify ID for the track.

artists: optional array of SimplifiedArtistObject { id, external_urls, href, 4 more }

The artists who performed the track. Each artist object includes a link in href to more detailed information about the artist.

id: optional string

The Spotify ID for the artist.

external_urls: optional object { published, spotify }

Known external URLs for this artist.

published: optional boolean

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

spotify: optional string

The Spotify URL for the object.

href: optional string

A link to the Web API endpoint providing full details of the artist.

name: optional string

The name of the artist.

published: optional boolean

type: optional "artist"

The object type.

uri: optional string

The Spotify URI for the artist.

available_markets: optional array of string

A list of the countries in which the track can be played, identified by their ISO 3166-1 alpha-2 code.

disc_number: optional number

The disc number (usually 1 unless the album consists of more than one disc).

duration_ms: optional number

The track length in milliseconds.

explicit: optional boolean

Whether or not the track has explicit lyrics ( true = yes it does; false = no it does not OR unknown).

external_urls: optional object { published, spotify }

External URLs for this track.

published: optional boolean

spotify: optional string

The Spotify URL for the object.

href: optional string

A link to the Web API endpoint providing full details of the track.

is_local: optional boolean

Whether or not the track is from a local file.

is_playable: optional boolean

Part of the response when Track Relinking is applied. If true, the track is playable in the given market. Otherwise false.

linked_from: optional object { id, external_urls, href, 3 more }

Part of the response when Track Relinking is applied and is only part of the response if the track linking, in fact, exists. The requested track has been replaced with a different track. The track in the linked_from object contains information about the originally requested track.

id: optional string

The Spotify ID for the track.

external_urls: optional object { published, spotify }

Known external URLs for this track.

published: optional boolean

spotify: optional string

The Spotify URL for the object.

href: optional string

A link to the Web API endpoint providing full details of the track.

published: optional boolean

type: optional string

The object type: "track".

uri: optional string

The Spotify URI for the track.

name: optional string

The name of the track.

Deprecatedpreview_url: optional string

A URL to a 30 second preview (MP3 format) of the track.

published: optional boolean

restrictions: optional object { published, reason }

Included in the response when a content restriction is applied.

published: optional boolean

reason: optional string

The reason for the restriction. Supported values:

market - The content item is not available in the given market.
product - The content item is not available for the user's subscription type.
explicit - The content item is explicit and the user's account is set to not play explicit content.

Additional reasons may be added in the future. Note: If you use this field, make sure that your application safely handles unknown values.

track_number: optional number

The number of the track. If an album has several discs, the track number is the number on the specified disc.

type: optional string

The object type: "track".

uri: optional string

The Spotify URI for the track.

published: optional boolean

Get Album Tracks

spotted albums list-tracks \
  --id 4aawyAB9vmqN3uQ7FjRGTy

{
  "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": [
    {
      "id": "id",
      "artists": [
        {
          "id": "id",
          "external_urls": {
            "published": true,
            "spotify": "spotify"
          },
          "href": "href",
          "name": "name",
          "published": true,
          "type": "artist",
          "uri": "uri"
        }
      ],
      "available_markets": [
        "string"
      ],
      "disc_number": 0,
      "duration_ms": 0,
      "explicit": true,
      "external_urls": {
        "published": true,
        "spotify": "spotify"
      },
      "href": "href",
      "is_local": true,
      "is_playable": true,
      "linked_from": {
        "id": "id",
        "external_urls": {
          "published": true,
          "spotify": "spotify"
        },
        "href": "href",
        "published": true,
        "type": "type",
        "uri": "uri"
      },
      "name": "name",
      "preview_url": "preview_url",
      "published": true,
      "restrictions": {
        "published": true,
        "reason": "reason"
      },
      "track_number": 0,
      "type": "type",
      "uri": "uri"
    }
  ],
  "published": true
}

Returns Examples

{
  "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": [
    {
      "id": "id",
      "artists": [
        {
          "id": "id",
          "external_urls": {
            "published": true,
            "spotify": "spotify"
          },
          "href": "href",
          "name": "name",
          "published": true,
          "type": "artist",
          "uri": "uri"
        }
      ],
      "available_markets": [
        "string"
      ],
      "disc_number": 0,
      "duration_ms": 0,
      "explicit": true,
      "external_urls": {
        "published": true,
        "spotify": "spotify"
      },
      "href": "href",
      "is_local": true,
      "is_playable": true,
      "linked_from": {
        "id": "id",
        "external_urls": {
          "published": true,
          "spotify": "spotify"
        },
        "href": "href",
        "published": true,
        "type": "type",
        "uri": "uri"
      },
      "name": "name",
      "preview_url": "preview_url",
      "published": true,
      "restrictions": {
        "published": true,
        "reason": "reason"
      },
      "track_number": 0,
      "type": "type",
      "uri": "uri"
    }
  ],
  "published": true
}