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

Endpoint

GET https://api.spotify.com/v1/albums

Request Parameters

Query argument
Value
ids
Required. A comma-separated list of the Spotify IDs for the albums. Maximum: 20 IDs.
marketOptional. An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.

Response Format

On success, the HTTP status code in the response header is 200 OK and the response body contains an object whose key is "albums" and whose value is an array of album objects in JSON format.

Objects are returned in the order requested. If an object is not found, a null value is returned in the appropriate position. Duplicate ids in the query will result in duplicate objects in the response. On error, the header status code is an error code and the response body contains an error object.

Example

curl -X GET "https://api.spotify.com/v1/albums/?ids=41MnTivkwTO3UUJ8DrqEJJ,6JWc4iAiJ9FjyK0B59ABb4,6UXCm6bOO4gFlDQZV5yL37"
{
  "albums" : [ {
    "album_type" : "album",
    "artists" : [ {
      "external_urls" : {
        "spotify" : "https://open.spotify.com/artist/53A0W3U0s8diEn9RhXQhVz"
      },
      "href" : "https://api.spotify.com/v1/artists/53A0W3U0s8diEn9RhXQhVz",
      "id" : "53A0W3U0s8diEn9RhXQhVz",
      "name" : "Keane",
      "type" : "artist",
      "uri" : "spotify:artist:53A0W3U0s8diEn9RhXQhVz"
    } ],
    "available_markets" : [ "AD", "AR", "AT", "AU", "BE", "BG", "BO", "BR", "CH", "CL", "CO", "CR", "CY", "CZ", "DE", "DK", "DO", "EC", "EE", "ES", "FI", "FR", "GB", "GR", "GT", "HK", "HN", "HU", "IE", "IS", "IT", "LI", "LT", "LU", "LV", "MC", "MT", "MY", "NI", "NL", "NO", "NZ", "PA", "PE", "PH", "PL", "PT", "PY", "RO", "SE", "SG", "SI", "SK", "SV", "TR", "TW", "UY" ],
    "copyrights" : [ {
      "text" : "(C) 2013 Universal Island Records, a division of Universal Music Operations Limited",
      "type" : "C"
    }, {
      "text" : "(P) 2013 Universal Island Records, a division of Universal Music Operations Limited",
      "type" : "P"
    } ],
    "external_ids" : {
      "upc" : "00602537518357"
    },
    "external_urls" : {
      "spotify" : "https://open.spotify.com/album/41MnTivkwTO3UUJ8DrqEJJ"
    },
    "genres" : [ ],
    "href" : "https://api.spotify.com/v1/albums/41MnTivkwTO3UUJ8DrqEJJ",
    "id" : "41MnTivkwTO3UUJ8DrqEJJ",
    "images" : [ {
      "height" : 640,
      "url" : "https://i.scdn.co/image/89b92c6b59131776c0cd8e5df46301ffcf36ed69",
      "width" : 640
    }, {
      "height" : 300,
      "url" : "https://i.scdn.co/image/eb6f0b2594d81f8d9dced193f3e9a3bc4318aedc",
      "width" : 300
    }, {
      "height" : 64,
      "url" : "https://i.scdn.co/image/21e1ebcd7ebd3b679d9d5084bba1e163638b103a",
      "width" : 64
    } ],
    "name" : "The Best Of Keane (Deluxe Edition)",
    "popularity" : 65,
    "release_date" : "2013-11-08",
    "release_date_precision" : "day",
    "tracks" : {
      "href" : "https://api.spotify.com/v1/albums/41MnTivkwTO3UUJ8DrqEJJ/tracks?offset=0&limit=50",
      "items" : [ {
        "artists" : [ {
          "external_urls" : {
            "spotify" : "https://open.spotify.com/artist/53A0W3U0s8diEn9RhXQhVz"
          },
          "href" : "https://api.spotify.com/v1/artists/53A0W3U0s8diEn9RhXQhVz",
          "id" : "53A0W3U0s8diEn9RhXQhVz",
          "name" : "Keane",
          "type" : "artist",
          "uri" : "spotify:artist:53A0W3U0s8diEn9RhXQhVz"
        } ],
        "available_markets" : [ "AD", "AR", "AT", "AU", "BE", "BG", "BO", "BR", "CH", "CL", "CO", "CR", "CY", "CZ", "DE", "DK", "DO", "EC", "EE", "ES", "FI", "FR", "GB", "GR", "GT", "HK", "HN", "HU", "IE", "IS", "IT", "LI", "LT", "LU", "LV", "MC", "MT", "MY", "NI", "NL", "NO", "NZ", "PA", "PE", "PH", "PL", "PT", "PY", "RO", "SE", "SG", "SI", "SK", "SV", "TR", "TW", "UY" ],
        "disc_number" : 1,
        "duration_ms" : 215986,
        "explicit" : false,
        "external_urls" : {
          "spotify" : "https://open.spotify.com/track/4r9PmSmbAOOWqaGWLf6M9Q"
        },
        "href" : "https://api.spotify.com/v1/tracks/4r9PmSmbAOOWqaGWLf6M9Q",
        "id" : "4r9PmSmbAOOWqaGWLf6M9Q",
        "name" : "Everybody's Changing",
        "preview_url" : "https://p.scdn.co/mp3-preview/641fd877ee0f42f3713d1649e20a9734cc64b8f9",
        "track_number" : 1,
        "type" : "track",
        "uri" : "spotify:track:4r9PmSmbAOOWqaGWLf6M9Q"
      }, {
        "artists" : [ {
          "external_urls" : {
            "spotify" : "https://open.spotify.com/artist/53A0W3U0s8diEn9RhXQhVz"
          },
          "href" : "https://api.spotify.com/v1/artists/53A0W3U0s8diEn9RhXQhVz",
          "id" : "53A0W3U0s8diEn9RhXQhVz",
          "name" : "Keane",
          "type" : "artist",
          "uri" : "spotify:artist:53A0W3U0s8diEn9RhXQhVz"
        } ],
        "available_markets" : [ "AD", "AR", "AT", "AU", "BE", "BG", "BO", "BR", "CH", "CL", "CO", "CR", "CY", "CZ", "DE", "DK", "DO", "EC", "EE", "ES", "FI", "FR", "GB", "GR", "GT", "HK", "HN", "HU", "IE", "IS", "IT", "LI", "LT", "LU", "LV", "MC", "MT", "MY", "NI", "NL", "NO", "NZ", "PA", "PE", "PH", "PL", "PT", "PY", "RO", "SE", "SG", "SI", "SK", "SV", "TR", "TW", "UY" ],
        "disc_number" : 1,
        "duration_ms" : 235880,
        "explicit" : false,
        "external_urls" : {
          "spotify" : "https://open.spotify.com/track/0HJQD8uqX2Bq5HVdLnd3ep"
        },
        "href" : "https://api.spotify.com/v1/tracks/0HJQD8uqX2Bq5HVdLnd3ep",
        "id" : "0HJQD8uqX2Bq5HVdLnd3ep",
        "name" : "Somewhere Only We Know",
        "preview_url" : "https://p.scdn.co/mp3-preview/e001676375ea2b4807cee2f98b51f2f3fe0d109b",
        "track_number" : 2,
        "type" : "track",
        "uri" : "spotify:track:0HJQD8uqX2Bq5HVdLnd3ep"
      }, {
        ...
      }],
      "limit" : 50,
      "next" : null,
      "offset" : 0,
      "previous" : null,
      "total" : 9
    },
    "type" : "album",
    "uri" : "spotify:album:6UXCm6bOO4gFlDQZV5yL37"
  } ]
}

