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
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/track?trackId=1ITJflybJsfarsUtiBvkfK" \
-H "x-api-key: YOUR_API_KEY"Responses
Track lookup result.