Spotify Web API
  1. category-albums
Spotify Web API
  • category-albums
    • Get Multiple Albums
      GET
    • Get an Album
      GET
    • Get an Album's Tracks
      GET
  • category-artists
    • Get Multiple Artists
      GET
    • Get an Artist
      GET
    • Get an Artist's Albums
      GET
    • Get an Artist's Related Artists
      GET
    • Get an Artist's Top Tracks
      GET
  • category-tracks
    • Get Audio Analysis for a Track
      GET
    • Get Audio Features for Several Tracks
      GET
    • Get Audio Features for a Track
      GET
    • Get Several Tracks
      GET
    • Get a Track
      GET
  • category-browse
    • Get All Categories
      GET
    • Get a Category
      GET
    • Get a Category's Playlists
      GET
    • Get All Featured Playlists
      GET
    • Get All New Releases
      GET
    • Get Recommendations
      GET
    • Get Recommendation Genres
      GET
  • category-episodes
    • Get Multiple Episodes
      GET
    • Get an Episode
      GET
  • category-markets
    • Get Available Markets
      GET
  • category-users-profile
    • Get Current User's Profile
    • Get a User's Profile
  • category-library
    • Remove Albums for Current User
    • Get User's Saved Albums
    • Save Albums for Current User
    • Check User's Saved Albums
    • Remove User's Saved Episodes
    • Get User's Saved Episodes
    • Save Episodes for User
    • Check User's Saved Episodes
    • Remove User's Saved Shows
    • Get User's Saved Shows
    • Save Shows for Current User
    • Check User's Saved Shows
    • Remove User's Saved Tracks
    • Get User's Saved Tracks
    • Save Tracks for User
    • Check User's Saved Tracks
  • category-follow
    • Unfollow Artists or Users
    • Get User's Followed Artists
    • Follow Artists or Users
    • Get Following State for Artists/Users
    • Unfollow Playlist
    • Follow a Playlist
    • Check if Users Follow a Playlist
  • category-player
    • Get Information About The User's Current Playback
    • Transfer a User's Playback
    • Get the User's Currently Playing Track
    • Get a User's Available Devices
    • Skip User’s Playback To Next Track
    • Pause a User's Playback
    • Start/Resume a User's Playback
    • Skip User’s Playback To Previous Track
    • Add an item to queue
    • Get Current User's Recently Played Tracks
    • Set Repeat Mode On User’s Playback
    • Seek To Position In Currently Playing Track
    • Toggle Shuffle For User’s Playback
    • Set Volume For User's Playback
  • category-playlists
    • Get a List of Current User's Playlists
    • Get a Playlist
    • Change a Playlist's Details
    • Get a Playlist Cover Image
    • Upload a Custom Playlist Cover Image
    • Remove Items from a Playlist
    • Get a Playlist's Items
    • Add Items to a Playlist
    • Reorder or Replace a Playlist's Items
    • Get a List of a User's Playlists
    • Create a Playlist
  • category-personalization
    • Get a User's Top Artists and Tracks
  • category-search
    • Search for an Item
  • category-shows
    • Get Multiple Shows
    • Get a Show
    • Get a Show's Episodes
  1. category-albums

Get an Album

Developing
GET
/albums/{id}
category-albums
Get Spotify catalog information for a single album.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.spotify.com/v1/albums/' \
--header 'Authorization;'
Response Response Example
200 - Example 1
{
  "album_type": "string",
  "artists": [
    {
      "external_urls": {
        "spotify": "string"
      },
      "followers": {
        "href": "string",
        "total": 0
      },
      "genres": [
        "string"
      ],
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 0,
          "url": "string",
          "width": 0
        }
      ],
      "name": "string",
      "popularity": 0,
      "type": "string",
      "uri": "string"
    }
  ],
  "available_markets": [
    "string"
  ],
  "copyrights": [
    {
      "text": "string",
      "type": "string"
    }
  ],
  "external_ids": {
    "ean": "string",
    "isrc": "string",
    "upc": "string"
  },
  "external_urls": {
    "spotify": "string"
  },
  "genres": [
    "string"
  ],
  "href": "string",
  "id": "string",
  "images": [
    {
      "height": 0,
      "url": "string",
      "width": 0
    }
  ],
  "label": "string",
  "name": "string",
  "popularity": 0,
  "release_date": "string",
  "release_date_precision": "string",
  "restrictions": {
    "reason": "string"
  },
  "total_tracks": 0,
  "tracks": {
    "href": "string",
    "items": [
      {
        "artists": [
          {
            "external_urls": {
              "spotify": "string"
            },
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          }
        ],
        "available_markets": [
          "string"
        ],
        "disc_number": 0,
        "duration_ms": 0,
        "explicit": true,
        "external_urls": {
          "spotify": "string"
        },
        "href": "string",
        "id": "string",
        "is_local": true,
        "is_playable": true,
        "linked_from": {
          "external_urls": {
            "spotify": "string"
          },
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "name": "string",
        "preview_url": "string",
        "restrictions": {
          "reason": "string"
        },
        "track_number": 0,
        "type": "string",
        "uri": "string"
      }
    ],
    "limit": 0,
    "next": "string",
    "offset": 0,
    "previous": "string",
    "total": 0
  },
  "type": "string",
  "uri": "string"
}

