# Spotify Search API (https://www.socialcrawl.dev/platforms/spotify/search)

> Searches Spotify playlists matching a query. Note (DR-MS-09): the upstream currently returns Playlist results only, not the full track/artist/album/episode/podcast/audiobook mix — treat non-playlist result types as unavailable until this is expanded.

TL;DR: `GET /v1/spotify/search` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search query. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/spotify/search?query=my%20first%20million" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search Spotify with an API?

Send a GET request to /v1/spotify/search with a query parameter. SocialCrawl returns matching tracks, artists, albums, episodes, podcasts, and audiobooks in one unified SearchResult response.

### What content types does the Spotify Search API cover?

Six content types: tracks, artists, albums, podcasts (shows), episodes, and audiobooks. One query searches all of them, so you don't need separate calls per type.

### Do I need OAuth to use Spotify search?

No. The official Web API requires an access token even for search. SocialCrawl needs only your x-api-key header — the same key that covers 30+ other platforms.

### How much does the Spotify Search API cost?

Each search costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required — about 100 searches before paying anything.

### Can I build a music search feature with this endpoint?

Yes. The endpoint is built for production search workloads: send the user's keyword, render the unified JSON results, and link out to Spotify with the returned URLs.

See the full Spotify API: https://www.socialcrawl.dev/platforms/spotify

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to search Spotify tracks and podcasts with an API
- What does the SocialCrawl Spotify Search API return?