Spotify Search API
Everything Spotify matches for a search, grouped by kind, up to 20 of each.
GET /v1/spotify/search1 credit Failed requests are free
About this endpoint
GET /v1/spotify/search takes query, such as a song, artist, podcast or playlist name. One request returns tracks, artists, albums, playlists, podcasts, episodes and audiobooks, up to 20 of each, in Spotify's own order. Each row carries its Spotify id and public URL, so you can pass it straight to the artist, album, track, podcast or playlist routes.
Spotify matches loosely: a query with no close match still returns the nearest results, so check titles before you treat a row as the thing you meant. There is no paging; refine the query instead.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Spotify Search API FAQ
How do I search Spotify through an API?
Call GET /v1/spotify/search with your Social Fetch API key (x-api-key) and a query parameter. The response groups results into tracks, artists, albums, playlists, podcasts, episodes and audiobooks.
How much does the Spotify Search API cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
How do I find a podcast id for the podcast routes?
Search for the podcast's name and read data.podcasts[].podcastId. Pass it as podcastId to GET /v1/spotify/podcast or GET /v1/spotify/podcast/episodes.
Can I page through more than 20 results?
No. Spotify returns up to 20 of each kind for a search. Use a more specific query to narrow the results.