Search
/api/spotify/search
Search tracks, albums, artists, playlists, podcasts and episodes
Scrappa's Spotify API turns public Spotify catalog data into structured JSON. Look up any artist for monthly listeners, follower counts, world rank, top cities and biography, then read their top tracks, discography releases and related artists. Get tracks with durations and preview links, album and playlist track lists in rank order, paginated on request, editorial charts, podcast shows with paginated episode history, and generated audio mixes — all without a Spotify developer account.
Try it now
Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.
curl -X GET "https://scrappa.co/api/spotify/artist?id=4tZwfgrHOc3mvqYlEYSvVi" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
{
"search_parameters": {
"engine": "spotify_artist",
"id": "4tZwfgrHOc3mvqYlEYSvVi"
},
"uri": "spotify:artist:4tZwfgrHOc3mvqYlEYSvVi",
"profile": {
"name": "Daft Punk",
"verified": true,
"biography": "French electronic music duo formed in 1993..."
},
"stats": {
"monthlyListeners": 16697461,
"followers": 10900000,
"worldRank": 12,
"topCities": [
{ "name": "Paris", "country": "FR" }
]
},
"discography": {
"topTracks": [],
"albums": [],
"singles": []
}
}
Structured data for real applications. Here are some ideas.
Track monthly listener counts, follower growth, world rank and top cities for any artist. Build artist analytics dashboards, label reporting and audience research tools.
Pull playlist and editorial chart track lists in rank order, a page at a time or drained with all=true. Monitor curated playlist changes, chart movement and catalogue updates over time.
Walk a show's episode history, newest first, one page at a time or drained with all=true. Build podcast monitoring, episode alerts and sponsor-placement research workflows.
Enrich your own music database with Spotify metadata, durations, release dates, labels, copyrights and preview links for tracks, albums and artists.
Everything you need in one API.
/api/spotify/search
Search tracks, albums, artists, playlists, podcasts and episodes
/api/spotify/search/suggestions
Complete partial queries with Spotify suggestions
/api/spotify/artist
Artist profile with monthly listeners, followers and top cities
/api/spotify/artist/top-tracks
An artist's most popular tracks at no extra cost
/api/spotify/artist/discography
Albums, singles and compilations, paginated
/api/spotify/artist/related
Artists Spotify considers similar
/api/spotify/track
Track metadata, duration, preview and audio features
/api/spotify/track/colors
Dominant colours extracted from cover art
/api/spotify/album
Album metadata, label, release date and tracks
/api/spotify/album/tracks
Album tracks in order, one page by default
/api/spotify/playlist
Playlist metadata, owner and track count
/api/spotify/playlist/tracks
Playlist tracks in rank order, one page by default
/api/spotify/charts/{key}
Ranked editorial chart by key (todays-top-hits, sextou, top-christian-hits, top-gospel-tracks), one page by default
/api/spotify/show
Show metadata, publisher and episode count
/api/spotify/show/episodes
Episodes newest first, one page by default
/api/spotify/episode
Episode metadata, duration and release date
/api/spotify/discovery/audio-mix-seed
A 50-track mix generated from one track
/api/spotify/get-many
Batch lookups, charged per entity
See how Scrappa compares to the official API.
| Feature | Scrappa | Spotify Web API |
|---|---|---|
| Monthly listeners | ||
| Developer account required | ||
| Full playlist rank order | partial | |
| Episode history walk (bounded at 1,000 items or a 20 s budget) | partial | |
| Editorial charts as ranked lists | ||
| Pay-as-you-go pricing | ||
| Free tier | 500 credits/month |
No. You only need a Scrappa API key. There is no Spotify app registration, no client-secret management and no approval queue.
Every Spotify id is the last segment of its URI. A track URI such as spotify:track:2Foc5Q5nqNiosCNqttzHof has the id 2Foc5Q5nqNiosCNqttzHof. You can paste either form — the full URI or the bare id — into the id parameter.
Each id in a get-many request is a separate lookup and is charged separately, so you always know what a batch costs. Items that cannot be resolved are not charged.
A failed request is never charged. If Spotify is unavailable or returns no data for an id, you get a clear error response and your credits are untouched.
No. Spotify delivers audio through protected streaming, so this API returns metadata and the short preview links Spotify publishes for each track.
Yes. Search, music metadata, charts and podcast data all come from the same key and the same billing, so you can build a combined music and podcast product on one plan.