Tracks

Get Track

Changed on

Get Spotify catalog information for a single track identified by its unique Spotify ID.

get/tracks/{id}

Request

  • Base URL
    https://api.spotify.com/v1
  • URL
    https://api.spotify.com/v1/tracks/{id}
  • Auth
    OAuth 2
    Authorization code: https://accounts.spotify.com/authorize
    Token URL: https://accounts.spotify.com/api/token

Path parameters

idstring required

The Spotify ID for the track.

Example:11dFghVXANMlKmJXsNCbNl

Query parameters

marketstring

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.<br/> 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.<br/> Note: If neither market or user country are provided, the content is considered unavailable for the client.<br/> Users can view the country that is associated with their account in the account settings.

Example:ES

Response

A track

available_marketsstring[]

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

disc_numberinteger

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

duration_msinteger

The track length in milliseconds.

explicitboolean

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

hrefstring

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

idstring

The Spotify ID for the track.

is_playableboolean

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

linked_fromobject

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

namestring

The name of the track.

popularityinteger

The popularity of the track. The value will be between 0 and 100, with 100 being the most popular.<br/>The popularity of a track is a value between 0 and 100, with 100 being the most popular. The popularity is calculated by algorithm and is based, in the most part, on the total number of plays the track has had and how recent those plays are.<br/>Generally speaking, songs that are being played a lot now will have a higher popularity than songs that were played a lot in the past. Duplicate tracks (e.g. the same track from a single and an album) are rated independently. Artist and album popularity is derived mathematically from track popularity. Note: the popularity value may lag actual popularity by a few days: the value is not updated in real time.

preview_urlstring nullable

A link to a 30 second preview (MP3 format) of the track. Can be null

track_numberinteger

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

type'track'

The object type: "track".

uristring

The Spotify URI for the track.

is_localboolean

Whether or not the track is from a local file.

Example response

{
  "album": {
    "album_type": "compilation",
    "total_tracks": 9,
    "available_markets": [
      "CA",
      "BR",
      "IT"
    ],
    "id": "2up3OPMp9Tb4dAKM2erWXQ",
    "images": [
      {
        "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
        "height": 300,
        "width": 300
      }
    ],
    "release_date": "1981-12",
    "release_date_precision": "year",
    "uri": "spotify:album:2up3OPMp9Tb4dAKM2erWXQ"
  }
}

Changes

  • 1602059e3988Revision changes
    • info

      response property external_ids reactivated

  • 8899d6fd66eeRevision changes
    • info

      response property album/allOf[SimplifiedAlbumObject]/allOf[AlbumBase]/available_markets deprecated

    • info

      response property available_markets deprecated

    • info

      response property external_ids deprecated

    • info

      response property linked_from deprecated

    • info

      response property popularity deprecated