Get a Track

GET

/tracks/{id}

category-tracks

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

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

200 - 示例 1

{
  "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"
}

请求参数

Path 参数

必需

The Spotify ID for the track.

Query 参数

market

可选

An ISO 3166-1 alpha-2 country code or the string from_token. Provide this parameter if you want to apply Track
Relinking.

Header 参数

Authorization

必需

A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details.

返回响应

🟢200On success, the HTTP status code in the response header is `200` OK and the response body contains a [track object](https://developer.spotify.com/documentation/web-api/reference/#object-trackobject) in JSON format. On error, the header status code is an [

application/json

Body

album

object (SimplifiedAlbumObject)

可选

album_group

string

可选

The field is present when getting an artist's albums. Possible values are "album", "single", "compilation", "appears_on". Compare to album_type this field represents relationship between the artist and the album.

album_type

string

可选

The type of the album: one of "album", "single", or "compilation".

artists

array[object (SimplifiedArtistObject) {6}]

可选

The artists of the album. Each artist object includes a link in href to more detailed information about the artist.

available_markets

array[string]

可选

The markets in which the album is available: ISO 3166-1 alpha-2 country codes. Note that an album is considered available in a market when at least 1 of its tracks is available in that market.

external_urls

object (ExternalUrlObject)

可选

href

string

可选

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

string

可选

The Spotify ID for the album.

images

array[object (ImageObject) {3}]

可选

The cover art for the album in various sizes, widest first.

name

string

可选

The name of the album. In case of an album takedown, the value may be an empty string.

release_date

string

可选

The date the album was first released, for example 1981. Depending on the precision, it might be shown as 1981-12 or 1981-12-15.

release_date_precision

string

可选

The precision with which release_date value is known: year , month , or day.

restrictions

object (AlbumRestrictionObject)

可选

total_tracks

integer <int32>

可选

The total number of tracks in the album.

type

string

可选

The object type: "album"

uri

string

可选

The Spotify URI for the album.

artists

array[object (ArtistObject) {10}]

可选

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

external_urls

object (ExternalUrlObject)

可选

followers

object (FollowersObject)

可选

genres

array[string]

可选

A list of the genres the artist is associated with. For example: "Prog Rock" , "Post-Grunge". (If not yet classified, the array is empty.)

href

string

可选

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

string

可选

The Spotify ID for the artist.

images

array[object (ImageObject) {3}]

可选

Images of the artist in various sizes, widest first.

name

string

可选

The name of the artist.

popularity

integer <int32>

可选

The popularity of the artist. The value will be between 0 and 100, with 100 being the most popular. The artist's popularity is calculated from the popularity of all the artist's tracks.

type

string

可选

The object type: "artist"

uri

string

可选

The Spotify URI for the artist.

available_markets

array[string]

可选

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

disc_number

integer <int32>

可选

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

duration_ms

integer <int32>

可选

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

object (ExternalIdObject)

可选

ean

string

可选

International Article Number

isrc

string

可选

International Standard Recording Code

upc

string

可选

Universal Product Code

external_urls

object (ExternalUrlObject)

可选

href

string

可选

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

string

可选

The Spotify ID for the track.

is_local

boolean

可选

Whether or not the track is from a local file.

is_playable

boolean

可选

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

linked_from

object (LinkedTrackObject)

可选

external_urls

object (ExternalUrlObject)

可选

href

string

可选

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

string

可选

The Spotify ID for the track.

type

string

可选

The object type: "track".

uri

string

可选

The Spotify URI for the track.

name

string

可选

The name of the track.

popularity

integer <int32>

可选

The popularity of the track. The value will be between 0 and 100, with 100 being the most popular.
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.
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 that the popularity value may lag actual popularity by a few days: the value is not updated in real time.

preview_url

string

可选

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

restrictions

object (TrackRestrictionObject)

可选

reason

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

integer <int32>

可选

The 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".

uri

string

可选

The Spotify URI for the track.

🔴500500

Get Several Tracks

Get All Categories