Spotify API & Scraper
The Spotify API returns Spotify's public catalogue as JSON without a Spotify account: artist monthly listeners, followers, world rank and top cities, all-time play counts of tracks and albums, playlists with BPM and key, search, charts, podcasts and concerts.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
It reads Spotify logged out, the way a visitor of open.spotify.com sees it. `artist` returns one artist page in one call: monthly listeners, followers, world rank, the top 5 listener cities with their listener counts, the verified badge, biography, social links, the 10 most popular tracks with their all-time play counts, the discography, related artists and upcoming concerts. `track` returns a track's all-time play count, its album, the 30-second preview link and the full credits (writers, producers, performers with roles, and the label credited as source); `track_playcount` is the small call that returns just one track's play count, one track per call. `album` returns every track of an album with its own play count. `playlist` returns the owner, follower count and every row with the track's play count, BPM, musical key and Camelot key; on Spotify's chart playlists each row also carries its chart position, previous position, movement and plays. `search` covers tracks, artists, albums, playlists, podcasts, episodes, audiobooks, genres and users. `charts` is Spotify's weekly global Top Songs, Top Albums and Top Artists (50 rows each), `country_chart` a country's Top Songs (weekly) or Top 50 (daily) playlist. Podcasts, episodes, audiobooks with price, public user profiles, concerts with ticket links and a link resolver complete it.
What a Spotify field actually contains
Fields that read differently from how they look. Every row was measured against live Spotify on 2026-11-15.
| Field | What it holds |
|---|---|
| monthly_listeners | Unique listeners over the last 28 days, the number on the artist page. Taylor Swift: 96,662,539. It matched the figure open.spotify.com prints on the artist page for 10 of 10 artists checked (Spotify prints it rounded: 96.7M). |
| followers | Accounts following the artist (Taylor Swift: 166,627,427). artist and artist_stats returned the same value for 10 of 10 artists. |
| world_rank | The artist's position among all artists by monthly listeners (Taylor Swift: 6). Null when Spotify shows no rank: 5 of 16 artists checked had none. |
| top_cities | The 5 cities with the most listeners, each with region, country code and listener count (Taylor Swift: London 1,338,294). |
| playcount | All-time plays of a track, as an integer (Never Gonna Give You Up: 1,204,202,349). The same track had the same play count on its own page and on its album page for 10 of 10 tracks, and in the artist's top 10 for 7 of 7. |
| chart.plays (playlist rows) | On Spotify chart playlists (format chart, rank_type plays) the plays that row counted for the chart period: Top 50 - Global row 1 had 5,006,094 on 2026-11-15. Ordinary playlists have chart: null. |
| audio (playlist rows) | BPM, musical key, major or minor and the Camelot key Spotify shows for the row (BbY WOW: 60.0 BPM, B minor, 10A). Present on 260 of 260 playlist rows checked; search rows do not carry it. |
| followers (playlist) | The playlist's follower count. The playlist page and Spotify's own follower counter agreed on 10 of 10 playlists (Today's Top Hits: 33,583,562). |
| price, list_price (audiobook) | Both prices exactly as Spotify sends them, in US dollars. They can be in either order: Harry Potter and the Sorcerer's Stone had price 32.90 and list_price 29.99. |
| discovered_on_hidden, hidden_count | Spotify hides some "discovered on" playlists from logged-out visitors. They are counted, not returned: 9 of the first 50 for Taylor Swift. |
Data is what Spotify shows a logged-out visitor in the United States. Play counts, monthly listeners and followers are worldwide figures; only the home feed and browse pages follow the US market.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/spotify/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "daft punk",
"type": "tracks"
}
}{
"ok": true,
"meta": {
"api": "spotify",
"endpoint": "search",
"mode": "live",
"latency_ms": 906.7,
"record_count": 20,
"bytes": 52407,
"cache_hit": false,
"upstream_requests": 1,
"charged_credits": 2,
"version": "0.1.2",
"request_id": "845cfc5db00b414c",
"queue_ms": 1.2,
"fetched_at": "2026-11-15T18:52:18.608Z"
},
"data": {
"query": "daft punk",
"type": "tracks",
"results": [
{
"type": "track",
"id": "69kOkLUCkxIZYexIgSG8rq",
"name": "Get Lucky (feat. Pharrell Williams and Nile Rodgers)",
"url": "https://open.spotify.com/track/69kOkLUCkxIZYexIgSG8rq",
"uri": "spotify:track:69kOkLUCkxIZYexIgSG8rq",
"track_number": null,
"disc_number": null,
"duration_ms": 369626,
"explicit": false,
"playable": true,
"has_video": false,
"playcount": null,
"media_type": null,
"artists": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"url": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"url": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"url": "[trimmed-depth]"
}
],
"album": {
"id": "4m2880jivSbbyEGAKfITCa",
"name": "Random Access Memories",
"url": "https://open.spotify.com/album/4m2880jivSbbyEGAKfITCa",
"release_date": null,
"images": [
"[trimmed-depth]",
"[trimmed-depth]",
"[trimmed-depth]"
]
}
},
{
"type": "track",
"id": "5W3cjX2J3tjhG8zb6u0qHn",
"name": "Harder, Better, Faster, Stronger",
"url": "https://open.spotify.com/track/5W3cjX2J3tjhG8zb6u0qHn",
"uri": "spotify:track:5W3cjX2J3tjhG8zb6u0qHn",
"track_number": null,
"disc_number": null,
"duration_ms": 226413,
"explicit": false,
"playable": true,
"has_video": true,
"playcount": null,
"media_type": null,
"artists": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"url": "[trimmed-depth]"
}
],
"album": {
"id": "2noRn2Aes5aoNVsU6iWThc",
"name": "Discovery",
"url": "https://open.spotify.com/album/2noRn2Aes5aoNVsU6iWThc",
"release_date": null,
"images": [
"[trimmed-depth]",
"[trimmed-depth]",
"[trimmed-depth]"
]
}
},
{
"type": "track",
"id": "0DiWol3AO6WpXZgp0goxAV",
"name": "One More Time",
"url": "https://open.spotify.com/track/0DiWol3AO6WpXZgp0goxAV",
"uri": "spotify:track:0DiWol3AO6WpXZgp0goxAV",
"track_number": null,
"disc_number": null,
"duration_ms": 320357,
"explicit": false,
"playable": true,
"has_video": false,
"playcount": null,
"media_type": null,
"artists": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"url": "[trimmed-depth]"
}
],
"album": {
"id": "2noRn2Aes5aoNVsU6iWThc",
"name": "Discovery",
"url": "https://open.spotify.com/album/2noRn2Aes5aoNVsU6iWThc",
"release_date": null,
"images": [
"[trimmed-depth]",
"[trimmed-depth]",
"[trimmed-depth]"
]
}
}
],
"count": 20,
"total": 429,
"total_reported": 429,
"page": 1,
"limit": 20,
"has_more": true
}
}What the Spotify API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| artist | Everything on one Spotify artist page: monthly listeners, followers, world rank, the top 5 listener cities, verified badge, biography, social links, avatar / header / gallery images, the 10 most popular tracks with their all-time play counts, latest and popular releases, the first albums / singles / compilations with totals, related artists, appears-on releases, playlists featuring the artist, the artist's own playlists, upcoming concerts and merch. | Content platforms call artist to get everything on one Spotify artist page. | artist_id |
| artist_stats | The numbers of one artist in one small call: followers, monthly listeners, world rank, top 5 listener cities with listener counts, verified / registered flags, biography, social links and gallery. | Research tools call artist_stats to get the numbers of one artist in one small call. | artist_id |
| artist_top_tracks | The artist's 10 most popular tracks (Spotify's order) with each track's all-time play count, duration, album and artists. | Community analysts call artist_top_tracks to get the artist's 10 most popular tracks (Spotify's order) with each track's all-time play count,…. | artist_id |
| artist_discography | One page of an artist's releases: everything, or only albums / singles / compilations, newest or oldest first, with release date, label, track count, cover and copyright lines. | Media monitors call artist_discography to get one page of an artist's releases. | artist_id, type, sort, page, limit |
| artist_related | Artists Spotify lists under "Fans also like" for this artist (Spotify's whole list in one call, 40 measured 2026-11-15; `total` says how many Spotify keeps). | Content platforms call artist_related to get artists Spotify lists under "Fans also like" for this artist (Spotify's whole list in one cal…. | artist_id |
| artist_appears_on | Releases by other artists this artist appears on. Spotify serves the first 50 to a logged-out viewer; `total` is its full count. | Research tools call artist_appears_on to get releases by other artists this artist appears on. | artist_id |
| artist_discovered_on | Playlists where listeners discovered this artist (Spotify serves the first 50; `total` is its full count). Spotify hides some entries from logged-out viewers; those are counted in `hidden_count`, not returned. | Community analysts call artist_discovered_on to get playlists where listeners discovered this artist (Spotify serves the first 50; `total` is its…. | artist_id |
| artist_featuring | Spotify playlists featuring the artist (This Is …, Radio, editorial playlists). | Media monitors call artist_featuring to get spotify playlists featuring the artist (This Is …, Radio, editorial playlists).. | artist_id |
| artist_playlists | Public playlists the artist curates on their own profile. | Content platforms call artist_playlists to get public playlists the artist curates on their own profile.. | artist_id |
| artist_concerts | The artist's upcoming concerts on Spotify (date, venue, city, line-up). | Research tools call artist_concerts to get the artist's upcoming concerts on Spotify (date, venue, city, line-up).. | artist_id |
| artist_radio | The artist's radio: the "<artist> Radio" playlist Spotify generates, with its tracks (play counts included). | Community analysts call artist_radio to get the artist's radio. | artist_id, page, limit |
| track | One track: all-time play count, duration, explicit / playable flags, artists, album (type, release date, label, copyrights, cover), the 30-second preview link and the full credits (writers, producers, performers with roles, and the label / distributor credited as source). | Media monitors call track to get one track. | track_id |
| track_playcount | Just the all-time play count of one track, with its name, artists and duration — the small call for play-count tracking (one track per call; `album` returns the play count of every track on an album in one call). | Content platforms call track_playcount to get just the all-time play count of one track, with its name, artists and duration. | track_id |
| track_credits | Songwriters, producers, performers and other contributors of a track with their roles, plus the label / distributor credited as source. | Research tools call track_credits to get songwriters, producers, performers and other contributors of a track with their roles, plus t…. | track_id |
| track_previews | The public 30-second MP3 preview link of up to 50 tracks (null where Spotify publishes none). | Community analysts call track_previews to get the public 30-second MP3 preview link of up to 50 tracks (null where Spotify publishes none).. | track_ids |
| track_related | Tracks Spotify recommends next to this one on its track page (with play counts). | Media monitors call track_related to get tracks Spotify recommends next to this one on its track page (with play counts).. | track_id, limit |
| track_similar_albums | Albums Spotify lists as similar to the album this track is on. | Content platforms call track_similar_albums to get albums Spotify lists as similar to the album this track is on.. | track_id, limit |
| track_radio | The track's radio: the "<track> Radio" playlist Spotify generates, with its tracks. | Research tools call track_radio to get the track's radio. | track_id, page, limit |
| album | One album with every track and each track's all-time play count, label, release date, copyrights, disc count, other editions and more albums by the artist. | Community analysts call album to get one album with every track and each track's all-time play count, label, release date, copyrig…. | album_id |
| album_tracks | One page of an album's tracks with play counts. | Media monitors call album_tracks to get one page of an album's tracks with play counts.. | album_id, page, limit |
| playlist | One playlist: name, description, owner, followers, collaborators, last update, chart info for chart playlists, and its first rows — each with position, date added, the track's play count, BPM and musical key, and for chart playlists the chart position, previous position, movement and plays. | Content platforms call playlist to get one playlist. | playlist_id, limit |
| playlist_tracks | One page of a playlist's rows (tracks and episodes) in playlist order, same row shape as `playlist`. | Research tools call playlist_tracks to get one page of a playlist's rows (tracks and episodes) in playlist order, same row shape as `pla…. | playlist_id, page, limit |
| playlist_followers | Just the follower count of a playlist (the cheap call for follower tracking). | Community analysts call playlist_followers to get just the follower count of a playlist (the cheap call for follower tracking).. | playlist_id |
| search | Spotify search. `type: all` returns the top results plus the first rows and the total of every section (tracks, artists, albums, playlists, podcasts, episodes, audiobooks, genres, users); any other type returns one paged list (up to 100 rows per page). Spotify serves the first 1000 results of a query (page × limit ≤ 1000). Rows inside one page are always distinct, but Spotify re-ranks track results between requests, so consecutive track pages can repeat rows (measured: "love", 4 pages of 25, 23 repeats; artists and playlists 0) — ask for up to 100 rows in one page to avoid it. | Media monitors call search to get spotify search. | query, type, page, limit |
| search_suggestions | Autocomplete as typed into the Spotify search box: query completions plus the artists / tracks / albums / playlists it suggests. | Content platforms call search_suggestions to get autocomplete as typed into the Spotify search box. | query, limit |
| charts | Spotify's public global weekly chart (charts.spotify.com): Top Songs, Top Albums or Top Artists, 50 rows with rank, previous rank, peak rank and date, weeks on chart and entry status; songs carry labels, producers and songwriters. | Research tools call charts to get spotify's public global weekly chart (charts.spotify.com). | chart |
| country_chart | A country's chart playlist on Spotify: `top_songs` ("Top Songs - <country>", weekly) or `top_50` ("Top 50 - <country>", daily), each row with chart position, previous position, movement, plays and the track's all-time play count. `country: global` for the global playlists. | Community analysts call country_chart to get a country's chart playlist on Spotify. | country, chart |
| home | The home feed Spotify shows logged-out visitors (US): trending songs, popular artists, albums, radio and featured charts, shelf by shelf. | Media monitors call home to get the home feed Spotify shows logged-out visitors (US). | section_limit |
| browse_categories | Every Browse-all category (genres, moods, charts, podcasts …) with its id for `browse_category`. | Content platforms call browse_categories to get every Browse-all category (genres, moods, charts, podcasts …) with its id for `browse_category`.. | none |
| browse_category | One browse category page (e.g. Pop): its shelves with their first playlists / albums; a shelf's `id` pages further with `browse_section`. | Research tools call browse_category to get one browse category page (e.g. | category_id, section_limit |
| browse_section | One browse shelf, paged. | Community analysts call browse_section to get one browse shelf, paged.. | section_id, page, limit |
| country_hub | A country's music hub on Spotify: its chart playlists, popular artists, popular albums and trending songs. | Media monitors call country_hub to get a country's music hub on Spotify. | country |
| podcast | One podcast: publisher, description, rating and rating count, topics, explicit flag, episode order, trailer, total episodes and the latest 10 episodes. | Content platforms call podcast to get one podcast. | podcast_id |
| podcast_episodes | One page of a podcast's episodes, newest first. | Research tools call podcast_episodes to get one page of a podcast's episodes, newest first.. | podcast_id, page, limit |
| episode | One podcast episode: description, release time, duration, explicit / paywall flags, media types, transcript flag, 30-second preview and its podcast. | Community analysts call episode to get one podcast episode. | episode_id |
| audiobook | One audiobook (US store): authors, narrators, publisher, publish date, duration, rating, price and list price, genres, copyrights, trailer, total chapters and the first 10 chapters. | Media monitors call audiobook to get one audiobook (US store). | audiobook_id |
| audiobook_chapters | One page of an audiobook's chapters in reading order. | Content platforms call audiobook_chapters to get one page of an audiobook's chapters in reading order.. | audiobook_id, page, limit |
| chapter | One audiobook chapter. | Research tools call chapter to get one audiobook chapter.. | chapter_id |
| user | A public Spotify user profile: display name, avatar, verified flag, public playlist count and the first 10 public playlists with follower counts. | Community analysts call user to get a public Spotify user profile. | user_id |
| user_playlists | A user's public playlists with follower counts. Spotify serves a logged-out viewer the first 10 (offset and larger limits are ignored, measured); `total` is the user's full public playlist count. | Media monitors call user_playlists to get a user's public playlists with follower counts. | user_id |
| concert_locations | Cities matching a name, each with the geohash `concerts_nearby` takes. | Content platforms call concert_locations to get cities matching a name, each with the geohash `concerts_nearby` takes.. | query |
| concerts_nearby | Popular upcoming concerts Spotify lists near a city. | Research tools call concerts_nearby to get popular upcoming concerts Spotify lists near a city.. | location |
| concert | One concert: date and doors time, venue with coordinates, line-up, genres, ticket sellers with links, sale window and price range, festival flag, age restriction and related concerts. | Community analysts call concert to get one concert. | concert_id |
| resolve | Any Spotify link, URI or spotify.link short link → its type, id, canonical link and URI (no lookup of the item itself). | Media monitors call resolve to get any Spotify link, URI or spotify.link short link → its type, id, canonical link and URI (no l…. | link |
Call search from your stack
curl -X POST https://api.reefapi.com/spotify/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"daft punk","type":"tracks"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/spotify/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "daft punk",
"type": "tracks"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/spotify/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "daft punk",
"type": "tracks"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.spotify.search with {"query":"daft punk","type":"tracks"}.Who uses this API and why
- Track monthly listeners, followers and world rank of a roster of artists every day.
- Monitor all-time play counts of releases, track by track, for royalty and A&R reporting.
- Follow country chart playlists with daily plays, positions and movement.
- Read playlists with follower counts, BPM and key for playlist pitching and DJ tooling.
- Find where an artist's listeners are by city and which playlists drove discovery.
Questions developers ask before integrating
Is there a Spotify API for monthly listeners and play counts?
Yes. The spotify API on ReefAPI returns an artist's monthly listeners, followers, world rank and top 5 listener cities, and the all-time play count of every track, as JSON, without a Spotify account or a Spotify developer key.
Do I need a Spotify account or API key from Spotify?
No. Everything is read logged out; you only need a ReefAPI key.
Can I get play counts for many tracks at once?
album returns the play count of every track on an album in one call (a 157-track box set came back complete, 157 tracks), and playlist does the same for up to 100 playlist rows. For single tracks, track_playcount returns one track's play count per call.
Are country charts included?
Yes, as Spotify publishes them on its country hubs: Top Songs - <country> (weekly, 50 rows) and Top 50 - <country> (daily, 50 rows), each row with position, previous position, movement and plays. charts returns the weekly global Top Songs, Top Albums and Top Artists, 50 rows each, with peak rank and weeks on chart.
How deep does search go?
Spotify serves the first 1,000 results of a query, up to 100 per page. Track search is re-ranked by Spotify between requests, so consecutive pages can repeat tracks ("love": 23 repeats over 4 pages of 25); a single page of up to 100 never repeats. Artist and playlist searches had no repeats (100 of 100 distinct). type takes the plural or the singular form (tracks or track, artists or artist).
Does it return a user's playlists?
user and user_playlists return the profile, the number of public playlists and the first 10 of them with follower counts. Spotify does not serve more than 10 to a logged-out visitor (the account spotify has 1,519; 10 are returned).
Which artist lists are complete?
Related artists come complete (40 for Taylor Swift). appears-on and discovered-on return the first 50 Spotify shows, with total set to Spotify's full count (appears-on 155, discovered-on 100). The discography pages through every release: 115 for Taylor Swift, filterable to albums (34), singles (80) or compilations (1), newest or oldest first.
Do I get lyrics or audio features?
No. Spotify shows lyrics only to logged-in users and no longer shows audio features on its public pages. Playlist rows do carry BPM and key.
Are podcasts and audiobooks covered?
Yes: podcast details with rating (The Joe Rogan Experience: 4.65 from 956,670 ratings), every episode page by page (2,782 episodes), single episodes with preview links, audiobooks with authors, narrators, price and chapters.
What is the Spotify API?
Spotify API is a ReefAPI endpoint group for artist monthly listeners, followers and top cities, track and album play counts, playlists with bpm and key, search, charts, podcasts and concerts. It returns live JSON through POST requests under /spotify/v1.
Is the Spotify API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Spotify calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Spotify login or account?
No login to Spotify is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Spotify data?
The page example is captured from a live artist call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Spotify API use?
Spotify actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.