Get an Artist's Albums

GET

/artists/{id}/albums

category-artists

Get Spotify catalog information about an artist's albums.

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

200 - 示例 1

{
  "href": "string",
  "items": [
    {
      "album_group": "string",
      "album_type": "string",
      "artists": [
        {
          "external_urls": {
            "spotify": "string"
          },
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        }
      ],
      "available_markets": [
        "string"
      ],
      "external_urls": {
        "spotify": "string"
      },
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 0,
          "url": "string",
          "width": 0
        }
      ],
      "name": "string",
      "release_date": "string",
      "release_date_precision": "string",
      "restrictions": {
        "reason": "string"
      },
      "total_tracks": 0,
      "type": "string",
      "uri": "string"
    }
  ],
  "limit": 0,
  "next": "string",
  "offset": 0,
  "previous": "string",
  "total": 0
}

请求参数

Path 参数

必需

The Spotify ID for the artist.

Query 参数

include_groups

可选

A comma-separated list of keywords that will be used to filter the response. If not supplied, all album types will be returned. Valid values are:

album

single

appears_on

compilation
For example: include_groups=album,single.

market

可选

Synonym for country. An ISO 3166-1 alpha-2 country code or the string from_token.
Supply this parameter to limit the response to one particular geographical market. For example, for albums available in Sweden: market=SE.
If not given, results will be returned for all markets and you are likely to get duplicate results per album, one for each market in which the album is available!

limit

可选

The number of album objects to return. Default: 20. Minimum: 1. Maximum: 50. For example: limit=2

offset

可选

The index of the first album to return. Default: 0 (i.e., the first album). Use with limit to get the next set of albums.

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 array of simplified [album objects](https://developer.spotify.com/documentation/web-api/reference/#object-simplifiedalbumobject) (wrapped in a [paging ob

application/json

Body

href

string

可选

A link to the Web API endpoint returning the full result of the request

items

array[object (SimplifiedAlbumObject) {15}]

可选

The requested data.

album_group

string

可选

The field is present when getting an artist's albums. Possible values are "album", "single", "compilation", "appears_on". Compare to album_type this field represents relationship between the artist and the album.

album_type

string

可选

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

artists

array[object (SimplifiedArtistObject) {6}]

可选

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.

external_urls

object (ExternalUrlObject)

可选

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.

name

string

可选

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

release_date

string

可选

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

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.

type

string

可选

The object type: "album"

uri

string

可选

The Spotify URI for the album.

limit

integer <int32>

可选

The maximum number of items in the response (as set in the query or by default).

string

可选

URL to the next page of items. ( null if none)

offset

integer <int32>

可选

The offset of the items returned (as set in the query or by default)

string

可选

URL to the previous page of items. ( null if none)

total

integer <int32>

可选

The total number of items available to return.

🔴500500

Get an Artist

Get an Artist's Related Artists