Reference
109 Spotify API endpoints
123 operations across 25 groups. Every group has a page of its own, and so does every operation. Open a group and press Run on any row: the response opens right here, with the parameters it used and the code to reproduce it.
Base URL https://spotify-proxy.checkleaked.cc
Groups
- AI24 endpointsAI analysis in GET and POST form: artist summary, album review, track deep dive, chart trends, playlist curator, market comparison, genre landscape, mood profile, viral potential and a custom prompt, plus the module's health and the list of supported analysis types.
- Artists10 endpointsArtist data by Spotify id: overview, discography overview, albums, singles, appears-on, discovered-on, featuring, related artists and top tracks, plus several artists at once by ids.
- Tracking9 endpointsTrack and untrack Spotify items, list what is tracked, read one tracked item, the change log, tracking stats and the tracking module's health.
- Health8 endpointsPing, cluster and instance health, a strict cluster check and proxy health, plus POST endpoints that clear proxy stats and error counters.
- Charts6 endpointsTop 200 tracks, top artists, top albums and viral tracks by period and country, plus the top 20 artists by followers and by monthly listeners.
- Partner6 endpointsSpotify's Pathfinder partner layer: playlist, track, track play count, album, artist overview and artist discography, with locale and pagination parameters.
- Webhooks6 endpointsRegister, list, test and delete webhooks, and read their stats and per-webhook delivery logs.
- Batch5 endpointsSeveral ids in one call: album metadata, artist overview, track credits, track lyrics and track popularity.
- Browse5 endpointsSpotify Browse by country and locale: categories and a category by id, featured playlists, new releases and recommendations.
- Concerts5 endpointsConcert locations by query, a concert feed by geoHash or geonameId and date range, concert details by id, an artist's upcoming concerts and concerts by artist name.
- Search5 endpointsSearch Spotify by text: full search, top results only, search with lyrics, suggestions, and one search across several markets.
- Tracks4 endpointsTrack data by Spotify id: several tracks at once, credits, lyrics with an optional vocal-removal flag, and recommendations from seed tracks, artists and genres.
- Albums3 endpointsAlbum data by Spotify id: several albums at once, an album's tracks with offset and limit, and album metadata.
- Analysis3 endpointsCompare artists by ids, audio features for a track, and an analysis of a playlist.
- Audiobooks3 endpointsAudiobooks by Spotify id and market: several at once, one by id, and an audiobook's chapters with offset and limit.
- Playlists3 endpointsPlaylist data by Spotify id: the playlist, its tracks with offset and limit, and a playlist seeded from a Spotify URI.
- Shows3 endpointsPodcast shows by Spotify id and market: several at once, one by id, and a show's episodes with offset and limit.
- Cache2 endpointsThe proxy's cache stats, and a POST that invalidates the cache.
- Credentials2 endpointsStatus of the API's upstream credentials and of the cookies it keeps in Redis.
- Downloads2 endpointsA track resolved from a text query and returned as a download, from Spotify or from SoundCloud.
- Episodes2 endpointsPodcast episodes by Spotify id and market: several at once, or one by id.
- Lookups2 endpointsA track by ISRC, or an album by UPC.
- Snapshots2 endpointsList a playlist's stored snapshots, or create a new one with POST.
- Users2 endpointsA Spotify user's public profile — with limits on the playlists, artists and episodes returned — and the user's followers.
- Markets1 endpointThe countries where Spotify is available.
All 123 operations
AI24
- AI module health
- Supported AI analysis types
- Generic AI analysis
- postGeneric AI analysis
- Chart trends analysis
- postChart trends analysis
- Artist summary
- postArtist summary
- Album review
- postAlbum review
- Track deep dive
- postTrack deep dive
- Playlist curator
- postPlaylist curator
- Market comparison
- postMarket comparison
- Genre landscape
- postGenre landscape
- Mood profile
- postMood profile
- Viral potential
- postViral potential
- Custom AI prompt
- postCustom AI prompt
Artists10
FAQ
How do I access the API?
The same endpoints are exposed through three channels: RapidAPI (Spotify81), Apify (spotify-scraper actor), and the Direct Portal at spotify-sub.checkleaked.com. Pick whichever billing model fits your stack.
How do I authenticate?
On RapidAPI you pass an X-RapidAPI-Key header. On the Direct Portal you pass a Bearer token. On Apify the actor handles auth for you.
Are POST endpoints idempotent?
Most are: posting the same body produces the same response and side effects. Webhook registration and tracking-track create exactly one record per (id, type) pair.
What's the rate limit?
The Run buttons on this site call a demo proxy, not the product. It answers same-origin browser requests only, at 100 requests per 15 minutes and 500 per day per visitor and within a shared budget across all visitors, then shows a recorded sample where one exists. With your own key: 5 requests per second on every RapidAPI plan (1,000 to unlimited requests a month by tier) and 10 requests per second on the Direct Portal.
Do you support webhooks for charts?
Yes — register a webhook on the chart-movement event and you'll receive a POST whenever a track's rank changes by more than the threshold you configure.
What's the difference between the /partner/* group and the rest?
The /partner/* endpoints hit Spotify's internal Pathfinder GraphQL v2 layer. They return richer, editorial-grade data (long bios, full discography graphs) than the public Web API equivalents.
Can I track an artist's follower count over time?
Yes — POST /tracking/track with spotifyType=artist and the artist ID. The system polls and emits change events on /tracking/logs, plus webhooks if registered.
Is there OpenAPI / Swagger?
Yes — interactive API docs at https://spotify-proxy.checkleaked.cc/docs. The RapidAPI listing also publishes an OpenAPI spec. This page is hand-curated narrative — read it for orientation, then use the OpenAPI doc for code generation.
Get an API key in 60 seconds
Same endpoints, three billing models. Pick the one that fits your stack.