Sign in

v1

latestOpenAPI 3.0.32026-07-139687282.9 KB
Albums

Get Several Albums

Get Spotify catalog information for multiple albums identified by their Spotify IDs.

get/albums

Query parameters

idsstring required

A comma-separated list of the Spotify IDs for the albums. Maximum: 20 IDs.

Example:382ObEPsp2rxGrnsizN5TX,1A2GTWGtFfWp7KSQTwWOyo,2noRn2Aes5aoNVsU6iWThc
marketstring

An ISO 3166-1 alpha-2 country code. If a country code is specified, only content that is available in that market will be returned.<br/> If a valid user access token is specified in the request header, the country associated with the user account will take priority over this parameter.<br/> Note: If neither market or user country are provided, the content is considered unavailable for the client.<br/> Users can view the country that is associated with their account in the account settings.

Example:ES

Response

A set of albums

Example response

{
  "albums": [
    {
      "album_type": "compilation",
      "total_tracks": 9,
      "available_markets": [
        "CA",
        "BR",
        "IT"
      ],
      "id": "2up3OPMp9Tb4dAKM2erWXQ",
      "images": [
        {
          "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
          "height": 300,
          "width": 300
        }
      ],
      "release_date": "1981-12",
      "release_date_precision": "year",
      "uri": "spotify:album:2up3OPMp9Tb4dAKM2erWXQ",
      "tracks": {
        "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20\n",
        "limit": 20,
        "next": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",
        "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",
        "total": 4
      },
      "genres": []
    }
  ]
}