Request

Path Params
id
string 
required
The Spotify ID of the album.
Query Params
market
string 
optional
The market you'd like to request. Synonym for country.
Header Params
Authorization
string 
required
A valid user access token or your client credentials.

Responses

🟢200On success, the HTTP status code in the response header is 200 OK and the response body contains an album object in JSON format. On error, the header status code is an error code and the response body contains an error object.
application/json
Body
album_type
string 
optional
The type of the album.
artists
array[object (ArtistObject) {10}] 
optional
The artists of the album. Each artist object includes a link in href to more detailed information about the artist.
external_urls
object (ExternalUrlObject) 
optional
followers
object (FollowersObject) 
optional
genres
array[string]
optional
A list of the genres the artist is associated with. If not yet classified, the array is empty.
href
string 
optional
A link to the Web API endpoint providing full details of the artist.
id
string 
optional
The Spotify ID for the artist.
images
array[object (ImageObject) {3}] 
optional
Images of the artist in various sizes, widest first.
name
string 
optional
The name of the artist.
popularity
integer <int32>
optional
The popularity of the artist. The value will be between 0 and 100, with 100 being the most popular. The artist's popularity is calculated from the popularity of all the artist's tracks.
type
string 
optional
The object type.
uri
string 
optional
The Spotify URI for the artist.
available_markets
array[string]
optional
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 one of its tracks is available in that market.
copyrights
array[object (CopyrightObject) {2}] 
optional
The copyright statements of the album.
text
string 
optional
The copyright text for this content.
type
string 
optional
The type of copyright: C = the copyright, P = the sound recording (performance) copyright.
external_ids
object (ExternalIdObject) 
optional
ean
string 
optional
International Article Number
isrc
string 
optional
International Standard Recording Code
upc
string 
optional
Universal Product Code
external_urls
object (ExternalUrlObject) 
optional
genres
array[string]
optional
A list of the genres used to classify the album. (If not yet classified, the array is empty.)
href
string 
optional
A link to the Web API endpoint providing full details of the album.
id
string 
optional
The Spotify ID for the album.
images
array[object (ImageObject) {3}] 
optional
The cover art for the album in various sizes, widest first.
height
integer <int32>
optional
The image height in pixels.
url
string 
optional
The source URL of the image.
width
integer <int32>
optional
The image width in pixels.
label
string 
optional
The label for the album.
name
string 
optional
The name of the album. In case of an album takedown, the value may be an empty string.
popularity
integer <int32>
optional
The popularity of the album, with 100 being the most popular. The popularity is calculated from the popularity of the album's individual tracks.
release_date
string 
optional
The date the album was first released. Depending on the precision, it might be shown as "1981" or "1981-12".
release_date_precision
string 
optional
The precision with which release_date value is known.
restrictions
object (AlbumRestrictionObject) 
optional
reason
string 
optional
The reason for the restriction. Albums may be restricted if the content is not available in a given market, to the user's subscription type, or when the user's account is set to not play explicit content. Additional reasons may be added in the future.
total_tracks
integer <int32>
optional
The total number of tracks in the album.
tracks
object 
optional
The tracks of the album.
href
string 
optional
A link to the Web API endpoint returning the full result of the request
items
array[object (SimplifiedTrackObject) {17}] 
optional
The requested data.
limit
integer <int32>
optional
The maximum number of items in the response (as set in the query or by default).
next
string 
optional
URL to the next page of items. ( null if none)
offset
integer <int32>
optional
The offset of the items returned (as set in the query or by default)
previous
string 
optional
URL to the previous page of items. ( null if none)
total
integer <int32>
optional
The total number of items available to return.
type
string 
optional
The object type.
uri
string 
optional
The Spotify URI for the album.
🔴500500
Modified at 2022-09-12 10:04:50
Previous
Get Multiple Albums
Next
Get an Album's Tracks
Built with