Search Spotify
Search Spotify for tracks, artists, albums, playlists, podcasts, episodes and audiobooks.
Headers
Get your API keyAPI key (`sfk_...`)
Search text, such as a song, artist, podcast or playlist name (for example `my first million`).
min 1 chars · max 512 chars
Endpoint-specific response payload.
Search query string evaluated for this response.
min 1 chars
Matching Spotify tracks, up to 20.
Stable Spotify track identifier.
min 1 chars
Track title.
min 1 chars
Canonical public Spotify track URL.
min 1 chars
Track duration in milliseconds when available.
≥ 0
Whether the track is marked explicit.
Whether the track is playable on Spotify when available.
Album the track belongs to when available.
Spotify album id. Pass it to the Spotify album endpoint for the full tracklist.
min 1 chars
Album title.
min 1 chars
Best available square cover image URL when available.
Artists credited on the track.
Spotify artist id.
min 1 chars
Artist display name.
min 1 chars
Matching Spotify artists, up to 20.
Stable Spotify artist identifier.
min 1 chars
Artist display name.
min 1 chars
Canonical public Spotify artist profile URL.
min 1 chars
Best available square avatar image URL when available.
Whether the artist is marked as verified when available.
Matching Spotify albums, up to 20.
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
Release year when available.
Best available square cover image URL when available.
Canonical public Spotify album URL.
min 1 chars
Artists credited on the album.
Spotify artist id.
min 1 chars
Artist display name.
min 1 chars
Matching Spotify playlists, up to 20.
Stable Spotify playlist identifier.
min 1 chars
Playlist title.
min 1 chars
Playlist description as plain text when available.
Best available playlist cover image URL when available.
Canonical public Spotify playlist URL.
min 1 chars
Playlist owner when available.
Spotify user id of the owner.
min 1 chars
Owner display name when available.
Public Spotify profile URL of the owner.
min 1 chars
Matching Spotify podcasts, up to 20.
Stable Spotify podcast identifier. Pass it to the Spotify podcast endpoints.
min 1 chars
Podcast title.
min 1 chars
Podcast publisher when available.
Best available square cover image URL when available.
Canonical public Spotify podcast URL.
min 1 chars
Media format: audio, video, mixed (audio and video episodes) or unknown.
one of: audio, video, mixed, unknown
Topics Spotify lists for the podcast (may be empty).
min 1 chars
Matching Spotify podcast episodes, up to 20.
Stable Spotify episode identifier.
min 1 chars
Episode title.
min 1 chars
Episode description as plain text when available.
Episode duration in milliseconds when available.
≥ 0
Release date and time as an ISO 8601 string when available.
Whether the episode is marked explicit.
Best available square cover image URL when available.
Canonical public Spotify episode URL.
min 1 chars
Podcast the episode belongs to when available.
Spotify podcast id.
min 1 chars
Podcast title.
min 1 chars
Podcast publisher when available.
Matching Spotify audiobooks, up to 20.
Stable Spotify audiobook identifier.
min 1 chars
Audiobook title.
min 1 chars
Author names (may be empty).
min 1 chars
Audiobook description as plain text when available.
Audiobook length in milliseconds when available.
≥ 0
Publish date as an ISO 8601 string when available.
Best available cover image URL when available.
Canonical public Spotify audiobook URL.
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/search?query=my%20first%20million" \
-H "x-api-key: YOUR_API_KEY"Responses
Spotify search results.