Spotify Web API

Get Multiple Albums

Developing

GET

/albums

category-albums

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

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.spotify.com/v1/albums?ids=' \
--header 'Authorization;'

Response Example

200 - Example 1

{
  "albums": [
    {
      "album_type": "string",
      "artists": [
        {
          "external_urls": {
            "spotify": "string"
          },
          "followers": {
            "href": "string",
            "total": 0
          },
          "genres": [
            "string"
          ],
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 0,
              "url": "string",
              "width": 0
            }
          ],
          "name": "string",
          "popularity": 0,
          "type": "string",
          "uri": "string"
        }
      ],
      "available_markets": [
        "string"
      ],
      "copyrights": [
        {
          "text": "string",
          "type": "string"
        }
      ],
      "external_ids": {
        "ean": "string",
        "isrc": "string",
        "upc": "string"
      },
      "external_urls": {
        "spotify": "string"
      },
      "genres": [
        "string"
      ],
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 0,
          "url": "string",
          "width": 0
        }
      ],
      "label": "string",
      "name": "string",
      "popularity": 0,
      "release_date": "string",
      "release_date_precision": "string",
      "restrictions": {
        "reason": "string"
      },
      "total_tracks": 0,
      "tracks": {
        "href": "string",
        "items": [
          {
            "artists": [
              {
                "external_urls": {
                  "spotify": "string"
                },
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              }
            ],
            "available_markets": [
              "string"
            ],
            "disc_number": 0,
            "duration_ms": 0,
            "explicit": true,
            "external_urls": {
              "spotify": "string"
            },
            "href": "string",
            "id": "string",
            "is_local": true,
            "is_playable": true,
            "linked_from": {
              "external_urls": {
                "spotify": "string"
              },
              "href": "string",
              "id": "string",
              "type": "string",
              "uri": "string"
            },
            "name": "string",
            "preview_url": "string",
            "restrictions": {
              "reason": "string"
            },
            "track_number": 0,
            "type": "string",
            "uri": "string"
          }
        ],
        "limit": 0,
        "next": "string",
        "offset": 0,
        "previous": "string",
        "total": 0
      },
      "type": "string",
      "uri": "string"
    }
  ]
}

Request

Query Params

ids

string

required

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

market

string

optional

An ISO 3166-1 alpha-2 country code or the string from_token. Provide this parameter if you want to apply Track Relinking.

Header Params

Authorization

string

required

A valid user access token or your client credentials.

Responses

🟢200On 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](https://developer.spotify.com/documentation/web-api/reference/#object-album

application/json

Body

albums

array[object (AlbumObject) {20}]

optional

album_type

string

optional

The type of the album.

artists

array[object (ArtistObject) {10}]

optional

The artists of the album. Each artist object includes a link in href to more detailed information about the artist.

available_markets

array[string]

optional

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 one of its tracks is available in that market.

copyrights

array[object (CopyrightObject) {2}]

optional

The copyright statements of the album.

external_ids

object (ExternalIdObject)

optional

external_urls

object (ExternalUrlObject)

optional

genres

array[string]

optional

A list of the genres used to classify the album. (If not yet classified, the array is empty.)

href

string

optional

A link to the Web API endpoint providing full details of the album.

string

optional

The Spotify ID for the album.

images

array[object (ImageObject) {3}]

optional

The cover art for the album in various sizes, widest first.

label

string

optional

The label for the album.

name

string

optional

The name of the album. In case of an album takedown, the value may be an empty string.

popularity

integer <int32>

optional

The popularity of the album, with 100 being the most popular. The popularity is calculated from the popularity of the album's individual tracks.

release_date

string

optional

The date the album was first released. Depending on the precision, it might be shown as "1981" or "1981-12".

release_date_precision

string

optional

The precision with which release_date value is known.

restrictions

object (AlbumRestrictionObject)

optional

total_tracks

integer <int32>

optional

The total number of tracks in the album.

tracks

object

optional

The tracks of the album.

type

string

optional

The object type.

uri

string

optional

The Spotify URI for the album.

🔴500500

Modified at 2022-09-12 10:04:50

Get an Album