Sign in

v1

latestOpenAPI 3.0.32026-07-148993228.8 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.

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.

total_tracksinteger required

The number of tracks in the album.

type'album' required

The object type.

uristring required

The Spotify URI for the album.

genresstring[]

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

labelstring

The label for the album.

popularityinteger

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

Example response

{
  "album_type": "compilation",
  "available_markets": [
    "CA",
    "BR",
    "IT"
  ],
  "id": "2up3OPMp9Tb4dAKM2erWXQ",
  "images": [
    {
      "height": 300,
      "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
      "width": 300
    }
  ],
  "release_date": "1981-12",
  "release_date_precision": "year",
  "total_tracks": 9,
  "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
  }
}