Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Spotify API page →
Media, Film & Knowledge

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.

44 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

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

Reference

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.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "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"
  }
}
Captured response
{
  "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
  }
}
Actions

What the Spotify API does

ActionDescriptionConcrete use caseKey params
artistEverything 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_statsThe 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_tracksThe 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_discographyOne 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_relatedArtists 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_onReleases 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_onPlaylists 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_featuringSpotify 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_playlistsPublic 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_concertsThe 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_radioThe 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
trackOne 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_playcountJust 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_creditsSongwriters, 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_previewsThe 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_relatedTracks 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_albumsAlbums 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_radioThe 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
albumOne 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_tracksOne 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
playlistOne 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_tracksOne 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_followersJust 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
searchSpotify 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_suggestionsAutocomplete 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
chartsSpotify'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_chartA 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
homeThe 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_categoriesEvery 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_categoryOne 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_sectionOne browse shelf, paged.Community analysts call browse_section to get one browse shelf, paged..section_id, page, limit
country_hubA 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
podcastOne 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_episodesOne 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
episodeOne 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
audiobookOne 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_chaptersOne 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
chapterOne audiobook chapter.Research tools call chapter to get one audiobook chapter..chapter_id
userA 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_playlistsA 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_locationsCities 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_nearbyPopular upcoming concerts Spotify lists near a city.Research tools call concerts_nearby to get popular upcoming concerts Spotify lists near a city..location
concertOne 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
resolveAny 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
Code samples

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"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.spotify.search with {"query":"daft punk","type":"tracks"}.
Use cases

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

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.

docs / spotify

Spotify

Artist monthly listeners, followers and top cities, track and album play counts, playlists with BPM and key, search, charts, podcasts and concerts.

base /spotify/v144 endpoints
post/spotify/v1/artist2 credits

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.

ParameterAllowed / rangeDescription
artist_idrequired—Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/artist_stats1 credit

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.

ParameterAllowed / rangeDescription
artist_idrequired—Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/artist_top_tracks2 credits

The artist's 10 most popular tracks (Spotify's order) with each track's all-time play count, duration, album and artists.

ParameterAllowed / rangeDescription
artist_idrequired—Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/artist_discography1 credit

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.

ParameterAllowed / rangeDescription
artist_idrequired—Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
type = alloptionalall · albums · singles · compilationsWhich releases (singular works too: album, single, compilation).
sort = newestoptionalnewest · oldestOrder.
page = 1optional1–10001-based page number.
limit = 20optional1–100Rows per page (1-100).
Try in playground →
post/spotify/v1/artist_appears_on1 credit

Releases by other artists this artist appears on. Spotify serves the first 50 to a logged-out viewer; `total` is its full count.

ParameterAllowed / rangeDescription
artist_idrequired—Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/artist_discovered_on1 credit

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.

ParameterAllowed / rangeDescription
artist_idrequired—Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/artist_featuring1 credit

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

ParameterAllowed / rangeDescription
artist_idrequired—Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/artist_playlists1 credit

Public playlists the artist curates on their own profile.

ParameterAllowed / rangeDescription
artist_idrequired—Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/artist_concerts1 credit

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

ParameterAllowed / rangeDescription
artist_idrequired—Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/artist_radio3 credits

The artist's radio: the "<artist> Radio" playlist Spotify generates, with its tracks (play counts included).

ParameterAllowed / rangeDescription
artist_idrequired—Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
page = 1optional1–10001-based page number.
limit = 50optional1–100Rows per page (1-100).
Try in playground →
post/spotify/v1/track3 credits

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

ParameterAllowed / rangeDescription
track_idrequired—Spotify track: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/track_playcount2 credits

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

ParameterAllowed / rangeDescription
track_idrequired—Spotify track: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/track_credits1 credit

Songwriters, producers, performers and other contributors of a track with their roles, plus the label / distributor credited as source.

ParameterAllowed / rangeDescription
track_idrequired—Spotify track: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/track_previews1 credit

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

ParameterAllowed / rangeDescription
track_idsrequired—Up to 50 Spotify track ids, URIs or links (array, or one comma-separated string).
Try in playground →
post/spotify/v1/track_similar_albums1 credit

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

ParameterAllowed / rangeDescription
track_idrequired—Spotify track: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
limit = 20optional1–100How many albums (1-100); Spotify keeps 60-70 per track.
Try in playground →
post/spotify/v1/track_radio3 credits

The track's radio: the "<track> Radio" playlist Spotify generates, with its tracks.

ParameterAllowed / rangeDescription
track_idrequired—Spotify track: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
page = 1optional1–10001-based page number.
limit = 50optional1–100Rows per page (1-100).
Try in playground →
post/spotify/v1/album1 credit

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.

ParameterAllowed / rangeDescription
album_idrequired—Spotify album: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/album_tracks1 credit

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

ParameterAllowed / rangeDescription
album_idrequired—Spotify album: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
page = 1optional1–10001-based page number.
limit = 50optional1–300Rows per page (1-300).
Try in playground →
post/spotify/v1/playlist3 credits

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.

