Albums

Get Several Albums

Changed on

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

get/albums

Request

  • Base URL
    https://api.spotify.com/v1
  • URL
    https://api.spotify.com/v1/albums
  • Auth
    OAuth 2
    Authorization code: https://accounts.spotify.com/authorize
    Token URL: https://accounts.spotify.com/api/token

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": []
    }
  ]
}

Changes

  • 1602059e3988Revision changes
    • info

      response property albums/items/allOf[subschema #2]/external_ids reactivated

  • 8899d6fd66eeRevision changes
    • info

      endpoint deprecated

    • info

      response property albums/items/allOf[AlbumBase]/available_markets deprecated

    • info

      response property albums/items/allOf[subschema #2]/external_ids deprecated

    • info

      response property albums/items/allOf[subschema #2]/label deprecated

    • info

      response property albums/items/allOf[subschema #2]/popularity deprecated

    • info

      response property albums/items/allOf[subschema #2]/tracks/allOf[PagingSimplifiedTrackObject]/allOf[subschema #2]/items/items/available_markets deprecated

    • info

      response property albums/items/allOf[subschema #2]/tracks/allOf[PagingSimplifiedTrackObject]/allOf[subschema #2]/items/items/linked_from deprecated