Endpoint

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

Request Parameters

Header Fields

Header Field Value
Authorization Required. A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details.

Query Parameters

Query Parameter Value
ids Required. A comma-separated list of the Spotify IDs for the albums. Maximum: 20 IDs.
market Optional. An ISO 3166-1 alpha-2 country code or the string from_token. 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" -H "Authorization: Bearer {your access token}"
{
  "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

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.
copyrights array of copyright objects The copyright statements of the album.
external_ids an external ID object Known external IDs for the album.
external_urls an external URL object Known 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.)
href string A 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.
label string The label for the album.
name string The name of the album. In case of an album takedown, the value may be an empty string.
popularity integer The 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 string The 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”
uri string The Spotify URI for the album.