Sign in

v1

latestOpenAPI 3.0.32026-07-139687282.9 KB
Albums

Get Album

Get Spotify catalog information for a single album.

get/albums/{id}

Path parameters

idstring required

The Spotify ID of the album.

Example:4aawyAB9vmqN3uQ7FjRGTy

Query parameters

marketstring

An ISO 3166-1 alpha-2 country code. If a country code is specified, only content that is available in that market will be returned.<br/> If a valid user access token is specified in the request header, the country associated with the user account will take priority over this parameter.<br/> Note: If neither market or user country are provided, the content is considered unavailable for the client.<br/> Users can view the country that is associated with their account in the account settings.

Example:ES

Response

An album

album_type'album' | 'single' | 'compilation' required

The type of the album.

total_tracksinteger required

The number of tracks in the album.

available_marketsstring[] required

The markets in which the album is available: ISO 3166-1 alpha-2 country codes. NOTE: an album is considered available in a market when at least 1 of its tracks is available in that market.

hrefstring required

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

idstring required

The Spotify ID for the album.

namestring required

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

release_datestring required

The date the album was first released.

release_date_precision'year' | 'month' | 'day' required

The precision with which release_date value is known.

type'album' required

The object type.

uristring required

The Spotify URI for the album.

genresstring[] required

Deprecated The array is always empty.

labelstring required

The label associated with the album.

popularityinteger required

The popularity of the album. The value will be between 0 and 100, with 100 being the most popular.

Example response

{
  "album_type": "compilation",
  "total_tracks": 9,
  "available_markets": [
    "CA",
    "BR",
    "IT"
  ],
  "id": "2up3OPMp9Tb4dAKM2erWXQ",
  "images": [
    {
      "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
      "height": 300,
      "width": 300
    }
  ],
  "release_date": "1981-12",
  "release_date_precision": "year",
  "uri": "spotify:album:2up3OPMp9Tb4dAKM2erWXQ",
  "tracks": {
    "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20\n",
    "limit": 20,
    "next": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",
    "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",
    "total": 4
  },
  "genres": []
}
All 96 operations