> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/spotify/search>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/spotify/search.mdx>

---

# Spotify Search API

Everything Spotify matches for a search, grouped by kind, up to 20 of each.

`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.

## Request

- **Endpoint:** `GET /v1/spotify/search`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by query
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/spotify/search/get)
- **Platform page:** [/platforms/spotify](https://www.socialfetch.dev/platforms/spotify)

## 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.
