Skip to main content
GET
/
api
/
spotify
/
album
cURL
curl --request GET \
  --url https://api.recoupable.com/api/spotify/album \
  --header 'Authorization: Bearer <token>'
{
  "album_type": "album",
  "total_tracks": 123,
  "available_markets": [
    "<string>"
  ],
  "external_urls": {
    "spotify": "<string>"
  },
  "href": "<string>",
  "id": "<string>",
  "images": [
    {
      "url": "<string>",
      "height": 123,
      "width": 123
    }
  ],
  "name": "<string>",
  "release_date": "<string>",
  "release_date_precision": "year",
  "restrictions": {
    "reason": "<string>"
  },
  "type": "album",
  "uri": "<string>",
  "artists": [
    {
      "external_urls": {
        "spotify": "<string>"
      },
      "href": "<string>",
      "id": "<string>",
      "name": "<string>",
      "type": "artist",
      "uri": "<string>"
    }
  ],
  "tracks": {
    "href": "<string>",
    "limit": 123,
    "next": "<string>",
    "offset": 123,
    "previous": "<string>",
    "total": 123,
    "items": [
      {
        "artists": [
          {
            "external_urls": {
              "spotify": "<string>"
            },
            "href": "<string>",
            "id": "<string>",
            "name": "<string>",
            "type": "artist",
            "uri": "<string>"
          }
        ],
        "available_markets": [
          "<string>"
        ],
        "disc_number": 123,
        "duration_ms": 123,
        "explicit": true,
        "external_urls": {
          "spotify": "<string>"
        },
        "href": "<string>",
        "id": "<string>",
        "is_playable": true,
        "linked_from": {},
        "restrictions": {
          "reason": "<string>"
        },
        "name": "<string>",
        "preview_url": "<string>",
        "track_number": 123,
        "type": "track",
        "uri": "<string>",
        "is_local": true
      }
    ]
  },
  "copyrights": [
    {
      "text": "<string>",
      "type": "<string>"
    }
  ],
  "external_ids": {
    "isrc": "<string>",
    "ean": "<string>",
    "upc": "<string>"
  },
  "genres": [
    "<string>"
  ],
  "label": "<string>",
  "popularity": 123
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

id
string
required

The Spotify ID of the album

market
string

An ISO 3166-1 alpha-2 country code. If provided, only content available in that market is returned

Response

Album retrieved successfully

album_type
enum<string>

The type of the album

Available options:
album,
single,
compilation
total_tracks
integer

The number of tracks in the album

available_markets
string[]

Markets in which the album is available

external_urls
object
href
string

A link to the Web API endpoint providing full details

id
string

The Spotify ID for the album

images
object[]

The cover art for the album in various sizes

name
string

The name of the album

release_date
string

The date the album was first released

release_date_precision
enum<string>

The precision with which release_date value is known

Available options:
year,
month,
day
restrictions
object

Included when a content restriction is applied

type
enum<string>

The object type, always 'album'

Available options:
album
uri
string

The Spotify URI for the album

artists
object[]

The artists of the album

tracks
object

The tracks of the album

copyrights
object[]

Copyright statements of the album

external_ids
object

Known external IDs for the album

genres
string[]

Deprecated. Always empty.

label
string

The label associated with the album

popularity
integer

Popularity of the album (0-100)