Try it in our Web API Console

album object (full)

Key
Value Type
Value Description
album_type
string
The type of the album: one of "album", "single", or "compilation".
artists
array of simplified artist objects
The artists of the album. Each artist object includes a link in href to more detailed information about the artist.
available_markets
array of strings
The markets in which the album is available: ISO 3166-1 alpha-2 country codes. Note that an album is considered available in a market when at least 1 of its tracks is available in that market.
copyrightsarray of copyright objects
The copyright statements of the album.
external_ids
an external ID object
Known external IDs for the album.
external_urlsan external URL objectKnown external URLs for this album.
genres array of strings
A list of the genres used to classify the album. For example: "Prog Rock", "Post-Grunge". (If not yet classified, the array is empty.)
hrefstringA link to the Web API endpoint providing full details of the album.
id
string
The Spotify ID for the album.
images
array of image objects
The cover art for the album in various sizes, widest first.
name
string
The name of the album.
popularity
integerThe popularity of the album. The value will be between 0 and 100, with 100 being the most popular. The popularity is calculated from the popularity of the album's individual tracks.
release_date
string
The date the album was first released, for example "1981-12-15". Depending on the precision, it might be shown as "1981" or "1981-12".
release_date_
precision
stringThe precision with which release_date value is known: "year", "month", or "day".
tracks
array of simplified track objects inside a paging object The tracks of the album.
type
string
The object type: "album"
uristringThe Spotify URI for the album.