Get Album

Get Spotify catalog information for a single album.

GET /api/spotify/album

cURL

cURL

curl --request GET \
  --url https://api.recoupable.com/api/spotify/album \
  --header 'x-api-key: <api-key>'

200

{
  "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>",
  "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

x-api-key · string · header · required

Your Recoup API key. Learn more.

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

200

application/json

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

Show child attributes

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

Show child attributes

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

Show child attributes

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

Show child attributes

tracks · object

The tracks of the album

Show child attributes

copyrights · object[]

Copyright statements of the album

Show child attributes

external_ids · object

Known external IDs for the album

Show child attributes

genres · string[]

Deprecated. Always empty.

label · string

The label associated with the album

popularity · integer

Popularity of the album (0-100)