Headers
Get your API keyAPI key (`sfk_...`)
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
Endpoint-specific response payload.
Whether the album was 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.
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
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/spotify/album?albumId=0pgrg7phBbnwGJ2HBEl9EG" \
-H "x-api-key: YOUR_API_KEY"Responses
Album lookup result.