Spotify Get Album API

Retrieve full details for a Spotify album. This endpoint is a proxy to the official Spotify Get Album API.

Endpoint

GET https://api.recoupable.com/api/spotify/album

Parameters

Name	Type	Required	Description
id	string	Yes	The Spotify ID of the album.
market	string	No	An ISO 3166-1 alpha-2 country code. If provided, only content available in that market is returned.

Request Examples

cURL

curl -X GET "https://api.recoupable.com/api/spotify/album?id=4aawyAB9vmqN3uQ7FjRGTy&market=ES" \
  -H "Content-Type: application/json"

Example Response

{
  "album_type": "compilation",
  "total_tracks": 9,
  "available_markets": ["CA", "BR", "IT"],
  "external_urls": {
    "spotify": "string"
  },
  "href": "string",
  "id": "2up3OPMp9Tb4dAKM2erWXQ",
  "images": [
    {
      "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228",
      "height": 300,
      "width": 300
    }
  ],
  "name": "string",
  "release_date": "1981-12",
  "release_date_precision": "year",
  "restrictions": {
    "reason": "market"
  },
  "type": "album",
  "uri": "spotify:album:2up3OPMp9Tb4dAKM2erWXQ",
  "artists": [
    {
      "external_urls": {
        "spotify": "string"
      },
      "href": "string",
      "id": "string",
      "name": "string",
      "type": "artist",
      "uri": "string"
    }
  ],
  "tracks": {
    "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20",
    "limit": 20,
    "next": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",
    "offset": 0,
    "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",
    "total": 4,
    "items": [
      {
        "artists": [
          {
            "external_urls": {
              "spotify": "string"
            },
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "artist",
            "uri": "string"
          }
        ],
        "available_markets": ["string"],
        "disc_number": 0,
        "duration_ms": 0,
        "explicit": false,
        "external_urls": {
          "spotify": "string"
        },
        "href": "string",
        "id": "string",
        "is_playable": false,
        "linked_from": {
          "external_urls": {
            "spotify": "string"
          },
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "restrictions": {
          "reason": "string"
        },
        "name": "string",
        "preview_url": "string",
        "track_number": 0,
        "type": "string",
        "uri": "string",
        "is_local": false
      }
    ]
  },
  "copyrights": [
    {
      "text": "string",
      "type": "string"
    }
  ],
  "external_ids": {
    "isrc": "string",
    "ean": "string",
    "upc": "string"
  },
  "genres": [],
  "label": "string",
  "popularity": 0
}

Response Properties

Property	Type	Description
album_type	string	The type of the album. Allowed values: "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	Known external URLs for this album.
href	string	A link to the Web API endpoint providing full details of the album.
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	string	The precision with which `release_date` value is known.
restrictions	object	Included when a content restriction is applied.
type	string	The object type. Always "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).

For full details on nested objects and additional fields, see the Spotify Get Album documentation.

Notes

The tracks object is paginated; use its next and previous URLs to navigate through track listings.