Spotify API

Monthly listeners, play counts and chart positions from Spotify, logged out

endpoints
44
credits per call
0–3

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.

POST/spotify/v1/search
Real result, captured Nov 15, 20263 of 20
nametypeuriduration_ms
Get Lucky (feat. Pharrell Williams and Nile Rodgers)trackspotify:track:69kOkLUCk…369,626
Harder, Better, Faster, Strongertrackspotify:track:5W3cjX2J3…226,413
One More Timetrackspotify:track:0DiWol3AO…320,357
44 active endpoints, on 0, 1, 2 and 3 credit tiers.artist · artist_stats · artist_top_tracks · artist_discography · artist_related · artist_appears_on+38 more ↓OpenAPI 3.0 spec ↗

2 credits per call≈ $2/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

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

View docs ↗

Monthly listeners, followers, top cities and top tracks with play counts

2 credits1 required · 0 optional
POST/spotify/v1/artist
idle
// 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.

Try every endpoint in the playground

Endpoints

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.

  • artist

    2 cr

    Everything on one Spotify artist page.

    required
    artist_id
    optional
    —
  • artist_stats

    1 cr

    The numbers of one artist in one small call.

    required
    artist_id
    optional
    —
  • artist_top_tracks

    2 cr

    The artist's 10 most popular tracks (Spotify's order) with each track's all-time play count,…

    required
    artist_id
    optional
    —
  • artist_discography

    1 cr

    One page of an artist's releases.

    required
    artist_id
    optional
    type, sort, page, limit
  • artist_related

    1 cr

    Artists Spotify lists under "Fans also like" for this artist (Spotify's whole list in one cal…

    required
    artist_id
    optional
    —
  • artist_appears_on

    1 cr

    Releases by other artists this artist appears on.

    required
    artist_id
    optional
    —
  • artist_discovered_on

    1 cr

    Playlists where listeners discovered this artist (Spotify serves the first 50.

    required
    artist_id
    optional
    —
  • artist_featuring

    1 cr

    Spotify playlists featuring the artist (This Is …, Radio, editorial playlists).

    required
    artist_id
    optional
    —
  • artist_playlists

    1 cr

    Public playlists the artist curates on their own profile.

    required
    artist_id
    optional
    —
  • artist_concerts

    1 cr

    The artist's upcoming concerts on Spotify (date, venue, city, line-up).

    required
    artist_id
    optional
    —
  • artist_radio

    3 cr

    The artist's radio.

    required
    artist_id
    optional
    page, limit
  • track

    3 cr

    One track.

    required
    track_id
    optional
    —
  • track_playcount

    2 cr

    Just the all-time play count of one track, with its name, artists and duration.

    required
    track_id
    optional
    —
  • track_credits

    1 cr

    Songwriters, producers, performers and other contributors of a track with their roles, plus t…

    required
    track_id
    optional
    —
  • track_previews

    1 cr

    The public 30-second MP3 preview link of up to 50 tracks (null where Spotify publishes none).

    required
    track_ids
    optional
    —
  • track_related

    1 cr

    Tracks Spotify recommends next to this one on its track page (with play counts).

    required
    track_id
    optional
    limit
  • track_similar_albums

    1 cr

    Albums Spotify lists as similar to the album this track is on.

    required
    track_id
    optional
    limit
  • track_radio

    3 cr

    The track's radio.

    required
    track_id
    optional
    page, limit
  • album

    1 cr

    One album with every track and each track's all-time play count, label, release date, copyrig…

    required
    album_id
    optional
    —
  • album_tracks

    1 cr

    One page of an album's tracks with play counts.

    required
    album_id
    optional
    page, limit
  • playlist

    3 cr

    One playlist.

    required
    playlist_id
    optional
    limit
  • playlist_tracks

    2 cr

    One page of a playlist's rows (tracks and episodes) in playlist order, same row shape as play…

    required
    playlist_id
    optional
    page, limit
  • playlist_followers

    1 cr

    Just the follower count of a playlist (the cheap call for follower tracking).

    required
    playlist_id
    optional
    —
  • search

    2 cr

    Spotify search.

    required
    query
    optional
    type, page, limit
  • search_suggestions

    1 cr

    Autocomplete as typed into the Spotify search box.

    required
    query
    optional
    limit
  • charts

    2 cr

    Spotify's public global weekly chart (charts.spotify.com).

    required
    —
    optional
    chart
  • country_chart

    3 cr

    A country's chart playlist on Spotify.

    required
    country
    optional
    chart
  • home

    2 cr

    The home feed Spotify shows logged-out visitors (US).

    required
    —
    optional
    section_limit
  • browse_categories

    1 cr

    Every Browse-all category (genres, moods, charts, podcasts …) with its id for browse_category.

    required
    —
    optional
    —
  • browse_category

    3 cr

    One browse category page (e.g.

    required
    category_id
    optional
    section_limit
  • browse_section

    1 cr

    One browse shelf, paged.

    required
    section_id
    optional
    page, limit
  • country_hub

    1 cr

    A country's music hub on Spotify.

    required
    country
    optional
    —
  • podcast

    3 cr

    One podcast.

    required
    podcast_id
    optional
    —
  • podcast_episodes

    2 cr

    One page of a podcast's episodes, newest first.

    required
    podcast_id
    optional
    page, limit
  • episode

    1 cr

    One podcast episode.

    required
    episode_id
    optional
    —
  • audiobook

    3 cr

    One audiobook (US store).

    required
    audiobook_id
    optional
    —
  • audiobook_chapters

    1 cr

    One page of an audiobook's chapters in reading order.

    required
    audiobook_id
    optional
    page, limit
  • chapter

    1 cr

    One audiobook chapter.

    required
    chapter_id
    optional
    —
  • user

    1 cr

    A public Spotify user profile.

    required
    user_id
    optional
    —
  • user_playlists

    1 cr

    A user's public playlists with follower counts.

    required
    user_id
    optional
    —
  • concert_locations

    1 cr

    Cities matching a name, each with the geohash concerts_nearby takes.

    required
    query
    optional
    —
  • concerts_nearby

    3 cr

    Popular upcoming concerts Spotify lists near a city.

    required
    location
    optional
    —
  • concert

    1 cr

    One concert.

    required
    concert_id
    optional
    —
  • resolve

    0 cr

    Any Spotify link, URI or spotify.link short link → its type, id, canonical link and URI (no l…

    required
    link
    optional
    —

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 it works

How the Spotify API works

Spotify is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

Call02
POST /spotify/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
0 or 1 or 2 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

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.

01search?query=taylor%20swift&type=artists
GET/spotify/v1/search?query=taylor%20swift&type=artists

Artist rows with id, name, verified flag and images.

02artist?artist_id=<id>
GET/spotify/v1/artist?artist_id=<id>

Monthly listeners, followers, world rank, top 5 cities, top 10 tracks with play counts, related artists.

03artist_discography?artist_id=<id>&type=albums&limit=50
GET/spotify/v1/artist_discography?artist_id=<id>&type=albums&limit=50

Every album with release date, label and track count, page by page.

04album?album_id=<album
GET/spotify/v1/album?album_id=<album
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.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "spotify",
    "endpoint": "artist",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

FieldWhat it holds
monthly_listenersUnique 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).
followersAccounts following the artist (Taylor Swift: 166,627,427). artist and artist_stats returned the same value for 10 of 10 artists.
world_rankThe 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_citiesThe 5 cities with the most listeners, each with region, country code and listener count (Taylor Swift: London 1,338,294).
playcountAll-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_countSpotify 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.

Coverage

Spotify coverage, measured

Every number below was read from live Spotify on 2026-11-15, in about 1,000 calls across its 44 actions.

Artists

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.

Play counts

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.

Playlists

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.

United States

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.

Germany, United Kingdom, Brazil, Mexico

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.

Turkey, Japan, India

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.

France, South Korea

Country hub with its 4 chart playlists (country and global), 20 popular artists, 20 popular albums and 20 trending songs each.

Global

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.

Search

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.

Limits

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.

Use cases

What people build with Spotify

The jobs this data is most often used for.

01

Track monthly listeners, followers and world rank of a roster of artists every day.

02

Monitor all-time play counts of releases, track by track, for royalty and A&R reporting.

03

Follow country chart playlists with daily plays, positions and movement.

04

Read playlists with follower counts, BPM and key for playlist pitching and DJ tooling.

44

endpoints

0/1/2/3

credits per call

Pricing

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.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 1,000 free credits on signup, no card
  • One key, all 694 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

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
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"}'
python
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"])
FAQ

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.

Same key

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

Contact

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.

0/4000

No account needed · we reply from [email protected]

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