SPOTIFY API
Album
Retrieve album from Spotify with a single API request.
GET
/api/data/v1/spotify/album1credit base cost
Request parameters
Up to 1 creditSpotify album id. If you'd prefer to use the URL instead, you can use the url parameter instead.
Spotify album 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/album?id=0pgrg7phBbnwGJ2HBEl9EG' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"credits_charged": 1,
"popularity": 14,
"id": "0pgrg7phBbnwGJ2HBEl9EG",
"uri": "spotify:album:0pgrg7phBbnwGJ2HBEl9EG",
"__typename": "Album",
"copyright": [
{
"text": "2025 IRL Angel",
"type": "C"
}
],
"courtesyLine": "",
"date": {
"isoString": "2025-03-16T00:00:00Z",
"precision": "DAY"
},
"isPreRelease": false,
"label": "IRL Angel",
"name": "BEFORE THE SUN RISES & WINTERR ENDS",
"playability": {
"playable": true,
"reason": "PLAYABLE"
},
"preReleaseEndDateTime": null,
"saved": false,
"sharingInfo": {
"shareId": "mULFEWCzRY2MmJMhNahQMA",
"shareUrl": "https://open.spotify.com/album/0pgrg7phBbnwGJ2HBEl9EG?si=mULFEWCzRY2MmJMhNahQMA"
},
"tracksV2": [
{
"track": {
"artists": [
{
"profile": {
"name": "Miguel Angeles"
},
"uri": "spotify:artist:14xRX3JR8H4RWh8R7V3fvZ"
}
],
"associationsV3": {
"videoAssociations": {
"totalCount": 0
}
},
"contentRating": {
"label": "NONE"
},
"discNumber": 1,
"duration": {
"totalMilliseconds": 184109
},
"name": "AN IMPERRFECT BODY",
"playability": {
"playable": true
},
"playcount": 130437,
"relinkingInformation": null,
"saved": false,
"trackNumber": 1,
"uri": "spotify:track:0LfCnR4s7l6T4TyCNNsHBs"
},
"uid": "0c86f1002074d296d295"
}
],
"type": "SINGLE",
"visualIdentity": {
"squareCoverImage": {
"__typename": "VisualIdentityImage",
"extractedColorSet": {
"encoreBaseSetTextColor": {
"alpha": 255,
"blue": 224,
"green": 224,
"red": 224
},
"highContrast": {
"backgroundBase": {
"alpha": 255,
"blue": 83,
"green": 83,
"red": 83
},
"backgroundTintedBase": {
"alpha": 255,
"blue": 51,
"green": 51,
"red": 51
},
"textBase": {
"alpha": 255,
"blue": 255,
"green": 255,
"red": 255
},
"textBrightAccent": {
"alpha": 255,
"blue": 255,
"green": 255,
"red": 255
},
"textSubdued": {
"alpha": 255,
"blue": 205,
"green": 205,
"red": 205
}
},
"higherContrast": {
"backgroundBase": {
"alpha": 255,
"blue": 53,
"green": 53,
"red": 53
},
"backgroundTintedBase": {
"alpha": 255,
"blue": 86,
"green": 86,
"red": 86
},
"textBase": {
"alpha": 255,
"blue": 255,
"green": 255,
"red": 255
},
"textBrightAccent": {
"alpha": 255,
"blue": 96,
"green": 215,
"red": 30
},
"textSubdued": {
"alpha": 255,
"blue": 205,
"green": 205,
"red": 205
}
},
"minContrast": {
"backgroundBase": {
"alpha": 255,
"blue": 153,
"green": 153,
"red": 153
},
"backgroundTintedBase": {
"alpha": 255,
"blue": 128,
"green": 128,
"red": 128
},
"textBase": {
"alpha": 255,
"blue": 255,
"green": 255,
"red": 255
},
"textBrightAccent": {
"alpha": 255,
"blue": 255,
"green": 255,
"red": 255
},
"textSubdued": {
"alpha": 255,
"blue": 255,
"green": 255,
"red": 255
}
}
}
}
},
"watchFeedEntrypoint": null,
"artists": [
{
"id": "14xRX3JR8H4RWh8R7V3fvZ",
"profile": {
"name": "Miguel Angeles"
},
"sharingInfo": {
"shareUrl": "https://open.spotify.com/artist/14xRX3JR8H4RWh8R7V3fvZ?si=LfcPfGMFQB-_Gpvc-_mIXA"
},
"uri": "spotify:artist:14xRX3JR8H4RWh8R7V3fvZ",
"visuals": {
"avatarImage": {
"sources": [
{
"height": 640,
"url": "https://i.scdn.co/image/ab6761610000e5eb9784901e4c2fb5e2e59bf7b2",
"width": 640
}
]
}
}
}
],
"coverArt": {
"extractedColors": {
"colorDark": {
"hex": "#777777"
},
"colorLight": {
"hex": "#E0E0E0"
},
"colorRaw": {
"hex": "#E0E0E0"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e029bd93cc6e406b820dfff691f",
"width": 300
}
]
},
"discs": [
{
"number": 1,
"tracks": {
"totalCount": 3
}
}
],
"releases": [],
"moreAlbumsByArtist": [
{
"discography": {
"popularReleasesAlbums": [
{
"coverArt": {
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02e1b81322a76efedc9296226b",
"width": 300
}
]
},
"date": {
"year": 2023
},
"id": "73WPr90gWBdNLg1KHkgpc0",
"name": "PROTECTION CHARM (SLOW & HARD VERSION)",
"playability": {
"playable": true,
"reason": "PLAYABLE"
},
"sharingInfo": {
"shareId": "0oYuiIkGSle7UN5bTeILnw",
"shareUrl": "https://open.spotify.com/album/73WPr90gWBdNLg1KHkgpc0?si=0oYuiIkGSle7UN5bTeILnw"
},
"type": "SINGLE",
"uri": "spotify:album:73WPr90gWBdNLg1KHkgpc0"
}
]
}
}
]
}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"
},
"id": {
"type": "string"
},
"uri": {
"type": "string"
},
"__typename": {
"type": "string"
},
"copyright": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"type": {
"type": "string"
}
}
}
},
"courtesyLine": {
"type": "string"
},
"date": {
"type": "object",
"properties": {
"isoString": {
"type": "string"
},
"precision": {
"type": "string"
}
}
},
"isPreRelease": {
"type": "boolean"
},
"label": {
"type": "string"
},
"name": {
"type": "string"
},
"playability": {
"type": "object",
"properties": {
"playable": {
"type": "boolean"
},
"reason": {
"type": "string"
}
}
},
"preReleaseEndDateTime": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"saved": {
"type": "boolean"
},
"sharingInfo": {
"type": "object",
"properties": {
"shareId": {
"type": "string"
},
"shareUrl": {
"type": "string"
}
}
},
"tracksV2": {
"type": "array",
"items": {
"type": "object",
"properties": {
"track": {
"type": "object",
"properties": {
"artists": {
"type": "array",
"items": {
"type": "object",
"properties": {
"profile": {
"type": "object",
"properties": {
"name": {
"type": "string"
}
}
},
"uri": {
"type": "string"
}
}
}
},
"associationsV3": {
"type": "object",
"properties": {
"videoAssociations": {
"type": "object",
"properties": {
"totalCount": {
"type": "integer"
}
}
}
}
},
"contentRating": {
"type": "object",
"properties": {
"label": {
"type": "string"
}
}
},
"discNumber": {
"type": "integer"
},
"duration": {
"type": "object",
"properties": {
"totalMilliseconds": {
"type": "integer"
}
}
},
"name": {
"type": "string"
},
"playability": {
"type": "object",
"properties": {
"playable": {
"type": "boolean"
}
}
},
"playcount": {
"type": "integer"
},
"relinkingInformation": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"saved": {
"type": "boolean"
},
"trackNumber": {
"type": "integer"
},
"uri": {
"type": "string"
}
}
},
"uid": {
"type": "string"
}
}
}
},
"type": {
"type": "string"
},
"visualIdentity": {
"type": "object",
"properties": {
"squareCoverImage": {
"type": "object",
"properties": {
"__typename": {
"type": "string"
},
"extractedColorSet": {
"type": "object",
"properties": {
"encoreBaseSetTextColor": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"highContrast": {
"type": "object",
"properties": {
"backgroundBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"backgroundTintedBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textBrightAccent": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textSubdued": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
}
}
},
"higherContrast": {
"type": "object",
"properties": {
"backgroundBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"backgroundTintedBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textBrightAccent": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textSubdued": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
}
}
},
"minContrast": {
"type": "object",
"properties": {
"backgroundBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"backgroundTintedBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textBase": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textBrightAccent": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
},
"textSubdued": {
"type": "object",
"properties": {
"alpha": {
"type": "integer"
},
"blue": {
"type": "integer"
},
"green": {
"type": "integer"
},
"red": {
"type": "integer"
}
}
}
}
}
}
}
}
}
}
},
"watchFeedEntrypoint": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"artists": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"profile": {
"type": "object",
"properties": {
"name": {
"type": "string"
}
}
},
"sharingInfo": {
"type": "object",
"properties": {
"shareUrl": {
"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"
}
}
}
}
}
}
}
}
}
}
},
"coverArt": {
"type": "object",
"properties": {
"extractedColors": {
"type": "object",
"properties": {
"colorDark": {
"type": "object",
"properties": {
"hex": {
"type": "string"
}
}
},
"colorLight": {
"type": "object",
"properties": {
"hex": {
"type": "string"
}
}
},
"colorRaw": {
"type": "object",
"properties": {
"hex": {
"type": "string"
}
}
}
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"url": {
"type": "string"
},
"width": {
"type": "integer"
}
}
}
}
}
},
"discs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"number": {
"type": "integer"
},
"tracks": {
"type": "object",
"properties": {
"totalCount": {
"type": "integer"
}
}
}
}
}
},
"releases": {
"type": "array"
},
"moreAlbumsByArtist": {
"type": "array",
"items": {
"type": "object",
"properties": {
"discography": {
"type": "object",
"properties": {
"popularReleasesAlbums": {
"type": "array",
"items": {
"type": "object",
"properties": {
"coverArt": {
"type": "object",
"properties": {
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"height": {
"type": "integer"
},
"url": {
"type": "string"
},
"width": {
"type": "integer"
}
}
}
}
}
},
"date": {
"type": "object",
"properties": {
"year": {
"type": "integer"
}
}
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"playability": {
"type": "object",
"properties": {
"playable": {
"type": "boolean"
},
"reason": {
"type": "string"
}
}
},
"sharingInfo": {
"type": "object",
"properties": {
"shareId": {
"type": "string"
},
"shareUrl": {
"type": "string"
}
}
},
"type": {
"type": "string"
},
"uri": {
"type": "string"
}
}
}
}
}
}
}
}
}
}
}