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 6 credits per call — no OAuth, scraping or platform SDKs. Get full Spotify video metadata — title, views, likes, duration, and more.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. Results are cached for 24 hours, so repeat calls are free.
Code example
curl "https://api.captapi.com/v1/spotify/album?url=https%3A%2F%2Fopen.spotify.com%2Fartist%2F06HL4z0CvFAxyc27GXpf02" \
-H "Authorization: Bearer capt_live_..."What the response looks like
{
"success": true,
"cached": false,
"creditsUsed": 6,
"data": {
"platform": "spotify",
"type": "album",
"uri": "spotify:album:151w1FgRZfnKZA9FEcg9Z3",
"url": "https://open.spotify.com/album/151w1FgRZfnKZA9FEcg9Z3",
"name": "Midnights",
"description": null,
"artists": [
"Taylor Swift"
],
"album": null,
"durationMs": null,
"playCount": null,
"followers": null,
"monthlyListeners": null,
"releaseYear": 2022,
"image": "https://i.scdn.co/image/ab67616d00001e02bb54dde68cd23e2a268ae0f5",
"totalTracks": 13,
"totalEpisodes": 13,
"raw": {
"__typename": "Album",
"uri": "spotify:album:151w1FgRZfnKZA9FEcg9Z3",
"url": "https://open.spotify.com/album/151w1FgRZfnKZA9FEcg9Z3",
"id": "151w1FgRZfnKZA9FEcg9Z3",
"name": "Midnights",
"type": "ALBUM",
"date": {
"isoString": "2022-10-21T00:00:00Z",
"precision": "DAY"
},
"label": "Taylor Swift",
"courtesyLine": "",
"isPreRelease": false,
"preReleaseEndDateTime": null,
"saved": false,
"playability": {
"playable": true,
"reason": "PLAYABLE"
},
"sharingInfo": {
"shareId": "pJZKFx1lSXCauzUkzxsogA",
"shareUrl": "https://open.spotify.com/album/151w1FgRZfnKZA9FEcg9Z3?si=pJZKFx1lSXCauzUkzxsogA"
},
"copyright": {
"items": [
{
"text": "© 2022 Taylor Swift",
"type": "C"
},
{
"text": "℗ 2022 Taylor Swift",
"type": "P"
}
],
"totalCount": 2
},
"coverArt": {
"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
}
]
},
"artists": {
"items": [
{
"id": "06HL4z0CvFAxyc27GXpf02",
"profile": {
"name": "Taylor Swift"
},
"sharingInfo": {
"shareUrl": "https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02?si=Lc8FdbGORPC9Fd4xcxPzyg"
},
"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
},
"discs": {
"items": [
{
"number": 1,
"tracks": {
"totalCount": 13
}
}
],
"totalCount": 1
},
"releases": {
"items": [
{
"name": "Midnights",
"uri": "spotify:album:4moVP48t9bji7djUc5VOvi"
}
],
"totalCount": 1
},
"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": "897505453",
"relinkingInformation": null,
"saved": false,
"trackNumber": 1,
"uri": "spotify:track:5jQI2r1RdgtuT8S3iG8zFC"
},
"uid": "6a22a05d1c8523acd991"
}
],
"totalCount": 13
},
"moreAlbumsByArtist": {
"items": [
{
"discography": {
"popularReleasesAlbums": {
"items": [
{
"coverArt": {
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02d7812467811a7da6e6a44902",
"width": 300
},
{
"height": 64,
"url": "https://i.scdn.co/image/ab67616d00004851d7812467811a7da6e6a44902",
"width": 64
},
{
"height": 640,
"url": "https://i.scdn.co/image/ab67616d0000b273d7812467811a7da6e6a44902",
"width": 640
}
]
},
"date": {
"year": 2025
},
"id": "4a6NzYL1YHRUgx9e3YZI6I",
"name": "The Life of a Showgirl",
"playability": {
"playable": true,
"reason": "PLAYABLE"
},
"sharingInfo": {
"shareId": "595SuRu7SUu9Z-CcGzsoNQ",
"shareUrl": "https://open.spotify.com/album/4a6NzYL1YHRUgx9e3YZI6I?si=595SuRu7SUu9Z-CcGzsoNQ"
},
"type": "ALBUM",
"uri": "spotify:album:4a6NzYL1YHRUgx9e3YZI6I"
},
{
"coverArt": {
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02e787cffec20aa2a396a61647",
"width": 300
},
{
"height": 64,
"url": "https://i.scdn.co/image/ab67616d00004851e787cffec20aa2a396a61647",
"width": 64
},
{
"height": 640,
"url": "https://i.scdn.co/image/ab67616d0000b273e787cffec20aa2a396a61647",
"width": 640
}
]
},
"date": {
"year": 2019
},
"id": "1NAmidJlEaVgA3MpcPFYGq",
"name": "Lover",
"playability": {
"playable": true,
"reason": "PLAYABLE"
},
"sharingInfo": {
"shareId": "OCRAGMmbRKOM39GBQqJZjQ",
"shareUrl": "https://open.spotify.com/album/1NAmidJlEaVgA3MpcPFYGq?si=OCRAGMmbRKOM39GBQqJZjQ"
},
"type": "ALBUM",
"uri": "spotify:album:1NAmidJlEaVgA3MpcPFYGq"
},
{
"coverArt": {
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02da5d5aeeabacacc1263c0f4b",
"width": 300
},
{
"height": 64,
"url": "https://i.scdn.co/image/ab67616d00004851da5d5aeeabacacc1263c0f4b",
"width": 64
},
{
"height": 640,
"url": "https://i.scdn.co/image/ab67616d0000b273da5d5aeeabacacc1263c0f4b",
"width": 640
}
]
},
"date": {
"year": 2017
},
"id": "6DEjYFkNZh67HP7R9PSZvv",
"name": "reputation",
"playability": {
"playable": true,
"reason": "PLAYABLE"
},
"sharingInfo": {
"shareId": "K-_NQVOzRJ2hZgppK4ITSg",
"shareUrl": "https://open.spotify.com/album/6DEjYFkNZh67HP7R9PSZvv?si=K-_NQVOzRJ2hZgppK4ITSg"
},
"type": "ALBUM",
"uri": "spotify:album:6DEjYFkNZh67HP7R9PSZvv"
},
{
"coverArt": {
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e0295f754318336a07e85ec59bc",
"width": 300
},
{
"height": 64,
"url": "https://i.scdn.co/image/ab67616d0000485195f754318336a07e85ec59bc",
"width": 64
},
{
"height": 640,
"url": "https://i.scdn.co/image/ab67616d0000b27395f754318336a07e85ec59bc",
"width": 640
}
]
},
"date": {
"year": 2020
},
"id": "2fenSS68JI1h4Fo296JfGr",
"name": "folklore",
"playability": {
"playable": true,
"reason": "PLAYABLE"
},
"sharingInfo": {
"shareId": "7ScCPdVZTyOikHI7x0dKug",
"shareUrl": "https://open.spotify.com/album/2fenSS68JI1h4Fo296JfGr?si=7ScCPdVZTyOikHI7x0dKug"
},
"type": "ALBUM",
"uri": "spotify:album:2fenSS68JI1h4Fo296JfGr"
},
{
"coverArt": {
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e028ecc33f195df6aa257c39eaa",
"width": 300
},
{
"height": 64,
"url": "https://i.scdn.co/image/ab67616d000048518ecc33f195df6aa257c39eaa",
"width": 64
},
{
"height": 640,
"url": "https://i.scdn.co/image/ab67616d0000b2738ecc33f195df6aa257c39eaa",
"width": 640
}
]
},
"date": {
"year": 2024
},
"id": "5H7ixXZfsNMGbIE5OBSpcb",
"name": "THE TORTURED POETS DEPARTMENT: THE ANTHOLOGY",
"playability": {
"playable": true,
"reason": "PLAYABLE"
},
"sharingInfo": {
"shareId": "kS7__Um_S56NkjWrHaHeDw",
"shareUrl": "https://open.spotify.com/album/5H7ixXZfsNMGbIE5OBSpcb?si=kS7__Um_S56NkjWrHaHeDw"
},
"type": "ALBUM",
"uri": "spotify:album:5H7ixXZfsNMGbIE5OBSpcb"
}
]
}
}
}
]
},
"watchFeedEntrypoint": null
}
}
}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. |
Frequently asked questions
What does the Spotify Album API do?
The Spotify Album API lets you fetch full metadata and engagement stats from a public Spotify video using one GET request to /v1/spotify/album. It returns clean JSON — no OAuth or scraping setup required.
How many credits does the Spotify Album API cost?
Each successful call costs 6 credits. Responses are cached for 24 hours, and cached results cost 0 credits. 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, and Rumble. 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, automatic retries, and a shared 24-hour cache. Use it for RAG pipelines, analytics, monitoring, and content automation.
Ready to get Spotify album?
Start free with 100 credits — no credit card required.
Get your free API key