Repository navigation
Tracks APIs
Hong edited this page May 24, 2020
·
3 revisions
Endpoint: spotify/track
Method: GET
Description: This API gets a single tracks info
| Parameters | Format |
|---|---|
| trackId | Spotify track id (String) |
example request URL: https://localhost:3001/spotify/track?trackId=47367567
STATUS CODE: 400 NOT FOUND Authentication Error
STATUS CODE: 200 OK Track object
example response
{
"album": {
"album_type": "single",
"artists": [
{
"external_urls": {
"spotify": "https://open.spotify.com/artist/6sFIWsNpZYqfjUpaCgueju"
},
"href": "https://api.spotify.com/v1/artists/6sFIWsNpZYqfjUpaCgueju",
"id": "6sFIWsNpZYqfjUpaCgueju",
"name": "Carly Rae Jepsen",
"type": "artist",
"uri": "spotify:artist:6sFIWsNpZYqfjUpaCgueju"
}
],
"available_markets": [
"US",
],
"external_urls": {
"spotify": "https://open.spotify.com/album/0tGPJ0bkWOUmH7MEOR77qc"
},
"href": "https://api.spotify.com/v1/albums/0tGPJ0bkWOUmH7MEOR77qc",
"id": "0tGPJ0bkWOUmH7MEOR77qc",
"images": [
{
"height": 640,
"url": "https://i.scdn.co/image/966ade7a8c43b72faa53822b74a899c675aaafee",
"width": 640
},
{
"height": 300,
"url": "https://i.scdn.co/image/107819f5dc557d5d0a4b216781c6ec1b2f3c5ab2",
"width": 300
},
{
"height": 64,
"url": "https://i.scdn.co/image/5a73a056d0af707b4119a883d87285feda543fbb",
"width": 64
}
],
"name": "Cut To The Feeling",
"release_date": "2017-05-26",
"release_date_precision": "day",
"type": "album",
"uri": "spotify:album:0tGPJ0bkWOUmH7MEOR77qc"
},
"artists": [
{
"external_urls": {
"spotify": "https://open.spotify.com/artist/6sFIWsNpZYqfjUpaCgueju"
},
"href": "https://api.spotify.com/v1/artists/6sFIWsNpZYqfjUpaCgueju",
"id": "6sFIWsNpZYqfjUpaCgueju",
"name": "Carly Rae Jepsen",
"type": "artist",
"uri": "spotify:artist:6sFIWsNpZYqfjUpaCgueju"
}
],
"available_markets": [
"AD",
"AR",
],
"disc_number": 1,
"duration_ms": 207959,
"explicit": false,
"external_ids": {
"isrc": "USUM71703861"
},
"external_urls": {
"spotify": "https://open.spotify.com/track/11dFghVXANMlKmJXsNCbNl"
},
"href": "https://api.spotify.com/v1/tracks/11dFghVXANMlKmJXsNCbNl",
"id": "11dFghVXANMlKmJXsNCbNl",
"is_local": false,
"name": "Cut To The Feeling",
"popularity": 63,
"preview_url": "https://p.scdn.co/mp3-preview/3eb16018c2a700240e9dfb8817b6f2d041f15eb1?cid=774b29d4f13844c495f206cafdad9c86",
"track_number": 1,
"type": "track",
"uri": "spotify:track:11dFghVXANMlKmJXsNCbNl"
}
Endpoint: spotify/audio-features
Method: GET
Description: This API gets a single tracks audio features
| Parameters | Format |
|---|---|
| trackId | Spotify track id (String) |
example request URL: https://localhost:3001/spotify/audio-features?trackId=47367567
STATUS CODE: 400 NOT FOUND Authentication Error
STATUS CODE: 200 OK Tracks audio features object
example response
"bars": [
{
"start": 251.98282,
"duration": 0.29765,
"confidence": 0.652
}
],
"beats": [
{
"start": 251.98282,
"duration": 0.29765,
"confidence": 0.652
}
],
"sections": [
{
"start": 237.02356,
"duration": 18.32542,
"confidence": 1,
"loudness": -20.074,
"tempo": 98.253,
"tempo_confidence": 0.767,
"key": 5,
"key_confidence": 0.327,
"mode": 1,
"mode_confidence": 0.566,
"time_signature": 4,
"time_signature_confidence": 1
}
],
"segments": [
{
"start": 252.15601,
"duration": 3.19297,
"confidence": 0.522,
"loudness_start": -23.356,
"loudness_max_time": 0.06971,
"loudness_max": -18.121,
"loudness_end": -60,
"pitches": [
0.709,
0.092,
0.196,
0.084,
0.352,
0.134,
0.161,
1,
0.17,
0.161,
0.211,
0.15
],
"timbre": [
23.312,
-7.374,
-45.719,
294.874,
51.869,
-79.384,
-89.048,
143.322,
-4.676,
-51.303,
-33.274,
-19.037
]
}
],
"tatums": [
{
"start": 251.98282,
"duration": 0.29765,
"confidence": 0.652
}
],
"track": {
"duration": 255.34898,
"sample_md5": "",
"offset_seconds": 0,
"window_seconds": 0,
"analysis_sample_rate": 22050,
"analysis_channels": 1,
"end_of_fade_in": 0,
"start_of_fade_out": 251.73333,
"loudness": -11.84,
"tempo": 98.002,
"tempo_confidence": 0.423,
"time_signature": 4,
"time_signature_confidence": 1,
"key": 5,
"key_confidence": 0.36,
"mode": 0,
"mode_confidence": 0.414,
"codestring": "eJxVnAmS5DgOBL-ST-B9_P9j4x7M6qoxW9tpsZQSCeI...",
"code_version": 3.15,
"echoprintstring": "eJzlvQmSHDmStHslxw4cB-v9j_A-tahhVKV0IH9...",
"echoprint_version": 4.12,
"synchstring": "eJx1mIlx7ToORFNRCCK455_YoE9Dtt-vmrKsK3EBsTY...",
"synch_version": 1,
"rhythmstring": "eJyNXAmOLT2r28pZQuZh_xv7g21Iqu_3pCd160xV...",
"rhythm_version": 1
}
}