Get Spotify album
Get a Spotify album by id or album URL.
Operation
/v1/spotify/albumHeaders
API key (`sfk_...`)
Parameters
Optional Spotify album id for the request.
min 1 chars · max 128 chars
Optional Spotify album URL for the request.
min 1 chars · max 4096 chars
Response fields
Endpoint-specific response payload.
Whether the album was found or not found.
one of: found, not_found
Album details when available.
Platform for this album.
one of: spotify
Stable Spotify album identifier.
min 1 chars
Album title.
min 1 chars
Release type (album, single, compilation, etc.).
one of: album, single, compilation, ep, unknown
Record label when available.
Release date as an ISO 8601 string when available.
min 1 chars
Precision of the release date when available.
one of: day, month, year
Best available square cover image URL when available.
Canonical public Spotify album URL.
min 1 chars
Whether the album is playable on Spotify.
Whether the album is marked as a pre-release.
Copyright lines when available.
Copyright notice text.
min 1 chars
Copyright type code (e.g. C or P).
min 1 chars
Album artists when available.
Spotify artist id.
min 1 chars
Artist display name on this album.
min 1 chars
Canonical public Spotify artist profile URL.
min 1 chars
Best available square avatar image URL when available.
Number of tracks on the album.
≥ 0
Album tracks in track order.
Stable Spotify track identifier.
min 1 chars
Track title.
min 1 chars
Track number on the disc.
≥ 0
Disc number for this track.
≥ 0
Track duration in milliseconds.
≥ 0
Whether the track is marked explicit.
Reported play count when available.
≥ 0
Artists credited on this track.
Spotify artist id for this track.
min 1 chars
Artist display name on this track.
min 1 chars
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Lookup result. Check `data.lookupStatus` for `found` or `not_found`.
Error codes