Spotify Web API

v0.4.0

Spotify Web API v0.4.0 Spotify.Tracks View Source

For manipulating tracks.

Spotify Docs

Link to this section Summary

Types

added_at()

The date and time the track was saved

album()

The album on which the track appears. The album object includes a link in href to full information about the album

artists()

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

available_markets()

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

disc_number()

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

duration_ms()

The track length in milliseconds

explicit()

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

external_ids()

Known external IDs for the track

external_urls()

Known external URLs for this track

href()

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

id()

The Spotify ID for the track

is_playable()

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

linked_from()

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

name()

The name of the track

popularity()

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

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

restrictions()

Part of the response when Track Relinking is applied, the original track is not available in the given market, and Spotify did not have any tracks to relink it with. The track response will still contain metadata for the original track, and a restrictions object containing the reason why the track is not available: "restrictions" : {"reason" : "market"}

track()

Information about the track

track_number()

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

type()

The object type: track

uri()

The Spotify URI for the track

Link to this section Types

Link to this type added_at() View Source 
added_at() :: Spotify.Timestamp.t()

The date and time the track was saved.

Link to this type album() View Source 
album() :: Spotify.Albums.AlbumSimple.t()

The album on which the track appears. The album object includes a link in href to full information about the album.

Link to this type artists() View Source 
artists() :: [Spotify.Artists.ArtistSimple.t()]

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

Link to this type available_markets() View Source 
available_markets() :: [String.t()] | nil

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

Link to this type disc_number() View Source 
disc_number() :: integer()

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

Link to this type duration_ms() View Source 
duration_ms() :: integer()

The track length in milliseconds

Link to this type explicit() View Source 
explicit() :: boolean()

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

Link to this type external_ids() View Source 
external_ids() :: Spotify.ExternalIds.t()

Known external IDs for the track.

Link to this type external_urls() View Source 
external_urls() :: Spotify.ExternalUrls

Known external URLs for this track.

Link to this type href() View Source 
href() :: String.t()

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

Link to this type id() View Source 
id() :: String.t()

The Spotify ID for the track.

Link to this type is_playable() View Source 
is_playable() :: boolean()

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

Link to this type linked_from() View Source 
linked_from() :: Spotify.Tracks.TrackLink.t() | nil

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.

Link to this type name() View Source 
name() :: String.t()

The name of the track.

Link to this type popularity() View Source 
popularity() :: integer()

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.

Link to this type preview_url() View Source 
preview_url() :: String.t()

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

Link to this type restrictions() View Source 
restrictions() :: Spotify.Restrictions.t()

Part of the response when Track Relinking is applied, the original track is not available in the given market, and Spotify did not have any tracks to relink it with. The track response will still contain metadata for the original track, and a restrictions object containing the reason why the track is not available: "restrictions" : {"reason" : "market"}

Link to this type track() View Source 
track() :: Spotify.Tracks.TrackFull.t()

Information about the track.

Link to this type track_number() View Source 
track_number() :: integer()

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

Link to this type type() View Source 
type() :: String.t()

The object type: track.

Link to this type uri() View Source 
uri() :: String.t()

The Spotify URI for the track.