Get Spotify track
Get a Spotify track by id or track URL.
Operation
/v1/spotify/trackHeaders
API key (`sfk_...`)
Parameters
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
Response fields
Endpoint-specific response payload.
Whether the track was found or not 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 (e.g. AUDIO).
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 (e.g. ALBUM, SINGLE).
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
Responses
Lookup result. Check `data.lookupStatus` for `found` or `not_found`.
Error codes