Spotify Web API

Get Multiple Albums

GET

/albums

category-albums

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

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

200 - 示例 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"
    }
  ]
}

请求参数

Query 参数

ids

必需

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

market

可选

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

Header 参数

Authorization

必需

A valid user access token or your client credentials.

返回响应

🟢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}]

可选

album_type

string

可选

The type of the album: album, single, or compilation.

artists

array[object (ArtistObject) {10}]

可选

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

available_markets

array[string]

可选

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[object (CopyrightObject) {2}]

可选

The copyright statements of the album.

external_ids

object (ExternalIdObject)

可选

external_urls

object (ExternalUrlObject)

可选

genres

array[string]

可选

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.

string

可选

The Spotify ID for the album.

images

array[object (ImageObject) {3}]

可选

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 <int32>

可选

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".

restrictions

object (AlbumRestrictionObject)

可选

total_tracks

integer <int32>

可选

The total number of tracks in the album.

tracks

object

可选

The tracks of the album.

type

string

可选

The object type: "album"

uri

string

可选

The Spotify URI for the album.

🔴500500

Get an Album