Spotify · Guide

How to get Spotify album

TL;DR

To get Spotify album, sign up for a free Captapi key, then send one GET request to /v1/spotify/album with your input. You get clean JSON back in seconds for 2 credits per call — no OAuth, scraping or platform SDKs. Get a Spotify album — title, artists, tracks, release date, and cover art as structured JSON.

Get your free API key API reference

How to get Spotify album (step by step)

1
Get a free API key
Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.
2
Call the Spotify Album API
Send an authenticated GET request to /v1/spotify/album with your input. No OAuth, no scraping setup.
3
Read the JSON response
Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

curl "https://api.captapi.com/v1/spotify/album?url=https%3A%2F%2Fopen.spotify.com%2Falbum%2F151w1FgRZfnKZA9FEcg9Z3%3Fsi%3D7_7dkBwYR5aqiPjykdfmvQ" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "data": {
    "platform": "spotify",
    "type": "album",
    "uri": "spotify:album:151w1FgRZfnKZA9FEcg9Z3",
    "url": "https://open.spotify.com/album/151w1FgRZfnKZA9FEcg9Z3?si=7_7dkBwYR5aqiPjykdfmvQ",
    "name": "Midnights",
    "artists": [
      "Taylor Swift"
    ],
    "releaseYear": 2022,
    "image": "https://i.scdn.co/image/ab67616d00001e02bb54dde68cd23e2a268ae0f5",
    "totalTracks": 13,
    "raw": {
      "__typename": "Album",
      "uri": "spotify:album:151w1FgRZfnKZA9FEcg9Z3",
      "name": "Midnights",
      "artists": {
        "items": [
          {
            "id": "06HL4z0CvFAxyc27GXpf02",
            "profile": {
              "name": "Taylor Swift"
            },
            "sharingInfo": {
              "shareUrl": "https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02?si=XVaLiKf4T0G7s35SUpHQTQ"
            },
            "uri": "spotify:artist:06HL4z0CvFAxyc27GXpf02",
            "visuals": {
              "avatarImage": {
                "sources": [
                  {
                    "height": 640,
                    "url": "https://i.scdn.co/image/ab6761610000e5ebe2e8e7ff002a4afda1c7147e",
                    "width": 640
                  },
                  {
                    "height": 160,
                    "url": "https://i.scdn.co/image/ab6761610000f178e2e8e7ff002a4afda1c7147e",
                    "width": 160
                  },
                  {
                    "height": 320,
                    "url": "https://i.scdn.co/image/ab67616100005174e2e8e7ff002a4afda1c7147e",
                    "width": 320
                  }
                ]
              }
            }
          }
        ],
        "totalCount": 1
      },
      "coverArt": {
        "extractedColors": {
          "colorDark": {
            "hex": "#7A7676"
          },
          "colorLight": {
            "hex": "#E8E0E0"
          },
          "colorRaw": {
            "hex": "#E8E0E0"
          }
        },
        "sources": [
          {
            "height": 300,
            "url": "https://i.scdn.co/image/ab67616d00001e02bb54dde68cd23e2a268ae0f5",
            "width": 300
          },
          {
            "height": 64,
            "url": "https://i.scdn.co/image/ab67616d00004851bb54dde68cd23e2a268ae0f5",
            "width": 64
          },
          {
            "height": 640,
            "url": "https://i.scdn.co/image/ab67616d0000b273bb54dde68cd23e2a268ae0f5",
            "width": 640
          }
        ]
      },
      "date": {
        "isoString": "2022-10-21T00:00:00Z",
        "precision": "DAY"
      },
      "tracksV2": {
        "items": [
          {
            "track": {
              "artists": {
                "items": [
                  {
                    "profile": {
                      "name": "Taylor Swift"
                    },
                    "uri": "spotify:artist:06HL4z0CvFAxyc27GXpf02"
                  }
                ]
              },
              "associationsV3": {
                "videoAssociations": {
                  "totalCount": 1
                }
              },
              "contentRating": {
                "label": "EXPLICIT"
              },
              "discNumber": 1,
              "duration": {
                "totalMilliseconds": 202395
              },
              "name": "Lavender Haze",
              "playability": {
                "playable": true
              },
              "playcount": "901032338",
              "saved": false,
              "trackNumber": 1,
              "uri": "spotify:track:5jQI2r1RdgtuT8S3iG8zFC"
            },
            "uid": "6a22a05d1c8523acd991"
          }
        ],
        "totalCount": 13
      },
      "sharingInfo": {
        "shareId": "7_7dkBwYR5aqiPjykdfmvQ",
        "shareUrl": "https://open.spotify.com/album/151w1FgRZfnKZA9FEcg9Z3?si=7_7dkBwYR5aqiPjykdfmvQ"
      }
    }
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

Name	Type	Required	Description
url	string	Yes	Spotify URL, URI, or ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
cache	boolean	No	Set true to serve from the 24h response cache. Default false — always fetch fresh data.

Frequently asked questions

What does the Spotify Album API do?

The Spotify Album API lets you fetch full metadata and key stats from a public Spotify sound or track using one GET request to /v1/spotify/album. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Spotify Album API cost?

Each successful call costs 2 credits. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Failed or empty results are never charged.

Do I need a Spotify API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

Is the Spotify Album API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Use it for analytics, monitoring, and content automation.

Ready to get Spotify album?

Start free with 100 credits — no credit card required.

Get your free API key