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
Code example
curl "https://api.socialfetch.dev/v1/spotify/album?albumId=0pgrg7phBbnwGJ2HBEl9EG" \
-H "x-api-key: YOUR_API_KEY"Responses
Lookup result. Check `data.lookupStatus` for `found` or `not_found`.