Get Spotify catalog information about an artist’s albums. Optional parameters can be specified in the query string to filter and sort the response.

Endpoint

GET https://api.spotify.com/v1/artists/{id}/albums

Request Parameters

Path element
Value
id
The Spotify ID for the artist.

Query parameter
Value
album_type
Optional. 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: album_type=album,single.
market

(synonym: country)
Optional. An ISO 3166-1 alpha-2 country code. 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
Optional. The number of album objects to return. Default: 20. Minimum: 1. Maximum: 50. For example:
limit=2
offset
Optional. 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.

Response Format

On success, the HTTP status code in the response header is 200 OK and the response body contains an array of simplified album objects (wrapped in a paging object) in JSON format. 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/artists/1vCWHaC5f2uS3yhpwWbIA6/albums?market=ES&album_type=single&limit=2"
{
  "href" : "https://api.spotify.com/v1/artists/1vCWHaC5f2uS3yhpwWbIA6/albums?offset=0&limit=2&album_type=single&market=ES",
  "items" : [ {
    "album_type" : "single",
    "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" ],
    "external_urls" : {
      "spotify" : "https://open.spotify.com/album/3j3cgkuyo015dghNYhHnZJ"
    },
    "href" : "https://api.spotify.com/v1/albums/3j3cgkuyo015dghNYhHnZJ",
    "id" : "3j3cgkuyo015dghNYhHnZJ",
    "images" : [ {
      "height" : 640,
      "url" : "https://i.scdn.co/image/f8717f432506ab213c4de0c66d6ac24cd07ecf72",
      "width" : 640
    }, {
      "height" : 300,
      "url" : "https://i.scdn.co/image/502bc1e1726e2594cd0045473e10d9166fa79dd8",
      "width" : 300
    }, {
      "height" : 64,
      "url" : "https://i.scdn.co/image/d709f676d5c16db8941b1084b3ca348d35de04af",
      "width" : 64
    } ],
    "name" : "The Days",
    "type" : "album",
    "uri" : "spotify:album:3j3cgkuyo015dghNYhHnZJ"
  }, {
    "album_type" : "single",
    "available_markets" : [ "AD", "AR", "AT", "AU", "BE", "BG", "BO", "BR", "CH", "CL", "CO", "CR", "CY", "CZ", "DE", "DK", "DO", "EC", "EE", "ES", "FI", "GR", "GT", "HK", "HN", "HU", "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" ],
    "external_urls" : {
      "spotify" : "https://open.spotify.com/album/1moqjcU7BoanAsSKRdHnP1"
    },
    "href" : "https://api.spotify.com/v1/albums/1moqjcU7BoanAsSKRdHnP1",
    "id" : "1moqjcU7BoanAsSKRdHnP1",
    "images" : [ {
      "height" : 640,
      "url" : "https://i.scdn.co/image/5f8349e8e4ed81b48f033a9818939c835520f150",
      "width" : 640
    }, {
      "height" : 300,
      "url" : "https://i.scdn.co/image/8a5e05379add83b787a4cf0c3909a415e60b93ef",
      "width" : 300
    }, {
      "height" : 64,
      "url" : "https://i.scdn.co/image/84f3422d4946c71c8891c0f0fcbe78d6e7395f5f",
      "width" : 64
    } ],
    "name" : "Lay Me Down (Black Coffee Remix)",
    "type" : "album",
    "uri" : "spotify:album:1moqjcU7BoanAsSKRdHnP1"
  } ],
  "limit" : 2,
  "next" : "https://api.spotify.com/v1/artists/1vCWHaC5f2uS3yhpwWbIA6/albums?offset=2&limit=2&album_type=single&market=ES",
  "offset" : 0,
  "previous" : null,
  "total" : 41
}

Try it in our Web API Console

album object (simplified)

Key
Value Type
Value Description
album_type
string
The type of the album: one of "album", "single", or "compilation".
available_marketsarray of stringsThe 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_urlsan external URL objectKnown external URLs for this album.
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.
type
string
The object type: "album"
uristringThe Spotify URI for the album.

paging object

Key
Value Type
Value Description
hrefstringA link to the Web API endpoint returning the full result of the request.
itemsan array of objectsThe requested data.
limitintegerThe maximum number of items in the response (as set in the query or by default).
next
string
URL to the next page of items. (null if none)
offsetintegerThe offset of the items returned (as set in the query or by default).
previous
string
URL to the previous page of items. (null if none)
total
integer
The total number of items available to return.