Monthly listeners, play counts and chart positions from Spotify, logged out
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.
- endpoints
- 44
- credits per call
- 0–3
2 credits per call≈ $2/1,000 calls1,000 free credits, no card
- Get Lucky (feat. Pharrell Williams and Nile Rodgers)
- type
- track
- uri
- spotify:track:69kOkLUCk…
- duration_ms
- 369,626
- Harder, Better, Faster, Stronger
- type
- track
- uri
- spotify:track:5W3cjX2J3…
- duration_ms
- 226,413
- One More Time
- type
- track
- uri
- spotify:track:0DiWol3AO…
- duration_ms
- 320,357
44 active endpoints, on 0, 1, 2 and 3 credit tiers.
- POST/spotify/v1/artist2 credits
- POST/spotify/v1/artist_stats1 credit
- POST/spotify/v1/artist_top_tracks2 credits
- POST/spotify/v1/artist_discography1 credit
- POST/spotify/v1/artist_related1 credit
- POST/spotify/v1/artist_appears_on1 credit
- POST/spotify/v1/artist_discovered_on1 credit
- POST/spotify/v1/artist_featuring1 credit
Run the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
Spotify API
5 of 44 endpoints, ready to run
Monthly listeners, followers, top cities and top tracks with play counts
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What Spotify endpoints does ReefAPI ship?
44 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Every parameter, every allowed value →
Missing a Spotify endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the Spotify API works
Spotify is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 674 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From an artist name to every release's play count
Find the artist, read the artist page, then page through the discography and read each album's play counts.
Artist rows with id, name, verified flag and images.
Monthly listeners, followers, world rank, top 5 cities, top 10 tracks with play counts, related artists.
Every album with release date, label and track count, page by page.
id>
Every track of the album with its all-time play count.
A dated table of an artist's audience (listeners, followers, cities) and the play count of every track they released.
curl -X POST https://api.reefapi.com/spotify/v1/artist \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"artist_id":"06HL4z0CvFAxyc27GXpf02"}'{
"ok": true,
"data": { … },
"meta": {
"api": "spotify",
"endpoint": "artist",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}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.
Spotify coverage, measured
Every number below was read from live Spotify on 2026-11-15, in about 1,000 calls across its 44 actions.
Monthly listeners, followers, top 5 cities and top 10 tracks with play counts on 16 of 16 artists across pop, latin, classical, Turkish pop, K-pop and metal; world rank on 11 of 16 (the other 5 have none on Spotify). Monthly listeners matched the artist page on 10 of 10.
On 16 of 16 tracks and 150 of 150 album tracks checked. Identical on a track's own page and its album page for 10 of 10 tracks.
Play count, BPM, key and Camelot key on 260 of 260 rows checked; a 150-row playlist paged 3 × 50 with 150 distinct rows; followers equal to Spotify's own follower counter on 10 of 10.
Top Songs - USA (weekly, 50 rows) and Top 50 - USA (daily, 50 rows) with position, previous position, movement and plays; the country hub adds 20 popular artists, 20 popular albums and 20 trending songs; the home feed and browse pages are the US logged-out view.
Top Songs - <country> (weekly, 50 rows) and Top 50 - <country> (daily, 50 rows) with position, previous position, movement and plays, measured for each; each of the four country hubs returned 20 popular artists, 20 popular albums and 20 trending songs.
Top Songs - Turkey / Japan / India (weekly, 50 rows) and Top 50 (daily, 50 rows) with plays and movement, plus 20 popular artists, 20 popular albums and 20 trending songs per country hub.
Country hub with its 4 chart playlists (country and global), 20 popular artists, 20 popular albums and 20 trending songs each.
Weekly Top Songs, Top Albums and Top Artists Global, 50 rows each with rank, previous rank, peak rank and date, weeks on chart; songs carry labels, producers and songwriters. Top Songs - Global and Top 50 - Global playlists with daily plays.
Up to 100 rows per page, the first 1,000 results of a query. "daft punk": 431 tracks, 116 artists, 197 albums, 198 playlists. Track pages can repeat rows because Spotify re-ranks between requests ("love": 23 repeats in 4 pages of 25); artist and playlist pages had none.
A user's public playlists stop at the first 10 (Spotify serves no more logged out); appears-on and discovered-on stop at the first 50; no lyrics; play counts come one track per call with track_playcount, or for every track of an album or playlist at once; search rows carry no play counts (track and album do); concert ticket prices are returned only where Spotify sends them.
What people build with Spotify
The jobs this data is most often used for.
endpoints
credits per call
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.
What Spotify data costs
The cheapest call here is 0 credits, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 674 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/spotify/v1/artist \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"artist_id":"06HL4z0CvFAxyc27GXpf02"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/spotify/v1/artist",
headers={"x-api-key": REEF_KEY},
json={
"artist_id": "06HL4z0CvFAxyc27GXpf02"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Spotify.
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.
39 Media, Film & Knowledge APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Spotify, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 673 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-15.