Headers
Get your API keyAPI key (`sfk_...`)
Optional Spotify track id for the request.
min 1 chars · max 128 chars
Optional Spotify track URL for the request.
min 1 chars · max 4096 chars
Endpoint-specific response payload.
Whether the track was found.
one of: found, not_found
Track details when available.
Platform for this track.
one of: spotify
Stable Spotify track identifier.
min 1 chars
Track title.
min 1 chars
Track duration in milliseconds.
≥ 0
Track number on the album when available.
≥ 0
Whether the track is marked explicit when available.
Whether the track is playable in the current context.
Play count when available.
≥ 0
Media type when available.
min 1 chars
Short audio preview URL when available.
min 1 chars
Canonical public Spotify track URL.
min 1 chars
Album details when available.
Spotify album identifier.
min 1 chars
Album title.
min 1 chars
Album type when available.
min 1 chars
Release year when available.
Release date ISO string when available.
min 1 chars
Best available album cover image URL when available.
Canonical public Spotify album URL when available.
min 1 chars
Number of tracks on the album when available.
≥ 0
Artists credited on the track (may be empty).
Spotify artist identifier.
min 1 chars
Artist display name.
min 1 chars
Best available artist avatar URL when available.
Canonical public Spotify artist profile URL when available.
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/track?trackId=1ITJflybJsfarsUtiBvkfK" \
-H "x-api-key: YOUR_API_KEY"Responses
Lookup result. Check `data.lookupStatus` for `found` or `not_found`.