Spotify.NET/SpotifyAPI.Docs/docs/SpotifyWebAPI/tracks.md
Will Graham 17639a9b54 Add Audio Track Analysis models and API endpoint (#161)
* Add Audio Track Analysis models and API endpoint

* Update docs

* Add link to EchoNest archived docs for AudioAnalysis model
2017-07-02 19:37:11 +02:00

2.0 KiB

##GetSeveralTracks

Get Spotify catalog information for multiple tracks based on their Spotify IDs.

Paramters

Name Description Example
ids A list of the Spotify IDs for the tracks. Maximum: 50 IDs. new List<String> {"6Y1CLPwYe7zvI8PJiWVz6T"}
market An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking. "DE"

Returns a SeveralTracks object which has one property, List<FullTrack> Tracks

Usage

SeveralTracks severalTracks = _spotify.GetSeveralTracks(new List<String> {"6Y1CLPwYe7zvI8PJiWVz6T"});
severalTracks.Tracks.ForEach(track => Console.WriteLine(track.Name));

##GetTrack

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

Paramters

Name Description Example
id The Spotify ID for the track. "6Y1CLPwYe7zvI8PJiWVz6T"
market An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking. "DE"

Returns a FullTrack

Usage

FullTrack track = _spotify.GetTrack("6Y1CLPwYe7zvI8PJiWVz6T");
Console.WriteLine(track.Name);

##GetAudioAnalysis

Get a detailed audio analysis for a single track identified by its unique Spotify ID.

Paramters

Name Description Example
id The Spotify ID for the track. "6Y1CLPwYe7zvI8PJiWVz6T"

Returns a AudioAnalysis. This object is currently lacking Spotify documentation but archived EchoNest documentation is relevant.

Usage

AudioAnalysis analysis = _spotify.GetAudioAnalysis("6Y1CLPwYe7zvI8PJiWVz6T");
Console.WriteLine(analysis.Meta.DetailedStatus);