SPOTIFY API
Track
Retrieve track from Spotify with a single API request.
GET
/api/data/v1/spotify/track1credit base cost
Request parameters
Up to 1 creditSpotify track id. If you'd prefer to use the URL instead, you can use the url parameter instead.
Spotify song URL. If you'd prefer to use the id instead, you can use the id parameter instead.
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/spotify/track?id=1ITJflybJsfarsUtiBvkfK' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"credits_charged": 1,
"popularity": 75,
"__typename": "Track",
"associationsV3": {
"audioAssociations": [],
"videoAssociations": {
"totalCount": 0
}
},
"contentRating": {
"label": "EXPLICIT"
},
"duration": {
"totalMilliseconds": 186112
},
"id": "1ITJflybJsfarsUtiBvkfK",
"mediaType": "AUDIO",
"name": "Shoulda Never (feat. USHER)",
"playability": {
"playable": true,
"reason": "PLAYABLE"
},
"playcount": 7190090,
"saved": false,
"sharingInfo": {
"shareId": "uSMzDZBBRDOHdFcn87thNw",
"shareUrl": "https://open.spotify.com/track/1ITJflybJsfarsUtiBvkfK?si=uSMzDZBBRDOHdFcn87thNw"
},
"trackNumber": 8,
"uri": "spotify:track:1ITJflybJsfarsUtiBvkfK",
"albumOfTrack": {
"copyright": [
{
"text": "© 2026 Atlantic Records Group LLC",
"type": "C"
}
],
"courtesyLine": "",
"id": "2xkYTmqjear3lSGydIn7wh",
"date": {
"isoString": "2026-04-24T00:00:00Z",
"precision": "DAY",
"year": 2026
},
"name": "Kehlani",
"playability": {
"playable": true
},
"sharingInfo": {
"shareId": "tgjmwiVTRmaaQGK0sKdcJg",
"shareUrl": "https://open.spotify.com/album/2xkYTmqjear3lSGydIn7wh?si=tgjmwiVTRmaaQGK0sKdcJg"
},
"tracks": [
{
"track": {
"trackNumber": 1,
"uri": "spotify:track:4PDLyPnlDeu7PRzAUyyUO3"
}
}
],
"type": "ALBUM",
"uri": "spotify:album:2xkYTmqjear3lSGydIn7wh",
"coverArt": {
"extractedColors": {
"colorRaw": {
"hex": "#502020"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02d4ffe3d4cddee37b9fd6ffcd",
"width": 300
}
]
}
},
"firstArtist": [
{
"discography": {
"albums": [
{
"date": {
"isoString": "2026-04-24T00:00:00Z",
"precision": "DAY",
"year": 2026
},
"name": "Kehlani",
"playability": {
"playable": true
},
"sharingInfo": {
"shareId": "o2YeInVoTnSojn2WeDO3JQ",
"shareUrl": "https://open.spotify.com/album/2xkYTmqjear3lSGydIn7wh?si=o2YeInVoTnSojn2WeDO3JQ"
},
"tracks": [
{
"track": {
"trackNumber": 1,
"uri": "spotify:track:4PDLyPnlDeu7PRzAUyyUO3"
}
}
],
"type": "ALBUM",
"uri": "spotify:album:2xkYTmqjear3lSGydIn7wh",
"coverArt": {
"extractedColors": {
"colorRaw": {
"hex": "#502020"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02d4ffe3d4cddee37b9fd6ffcd",
"width": 300
}
]
}
}
],
"popularReleasesAlbums": [
{
"date": {
"isoString": "2026-04-24T00:00:00Z",
"precision": "DAY",
"year": 2026
},
"name": "Kehlani",
"playability": {
"playable": true
},
"sharingInfo": {
"shareId": "kDxxO1hmRp2Bpu66R81Ujw",
"shareUrl": "https://open.spotify.com/album/2xkYTmqjear3lSGydIn7wh?si=kDxxO1hmRp2Bpu66R81Ujw"
},
"tracks": [
{
"track": {
"trackNumber": 1,
"uri": "spotify:track:4PDLyPnlDeu7PRzAUyyUO3"
}
}
],
"type": "ALBUM",
"uri": "spotify:album:2xkYTmqjear3lSGydIn7wh",
"coverArt": {
"extractedColors": {
"colorRaw": {
"hex": "#502020"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02d4ffe3d4cddee37b9fd6ffcd",
"width": 300
}
]
}
}
],
"singles": [
{
"date": {
"isoString": "2026-04-23T00:00:00Z",
"precision": "DAY",
"year": 2026
},
"name": "Sweet Nuthins (feat. Leon Thomas)",
"playability": {
"playable": true
},
"sharingInfo": {
"shareId": "YbH9FRW_RCKl62VAEMgVhA",
"shareUrl": "https://open.spotify.com/album/4OIEqxUAhJ3fxEVqf5L9GB?si=YbH9FRW_RCKl62VAEMgVhA"
},
"tracks": [
{
"track": {
"trackNumber": 1,
"uri": "spotify:track:7qa1DytPRohFzfOarz6orJ"
}
}
],
"type": "SINGLE",
"uri": "spotify:album:4OIEqxUAhJ3fxEVqf5L9GB",
"coverArt": {
"extractedColors": {
"colorRaw": {
"hex": "#502020"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02b12f0dbd960ab2e252b64a95",
"width": 300
}
]
}
}
],
"topTracks": [
{
"track": {
"albumOfTrack": {
"name": "Kehlani",
"uri": "spotify:album:5KS0QmxwUmSPsolg9VaSAU",
"coverArt": {
"extractedColors": {
"colorRaw": {
"hex": "#502020"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02d9233d03f5434d9dd46c9fd6",
"width": 300
}
]
}
},
"artists": [
{
"profile": {
"name": "Kehlani"
},
"uri": "spotify:artist:0cGUm45nv7Z6M6qdXYQGTX"
}
],
"associationsV3": {
"audioAssociations": [],
"videoAssociations": {
"totalCount": 1
}
},
"contentRating": {
"label": "NONE"
},
"duration": {
"totalMilliseconds": 237928
},
"id": "6sTlzpJaFGkFQ4BNccmbW9",
"name": "Folded",
"playability": {
"playable": true
},
"playcount": 469410555,
"previews": {
"audioPreviews": [
{
"url": "https://p.scdn.co/mp3-preview/ece91419129fc9d92ae8f7729a92693b7802d7ca"
}
]
},
"uri": "spotify:track:6sTlzpJaFGkFQ4BNccmbW9"
}
}
]
},
"id": "0cGUm45nv7Z6M6qdXYQGTX",
"profile": {
"name": "Kehlani"
},
"relatedContent": {
"relatedArtists": [
{
"id": "7HkdQ0gt53LP4zmHsL0nap",
"profile": {
"name": "Ella Mai"
},
"uri": "spotify:artist:7HkdQ0gt53LP4zmHsL0nap",
"visuals": {
"avatarImage": {
"sources": [
{
"height": 640,
"url": "https://i.scdn.co/image/ab6761610000e5eb5d6ed813fc2c93765152ff7e",
"width": 640
}
]
}
}
}
]
},
"uri": "spotify:artist:0cGUm45nv7Z6M6qdXYQGTX",
"visuals": {
"avatarImage": {
"sources": [
{
"height": 640,
"url": "https://i.scdn.co/image/ab6761610000e5ebcf865d7d399a41e1bd036149",
"width": 640
}
]
}
}
}
],
"otherArtists": [
{
"discography": {
"popularReleasesAlbums": [
{
"coverArt": {
"extractedColors": {
"colorRaw": {
"hex": "#404030"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02365b3fb800c19f7ff72602da",
"width": 300
}
]
},
"date": {
"isoString": "2004-03-23T00:00:00Z",
"precision": "DAY",
"year": 2004
},
"name": "Confessions (Expanded Edition)",
"playability": {
"playable": true
},
"sharingInfo": {
"shareId": "pCyjyjRLTMCCoMKOe1QAHg",
"shareUrl": "https://open.spotify.com/album/1RM6MGv6bcl6NrAG8PGoZk?si=pCyjyjRLTMCCoMKOe1QAHg"
},
"tracks": [
{
"track": {
"trackNumber": 1,
"uri": "spotify:track:1tV1G9juUCSNEDdVhCaWKh"
}
}
],
"type": "ALBUM",
"uri": "spotify:album:1RM6MGv6bcl6NrAG8PGoZk"
}
]
},
"id": "23zg3TcAtWQy7J6upgbUnj",
"profile": {
"name": "USHER"
},
"uri": "spotify:artist:23zg3TcAtWQy7J6upgbUnj",
"visuals": {
"avatarImage": {
"sources": [
{
"height": 640,
"url": "https://i.scdn.co/image/ab6761610000e5ebb13684907cd609d10d41f0b8",
"width": 640
}
]
}
}
}
]
}Example data from the API specification. Run a request to retrieve current data.
Response shape
This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.
View JSON Schema +
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"credits_remaining": {
"type": "integer"
},
"credits_charged": {
"type": "integer"
},
"popularity": {
"type": "integer"
},
"__typename": {
"type": "string"
},
"associationsV3": {
"type": "object",
"properties": {
"audioAssociations": {
"type": "array"
},
"videoAssociations": {
"type": "object",
"properties": {
"totalCount": {
"type": "integer"
}
}
}
}
},
"contentRating": {
"type": "object",
"properties": {
"label": {
"type": "string"
}
}
},
"duration": {
"type": "object",
"properties": {
"totalMilliseconds": {
"type": "integer"
}
}
},
"id": {
"type": "string"
},
"mediaType": {
"type": "string"
},
"name": {
"type": "string"
},
"playability": {
"type": "object",
"properties": {
"playable": {
"type": "boolean"
},
"reason": {
"type": "string"
}
}
},
"playcount": {
"type": "integer"
},
"saved": {
"type": "boolean"
},
"sharingInfo": {
"type": "object",
"properties": {
"shareId": {
"type": "string"
},
"shareUrl": {
"type": "string"
}
}
},
"trackNumber": {
"type": "integer"
},
"uri": {
"type": "string"
},
"albumOfTrack": {
"type": "object",
"properties": {
"copyright": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
},
"courtesyLine": {
"type": "string"
},
"id": {
"type": "string"
},
"date": {
"type": "object",
"properties": {
"isoString": {
"type": "string"
},
"precision": {
"type": "string"
},
"year": {
"type": "integer"
}
}
},
"name": {
"type": "string"
},
"playability": {
"type": "object",
"properties": {
"playable": {
"type": "boolean"
}
}
},
"sharingInfo": {
"type": "object",
"properties": {
"shareId": {
"type": "string"
},
"shareUrl": {
"type": "string"
}
}
},
"tracks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"track": {
"type": "object",
"properties": {
"trackNumber": {
"type": "integer"
},
"uri": {
"type": "string"
}
}
}
}
}
},
"type": {
"type": "string"
},
"uri": {
"type": "string"
},
"coverArt": {
"type": "object",
"properties": {
"extractedColors": {
"type": "object",
"properties": {
"colorRaw": {
"type": "object",
"properties": {
"hex": {
"type": "string"
}
}
}
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"url": {
"type": "string"
},
"width": {
"type": "integer"
}
}
}
}
}
}
}
},
"firstArtist": {
"type": "array",
"items": {
"type": "object",
"properties": {
"discography": {
"type": "object",
"properties": {
"albums": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "object",
"properties": {
"isoString": {
"type": "string"
},
"precision": {
"type": "string"
},
"year": {
"type": "integer"
}
}
},
"name": {
"type": "string"
},
"playability": {
"type": "object",
"properties": {
"playable": {
"type": "boolean"
}
}
},
"sharingInfo": {
"type": "object",
"properties": {
"shareId": {
"type": "string"
},
"shareUrl": {
"type": "string"
}
}
},
"tracks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"track": {
"type": "object",
"properties": {
"trackNumber": {
"type": "integer"
},
"uri": {
"type": "string"
}
}
}
}
}
},
"type": {
"type": "string"
},
"uri": {
"type": "string"
},
"coverArt": {
"type": "object",
"properties": {
"extractedColors": {
"type": "object",
"properties": {
"colorRaw": {
"type": "object",
"properties": {
"hex": {
"type": "string"
}
}
}
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"url": {
"type": "string"
},
"width": {
"type": "integer"
}
}
}
}
}
}
}
}
},
"popularReleasesAlbums": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "object",
"properties": {
"isoString": {
"type": "string"
},
"precision": {
"type": "string"
},
"year": {
"type": "integer"
}
}
},
"name": {
"type": "string"
},
"playability": {
"type": "object",
"properties": {
"playable": {
"type": "boolean"
}
}
},
"sharingInfo": {
"type": "object",
"properties": {
"shareId": {
"type": "string"
},
"shareUrl": {
"type": "string"
}
}
},
"tracks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"track": {
"type": "object",
"properties": {
"trackNumber": {
"type": "integer"
},
"uri": {
"type": "string"
}
}
}
}
}
},
"type": {
"type": "string"
},
"uri": {
"type": "string"
},
"coverArt": {
"type": "object",
"properties": {
"extractedColors": {
"type": "object",
"properties": {
"colorRaw": {
"type": "object",
"properties": {
"hex": {
"type": "string"
}
}
}
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"url": {
"type": "string"
},
"width": {
"type": "integer"
}
}
}
}
}
}
}
}
},
"singles": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "object",
"properties": {
"isoString": {
"type": "string"
},
"precision": {
"type": "string"
},
"year": {
"type": "integer"
}
}
},
"name": {
"type": "string"
},
"playability": {
"type": "object",
"properties": {
"playable": {
"type": "boolean"
}
}
},
"sharingInfo": {
"type": "object",
"properties": {
"shareId": {
"type": "string"
},
"shareUrl": {
"type": "string"
}
}
},
"tracks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"track": {
"type": "object",
"properties": {
"trackNumber": {
"type": "integer"
},
"uri": {
"type": "string"
}
}
}
}
}
},
"type": {
"type": "string"
},
"uri": {
"type": "string"
},
"coverArt": {
"type": "object",
"properties": {
"extractedColors": {
"type": "object",
"properties": {
"colorRaw": {
"type": "object",
"properties": {
"hex": {
"type": "string"
}
}
}
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"url": {
"type": "string"
},
"width": {
"type": "integer"
}
}
}
}
}
}
}
}
},
"topTracks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"track": {
"type": "object",
"properties": {
"albumOfTrack": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"uri": {
"type": "string"
},
"coverArt": {
"type": "object",
"properties": {
"extractedColors": {
"type": "object",
"properties": {
"colorRaw": {
"type": "object",
"properties": {
"hex": {
"type": "string"
}
}
}
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"url": {
"type": "string"
},
"width": {
"type": "integer"
}
}
}
}
}
}
}
},
"artists": {
"type": "array",
"items": {
"type": "object",
"properties": {
"profile": {
"type": "object",
"properties": {
"name": {
"type": "string"
}
}
},
"uri": {
"type": "string"
}
}
}
},
"associationsV3": {
"type": "object",
"properties": {
"audioAssociations": {
"type": "array"
},
"videoAssociations": {
"type": "object",
"properties": {
"totalCount": {
"type": "integer"
}
}
}
}
},
"contentRating": {
"type": "object",
"properties": {
"label": {
"type": "string"
}
}
},
"duration": {
"type": "object",
"properties": {
"totalMilliseconds": {
"type": "integer"
}
}
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"playability": {
"type": "object",
"properties": {
"playable": {
"type": "boolean"
}
}
},
"playcount": {
"type": "integer"
},
"previews": {
"type": "object",
"properties": {
"audioPreviews": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
}
}
}
}
}
},
"uri": {
"type": "string"
}
}
}
}
}
}
}
},
"id": {
"type": "string"
},
"profile": {
"type": "object",
"properties": {
"name": {
"type": "string"
}
}
},
"relatedContent": {
"type": "object",
"properties": {
"relatedArtists": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"profile": {
"type": "object",
"properties": {
"name": {
"type": "string"
}
}
},
"uri": {
"type": "string"
},
"visuals": {
"type": "object",
"properties": {
"avatarImage": {
"type": "object",
"properties": {
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"url": {
"type": "string"
},
"width": {
"type": "integer"
}
}
}
}
}
}
}
}
}
}
}
}
},
"uri": {
"type": "string"
},
"visuals": {
"type": "object",
"properties": {
"avatarImage": {
"type": "object",
"properties": {
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"url": {
"type": "string"
},
"width": {
"type": "integer"
}
}
}
}
}
}
}
}
}
}
},
"otherArtists": {
"type": "array",
"items": {
"type": "object",
"properties": {
"discography": {
"type": "object",
"properties": {
"popularReleasesAlbums": {
"type": "array",
"items": {
"type": "object",
"properties": {
"coverArt": {
"type": "object",
"properties": {
"extractedColors": {
"type": "object",
"properties": {
"colorRaw": {
"type": "object",
"properties": {
"hex": {
"type": "string"
}
}
}
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"url": {
"type": "string"
},
"width": {
"type": "integer"
}
}
}
}
}
},
"date": {
"type": "object",
"properties": {
"isoString": {
"type": "string"
},
"precision": {
"type": "string"
},
"year": {
"type": "integer"
}
}
},
"name": {
"type": "string"
},
"playability": {
"type": "object",
"properties": {
"playable": {
"type": "boolean"
}
}
},
"sharingInfo": {
"type": "object",
"properties": {
"shareId": {
"type": "string"
},
"shareUrl": {
"type": "string"
}
}
},
"tracks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"track": {
"type": "object",
"properties": {
"trackNumber": {
"type": "integer"
},
"uri": {
"type": "string"
}
}
}
}
}
},
"type": {
"type": "string"
},
"uri": {
"type": "string"
}
}
}
}
}
},
"id": {
"type": "string"
},
"profile": {
"type": "object",
"properties": {
"name": {
"type": "string"
}
}
},
"uri": {
"type": "string"
},
"visuals": {
"type": "object",
"properties": {
"avatarImage": {
"type": "object",
"properties": {
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"url": {
"type": "string"
},
"width": {
"type": "integer"
}
}
}
}
}
}
}
}
}
}
}
}
}