Albums

Get Album

Changed on

Get Spotify catalog information for a single album.

get/albums/{id}

Request

  • Base URL
    https://api.spotify.com/v1
  • URL
    https://api.spotify.com/v1/albums/{id}
  • Auth
    OAuth 2
    Authorization code: https://accounts.spotify.com/authorize
    Token URL: https://accounts.spotify.com/api/token

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": []
}

Changes

  • 1602059e3988Revision changes
    • info

      response property allOf[subschema #2]/external_ids reactivated

  • 8899d6fd66eeRevision changes
    • info

      response property allOf[AlbumBase]/available_markets deprecated

    • info

      response property allOf[subschema #2]/external_ids deprecated

    • info

      response property allOf[subschema #2]/label deprecated

    • info

      response property allOf[subschema #2]/popularity deprecated

    • info

      response property allOf[subschema #2]/tracks/allOf[PagingSimplifiedTrackObject]/allOf[subschema #2]/items/items/available_markets deprecated

    • info

      response property allOf[subschema #2]/tracks/allOf[PagingSimplifiedTrackObject]/allOf[subschema #2]/items/items/linked_from deprecated