Album

GET/v1/spotify/album1 credit

Returns an album: name, label, release date, copyright, cover art, artists, discs and the full track list, plus more albums by the artist.

01Query parameters

Name	Type	Description
idoptional	string	The Spotify album id, e.g. `6dVIqQ8qmQ5GBnJ9shOYGE`. One of `id` or `url` is required; `id` wins when both are given.
urloptional	string	The open.spotify.com album URL. One of `id` or `url` is required.

02Request

curl "https://api.scrapesocial.ai/v1/spotify/album?url=https%3A%2F%2Fopen.spotify.com%2Falbum%2F6dVIqQ8qmQ5GBnJ9shOYGE" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/spotify/album?url=https%3A%2F%2Fopen.spotify.com%2Falbum%2F6dVIqQ8qmQ5GBnJ9shOYGE

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "6dVIqQ8qmQ5GBnJ9shOYGE",
  "uri": "spotify:album:6dVIqQ8qmQ5GBnJ9shOYGE",
  "__typename": "Album",
  "copyright": [
    {
      "text": "1997 XL Recordings Ltd",
      "type": "C"
    },
    {
      "text": "1997 XL Recordings Ltd",
      "type": "P"
    }
  ],
  "courtesyLine": "",
  "date": {
    "isoString": "1997-05-28T00:00:00Z",
    "precision": "DAY"
  },
  "isPreRelease": false,
  "label": "XL Recordings",
  "name": "OK Computer",
  "playability": {
    "playable": true,
    "reason": "PLAYABLE"
  },
  "preReleaseEndDateTime": null,
  "saved": false,
  "sharingInfo": {
    "shareId": "wtTg1m3QQHCsP79NfNXlkw",
    "shareUrl": "https://open.spotify.com/album/6dVIqQ8qmQ5GBnJ9shOYGE?si=wtTg1m3QQHCsP79NfNXlkw"
  },
  "tracksV2": [
    {
      "track": {
        "artists": [
          {
            "profile": {
              "name": "Radiohead"
            },
            "uri": "spotify:artist:4Z8W4fKeB5YxbusRsdQVPb"
          }
        ],
        "associationsV3": {
          "audioAssociations": {
            "totalCount": 0
          },
          "videoAssociations": {
            "totalCount": 0
          }
        },
        "contentRating": {
          "label": "NONE"
        },
        "discNumber": 1,
        "duration": {
          "totalMilliseconds": 287880
        },
        "mediaType": "AUDIO",
        "name": "Airbag",
        "playability": {
          "playable": true
        },
        "playcount": 107329916,
        "relinkingInformation": null,
        "saved": false,
        "trackNumber": 1,
        "uri": "spotify:track:7c378mlmubSu7NGkLFa4sN"
      },
      "uid": "a27ee133a088cd918441"
    },
    {
      "track": {
        "artists": [
          {
            "profile": {
              "name": "Radiohead"
            },
            "uri": "spotify:artist:4Z8W4fKeB5YxbusRsdQVPb"
          }
        ],
        "associationsV3": {
          "audioAssociations": {
            "totalCount": 0
          },
          "videoAssociations": {
            "totalCount": 1
          }
        },
        "contentRating": {
          "label": "NONE"
        },
        "discNumber": 1,
        "duration": {
          "totalMilliseconds": 387213
        },
        "mediaType": "AUDIO",
        "name": "Paranoid Android",
        "playability": {
          "playable": true
        },
        "playcount": 327883398,
        "relinkingInformation": null,
        "saved": false,
        "trackNumber": 2,
        "uri": "spotify:track:6LgJvl0Xdtc73RJ1mmpotq"
      },
      "uid": "9568fd544ad24f13dd15"
    }
  ],
  "type": "ALBUM",
  "visualIdentity": {
    "squareCoverImage": {
      "__typename": "VisualIdentityImage",
      "extractedColorSet": {
        "encoreBaseSetTextColor": {
          "alpha": 255,
          "blue": 216,
          "green": 192,
          "red": 152
        },
        "highContrast": {
          "backgroundBase": {
            "alpha": 255,
            "blue": 108,
            "green": 87,
            "red": 50
          },
          "backgroundTintedBase": {
            "alpha": 255,
            "blue": 73,
            "green": 54,
            "red": 15
          },
          "textBase": {
            "alpha": 255,
            "blue": 255,
            "green": 255,
            "red": 255
          },
          "textBrightAccent": {
            "alpha": 255,
            "blue": 255,
            "green": 255,
            "red": 255
          },
          "textSubdued": {
            "alpha": 255,
            "blue": 236,
            "green": 211,
            "red": 170
          }
        },
        "higherContrast": {
          "backgroundBase": {
            "alpha": 255,
            "blue": 76,
            "green": 56,
            "red": 18
          },
          "backgroundTintedBase": {
            "alpha": 255,
            "blue": 111,
            "green": 90,
            "red": 53
          },
          "textBase": {
            "alpha": 255,
            "blue": 255,
            "green": 255,
            "red": 255
          },
          "textBrightAccent": {
            "alpha": 255,
            "blue": 96,
            "green": 215,
            "red": 30
          },
          "textSubdued": {
            "alpha": 255,
            "blue": 236,
            "green": 211,
            "red": 170
          }
        },
        "minContrast": {
          "backgroundBase": {
            "alpha": 255,
            "blue": 181,
            "green": 158,
            "red": 119
          },
          "backgroundTintedBase": {
            "alpha": 255,
            "blue": 156,
            "green": 133,
            "red": 95
          },
          "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": "4Z8W4fKeB5YxbusRsdQVPb",
      "profile": {
        "name": "Radiohead"
      },
      "sharingInfo": {
        "shareUrl": "https://open.spotify.com/artist/4Z8W4fKeB5YxbusRsdQVPb?si=7SJckqW3SUWJgA6UEcHGpg"
      },
      "uri": "spotify:artist:4Z8W4fKeB5YxbusRsdQVPb",
      "visuals": {
        "avatarImage": {
          "sources": [
            {
              "height": 640,
              "url": "https://i.scdn.co/image/ab6761610000e5eb959527d2fabc9c64287e57b9",
              "width": 640
            },
            {
              "height": 160,
              "url": "https://i.scdn.co/image/ab6761610000f178959527d2fabc9c64287e57b9",
              "width": 160
            }
          ]
        }
      }
    }
  ],
  "coverArt": {
    "extractedColors": {
      "colorDark": {
        "hex": "#607B8B"
      },
      "colorLight": {
        "hex": "#90B8D0"
      },
      "colorRaw": {
        "hex": "#90B8D0"
      }
    },
    "sources": [
      {
        "height": 300,
        "url": "https://i.scdn.co/image/ab67616d00001e02c8b444df094279e70d0ed856",
        "width": 300
      },
      {
        "height": 64,
        "url": "https://i.scdn.co/image/ab67616d00004851c8b444df094279e70d0ed856",
        "width": 64
      }
    ]
  },
  "discs": [
    {
      "number": 1,
      "tracks": {
        "totalCount": 12
      }
    }
  ],
  "releases": [],
  "moreAlbumsByArtist": [
    {
      "discography": {
        "popularReleasesAlbums": [
          {
            "coverArt": {
              "sources": [
                {
                  "height": 300,
                  "url": "https://i.scdn.co/image/ab67616d00001e02c8b444df094279e70d0ed856",
                  "width": 300
                },
                {
                  "height": 64,
                  "url": "https://i.scdn.co/image/ab67616d00004851c8b444df094279e70d0ed856",
                  "width": 64
                }
              ]
            },
            "date": {
              "year": 1997
            },
            "id": "6dVIqQ8qmQ5GBnJ9shOYGE",
            "name": "OK Computer",
            "playability": {
              "playable": true,
              "reason": "PLAYABLE"
            },
            "sharingInfo": {
              "shareId": "INb9CG6xQJSH7LNW5IAljg",
              "shareUrl": "https://open.spotify.com/album/6dVIqQ8qmQ5GBnJ9shOYGE?si=INb9CG6xQJSH7LNW5IAljg"
            },
            "type": "ALBUM",
            "uri": "spotify:album:6dVIqQ8qmQ5GBnJ9shOYGE"
          },
          {
            "coverArt": {
              "sources": [
                {
                  "height": 300,
                  "url": "https://i.scdn.co/image/ab67616d00001e02ec548c00d3ac2f10be73366d",
                  "width": 300
                },
                {
                  "height": 64,
                  "url": "https://i.scdn.co/image/ab67616d00004851ec548c00d3ac2f10be73366d",
                  "width": 64
                }
              ]
            },
            "date": {
              "year": 1993
            },
            "id": "3gBVdu4a1MMJVMy6vwPEb8",
            "name": "Pablo Honey",
            "playability": {
              "playable": true,
              "reason": "PLAYABLE"
            },
            "sharingInfo": {
              "shareId": "u3sKr4yPQ9GI8IDYQ3C_wA",
              "shareUrl": "https://open.spotify.com/album/3gBVdu4a1MMJVMy6vwPEb8?si=u3sKr4yPQ9GI8IDYQ3C_wA"
            },
            "type": "ALBUM",
            "uri": "spotify:album:3gBVdu4a1MMJVMy6vwPEb8"
          }
        ]
      }
    }
  ],
  "popularity": null
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

All tracks (up to 300) come in `tracksV2` in one answer; there is no paging. `popularity` is always null. An unknown album is a free 404.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.