ParameterAllowed / rangeDescription
playlist_idrequired—Spotify playlist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
limit = 100optional1–100How many rows (1-100).
Try in playground →
post/spotify/v1/playlist_tracks2 credits

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

ParameterAllowed / rangeDescription
playlist_idrequired—Spotify playlist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
page = 1optional1–10001-based page number.
limit = 100optional1–100Rows per page (1-100).
Try in playground →
post/spotify/v1/playlist_followers1 credit

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

ParameterAllowed / rangeDescription
playlist_idrequired—Spotify playlist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/search_suggestions1 credit

Autocomplete as typed into the Spotify search box: query completions plus the artists / tracks / albums / playlists it suggests.

ParameterAllowed / rangeDescription
queryrequired—What the user typed so far.
limit = 10optional1–20Maximum suggestions (1-20).
Try in playground →
post/spotify/v1/charts2 credits

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.

ParameterAllowed / rangeDescription
chart = tracksoptionaltracks · albums · artistsWhich global weekly chart (track / album / artist work too).
Try in playground →
post/spotify/v1/country_chart3 credits

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.

ParameterAllowed / rangeDescription
countryrequired—Two-letter country code (e.g. DE, US, BR, TR) or `global`.
chart = top_songsoptionaltop_songs · top_50Which chart playlist (also: weekly, daily, top50).
Try in playground →
post/spotify/v1/home2 credits

The home feed Spotify shows logged-out visitors (US): trending songs, popular artists, albums, radio and featured charts, shelf by shelf.

ParameterAllowed / rangeDescription
section_limit = 10optional1–50Items per shelf (1-50).
Try in playground →
post/spotify/v1/browse_categories1 credit

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

Try in playground →
post/spotify/v1/browse_category3 credits

One browse category page (e.g. Pop): its shelves with their first playlists / albums; a shelf's `id` pages further with `browse_section`.

ParameterAllowed / rangeDescription
category_idrequired—Category id from `browse_categories` (or the open.spotify.com/genre/<id> link).
section_limit = 20optional1–50Items per shelf (1-50).
Try in playground →
post/spotify/v1/browse_section1 credit

One browse shelf, paged.

ParameterAllowed / rangeDescription
section_idrequired—Shelf id from `browse_category` sections[].id.
page = 1optional1–10001-based page number.
limit = 50optional1–100Rows per page (1-100).
Try in playground →
post/spotify/v1/country_hub1 credit

A country's music hub on Spotify: its chart playlists, popular artists, popular albums and trending songs.

ParameterAllowed / rangeDescription
countryrequired—Two-letter country code.
Try in playground →
post/spotify/v1/podcast3 credits

One podcast: publisher, description, rating and rating count, topics, explicit flag, episode order, trailer, total episodes and the latest 10 episodes.

ParameterAllowed / rangeDescription
podcast_idrequired—Spotify podcast (show): the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/podcast_episodes2 credits

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

ParameterAllowed / rangeDescription
podcast_idrequired—Spotify podcast (show): the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
page = 1optional1–10001-based page number.
limit = 50optional1–100Rows per page (1-100).
Try in playground →
post/spotify/v1/episode1 credit

One podcast episode: description, release time, duration, explicit / paywall flags, media types, transcript flag, 30-second preview and its podcast.

ParameterAllowed / rangeDescription
episode_idrequired—Spotify podcast episode: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/audiobook3 credits

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.

ParameterAllowed / rangeDescription
audiobook_idrequired—Spotify audiobook: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/audiobook_chapters1 credit

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

ParameterAllowed / rangeDescription
audiobook_idrequired—Spotify audiobook: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
page = 1optional1–10001-based page number.
limit = 50optional1–100Rows per page (1-100).
Try in playground →
post/spotify/v1/chapter1 credit

One audiobook chapter.

ParameterAllowed / rangeDescription
chapter_idrequired—Spotify audiobook chapter: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/user1 credit

A public Spotify user profile: display name, avatar, verified flag, public playlist count and the first 10 public playlists with follower counts.

ParameterAllowed / rangeDescription
user_idrequired—Spotify username (e.g. `spotify`), the spotify:user: URI or the open.spotify.com/user/<name> link.
Try in playground →
post/spotify/v1/user_playlists1 credit

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.

ParameterAllowed / rangeDescription
user_idrequired—Spotify username (e.g. `spotify`), the spotify:user: URI or the open.spotify.com/user/<name> link.
Try in playground →
post/spotify/v1/concert_locations1 credit

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

ParameterAllowed / rangeDescription
queryrequired—City name.
Try in playground →
post/spotify/v1/concerts_nearby3 credits

Popular upcoming concerts Spotify lists near a city.

ParameterAllowed / rangeDescription
locationrequired—City name (first match is used) or a geohash from `concert_locations`.
Try in playground →
post/spotify/v1/concert1 credit

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.

ParameterAllowed / rangeDescription
concert_idrequired—Spotify concert: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
Try in playground →
post/spotify/v1/resolvefree

Any Spotify link, URI or spotify.link short link → its type, id, canonical link and URI (no lookup of the item itself).

ParameterAllowed / rangeDescription
linkrequired—open.spotify.com link, spotify: URI or spotify.link short link.
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.