📚112 Endpoints — Full Reference

Spotify API Endpoint Catalog

Every endpoint, every parameter, every example. The complete developer reference for the Spotify proxy API.

This page is the canonical reference for the Spotify proxy API. It catalogs 112 endpoints across 19 domains — search, charts, lyrics, partner / pathfinder v2 calls, AI analysis, tracking, webhooks and more. Each endpoint card lists the HTTP method, path, required and optional parameters, a one-line description and a copy-able cURL example.

Use the search box to filter by path or description, the side nav to jump between groups, and the cURL snippets to test directly from your terminal. The same endpoints are available via three platforms: RapidAPI, Apify, and the Direct Portal. Full OpenAPI reference at spotify-proxy.checkleaked.cc/docs.

Jump to group...

🩺Health & System(8)

#

System-status endpoints used to monitor proxy health, instance state, and cluster strictness. Useful for uptime probes, load-balancer checks, and dashboard widgets.

GET/ping

Lightweight liveness probe — returns pong with timestamp.

https://spotify-proxy.checkleaked.cc/ping
GET/health

Full health snapshot for the current instance (memory, queues, dependencies).

https://spotify-proxy.checkleaked.cc/health
GET/health/instance

Instance-level health detail with per-worker stats.

https://spotify-proxy.checkleaked.cc/health/instance
GET/health/cluster

Aggregated health across the whole proxy cluster.

https://spotify-proxy.checkleaked.cc/health/cluster
GET/health/cluster/strict

Strict cluster check — fails if any node is degraded.

https://spotify-proxy.checkleaked.cc/health/cluster/strict
GET/health/proxies

List upstream proxy nodes with last-seen status and error rate.

https://spotify-proxy.checkleaked.cc/health/proxies
POST/health/proxies/clear

Clear proxy error counters and reset rotation state.

https://spotify-proxy.checkleaked.cc/health/proxies/clear
POST/health/clear-errors

Clear cached error counters for the current instance.

https://spotify-proxy.checkleaked.cc/health/clear-errors

🔐Credentials & Cache(4)

#

Inspect the credentials pool, cookie store, and Redis cache that power every Spotify call. Use these for diagnostic dashboards and to invalidate cache when you publish data updates.

GET/credentials/status

Overview of available Spotify credential pools and rotation state.

https://spotify-proxy.checkleaked.cc/credentials/status
GET/cookies/redis

Inspect the Redis-backed cookie/credential store.

https://spotify-proxy.checkleaked.cc/cookies/redis
GET/cache/stats

Cache hit/miss/eviction stats across all keys.

https://spotify-proxy.checkleaked.cc/cache/stats
POST/cache/invalidate

Invalidate a cache key or pattern.

Required

  • key: string
Optional (1)
  • pattern: string
https://spotify-proxy.checkleaked.cc/cache/invalidate

💿Albums(4)

#

Album metadata, track lists and batch fetches. Useful for catalog pages, album-of-the-week features and editorial layouts.

GET/albums

Get a single album by ID.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/albums?id=06HL4z0CvFAxyc27GXpf02
GET/album_tracks

Track list for an album.

Required

  • id: string
Optional (2)
  • limit: number
  • offset: number
https://spotify-proxy.checkleaked.cc/album_tracks?id=06HL4z0CvFAxyc27GXpf02
GET/album_metadata

Extended metadata for an album (label, copyrights, popularity).

Required

  • id: string
https://spotify-proxy.checkleaked.cc/album_metadata?id=06HL4z0CvFAxyc27GXpf02
POST/album_metadata_batch

Batch fetch extended metadata for multiple albums.

Required

  • ids: string[]
https://spotify-proxy.checkleaked.cc/album_metadata_batch

🎤Artists(12)

#

Everything about an artist: discography, top tracks, related artists, features, comparisons. The richest endpoint group in the catalog.

GET/artists

Core artist profile by ID.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/artists?id=06HL4z0CvFAxyc27GXpf02
GET/artist_overview

Editorial overview: bio, header art, monthly listeners.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/artist_overview?id=06HL4z0CvFAxyc27GXpf02
POST/artist_overview_batch

Batch artist overviews.

Required

  • ids: string[]
https://spotify-proxy.checkleaked.cc/artist_overview_batch
GET/artist_discography_overview

Aggregated discography with album/single counts.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/artist_discography_overview?id=06HL4z0CvFAxyc27GXpf02
GET/artist_albums

Albums by an artist.

Required

  • id: string
Optional (2)
  • limit: number
  • offset: number
https://spotify-proxy.checkleaked.cc/artist_albums?id=06HL4z0CvFAxyc27GXpf02
GET/artist_singles

Singles & EPs by an artist.

Required

  • id: string
Optional (1)
  • limit: number
https://spotify-proxy.checkleaked.cc/artist_singles?id=06HL4z0CvFAxyc27GXpf02
GET/artist_appears_on

Albums where an artist is featured.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/artist_appears_on?id=06HL4z0CvFAxyc27GXpf02
GET/artist_discovered_on

Playlists where users discover this artist.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/artist_discovered_on?id=06HL4z0CvFAxyc27GXpf02
GET/artist_featuring

Tracks where this artist appears as a guest.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/artist_featuring?id=06HL4z0CvFAxyc27GXpf02
GET/artist_related

Related artists.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/artist_related?id=06HL4z0CvFAxyc27GXpf02
GET/artist_top_tracks

Top tracks for an artist in a market.

Required

  • id: string
Optional (1)
  • market: string
https://spotify-proxy.checkleaked.cc/artist_top_tracks?id=06HL4z0CvFAxyc27GXpf02
GET/artist_compare

Side-by-side comparison of two artists.

Required

  • idA: string
  • idB: string
https://spotify-proxy.checkleaked.cc/artist_compare?idA=06HL4z0CvFAxyc27GXpf02&idB=06HL4z0CvFAxyc27GXpf02

🎵Tracks(8)

#

Track metadata, lyrics, credits, audio features and ML-powered recommendations. The core surface for any music app.

GET/tracks

Get a single track by ID.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/tracks?id=06HL4z0CvFAxyc27GXpf02
GET/track_credits

Songwriter / producer / engineer credits for a track.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/track_credits?id=06HL4z0CvFAxyc27GXpf02
POST/track_credits_batch

Batch credits for multiple tracks.

Required

  • ids: string[]
https://spotify-proxy.checkleaked.cc/track_credits_batch
GET/track_lyrics

Time-synced lyrics for a track.

Required

  • id: string
Optional (1)
  • format: string
https://spotify-proxy.checkleaked.cc/track_lyrics?id=06HL4z0CvFAxyc27GXpf02
POST/track_lyrics_batch

Batch lyrics fetch.

Required

  • ids: string[]
https://spotify-proxy.checkleaked.cc/track_lyrics_batch
POST/track_popularity_batch

Batch popularity scores for tracks.

Required

  • ids: string[]
https://spotify-proxy.checkleaked.cc/track_popularity_batch
GET/audio_features

Audio analysis features (danceability, energy, tempo).

Required

  • id: string
https://spotify-proxy.checkleaked.cc/audio_features?id=06HL4z0CvFAxyc27GXpf02
GET/recommendations

Recommended tracks given seeds.

Optional (4)
  • seed_artists: csv
  • seed_tracks: csv
  • seed_genres: csv
  • limit: number
https://spotify-proxy.checkleaked.cc/recommendations

🎧Playlists(6)

#

Read playlist metadata, tracks and analytics; create snapshots over time and seed new playlists from track lists. Powers curator dashboards and playlist analytics tools.

GET/playlist

Playlist metadata and owner info.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/playlist?id=06HL4z0CvFAxyc27GXpf02
GET/playlist_tracks

All tracks in a playlist with pagination.

Required

  • id: string
Optional (2)
  • limit: number
  • offset: number
https://spotify-proxy.checkleaked.cc/playlist_tracks?id=06HL4z0CvFAxyc27GXpf02
GET/playlist_analysis

Aggregated audio-feature and genre analysis of a playlist.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/playlist_analysis?id=06HL4z0CvFAxyc27GXpf02
GET/playlist_snapshot

Get the latest stored snapshot of a playlist.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/playlist_snapshot?id=06HL4z0CvFAxyc27GXpf02
POST/playlist_snapshot

Trigger a fresh snapshot capture of a playlist.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/playlist_snapshot
POST/seed_to_playlist

Build a playlist concept from a list of seed tracks.

Required

  • seeds: string[]
Optional (1)
  • size: number
https://spotify-proxy.checkleaked.cc/seed_to_playlist

👤Users(2)

#

Public Spotify user profiles and follower counts. Use for user-discovery features and displaying playlist owners.

GET/user_profile

Public profile data for a Spotify user.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/user_profile?id=06HL4z0CvFAxyc27GXpf02
GET/user_followers

Follower count for a Spotify user.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/user_followers?id=06HL4z0CvFAxyc27GXpf02

📊Charts & Trending(6)

#

Daily-refreshed global charts: top tracks, artists by listeners and followers, viral tracks, top albums. Power chart pages and homepage hero modules.

GET/top_20_by_monthly_listeners

Top 20 artists ranked by monthly listeners.

https://spotify-proxy.checkleaked.cc/top_20_by_monthly_listeners
GET/top_200_tracks

Top 200 tracks worldwide.

Optional (1)
  • date: YYYY-MM-DD
https://spotify-proxy.checkleaked.cc/top_200_tracks
GET/top_artists

Top artists global chart.

Optional (1)
  • country: string
https://spotify-proxy.checkleaked.cc/top_artists
GET/top_albums

Top albums chart.

Optional (1)
  • country: string
https://spotify-proxy.checkleaked.cc/top_albums
GET/viral_tracks

Currently viral tracks.

Optional (1)
  • country: string
https://spotify-proxy.checkleaked.cc/viral_tracks
GET/top_20_by_followers

Top 20 artists ranked by total followers.

https://spotify-proxy.checkleaked.cc/top_20_by_followers

⬇️Downloads(2)

#

Download endpoints for previewing tracks (Spotify preview audio and SoundCloud fallback). For demo / preview-player UIs only — not for redistribution.

GET/download_track

Get a downloadable track preview.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/download_track?id=06HL4z0CvFAxyc27GXpf02
GET/download_track_sc

SoundCloud-fallback track download.

Required

  • query: string
https://spotify-proxy.checkleaked.cc/download_track_sc?query=06HL4z0CvFAxyc27GXpf02

🧭Browse(5)

#

Spotify's editorial browse layer: categories, featured playlists, new releases and the recommendations endpoint. Powers home screens and discovery rails.

GET/browse/categories

List all browse categories.

Optional (3)
  • country: string
  • locale: string
  • limit: number
https://spotify-proxy.checkleaked.cc/browse/categories
GET/browse/categories/{id}

Get a single browse category.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/browse/categories/{id}?id=06HL4z0CvFAxyc27GXpf02
GET/browse/featured-playlists

Spotify's editorial featured playlists.

Optional (2)
  • country: string
  • limit: number
https://spotify-proxy.checkleaked.cc/browse/featured-playlists
GET/browse/new-releases

Newly released albums.

Optional (2)
  • country: string
  • limit: number
https://spotify-proxy.checkleaked.cc/browse/new-releases
GET/browse/recommendations

Browse-layer recommendations from seeds.

Optional (3)
  • seed_artists: csv
  • seed_tracks: csv
  • seed_genres: csv
https://spotify-proxy.checkleaked.cc/browse/recommendations

📖Audiobooks(3)

#

Spotify audiobook catalog endpoints. Use for audiobook discovery features, library browsing and chapter-level navigation.

GET/audiobooks

Search/list audiobooks.

Optional (2)
  • q: string
  • market: string
https://spotify-proxy.checkleaked.cc/audiobooks
GET/audiobooks/{id}

Single audiobook detail.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/audiobooks/{id}?id=06HL4z0CvFAxyc27GXpf02
GET/audiobooks/{id}/chapters

Chapter list for an audiobook.

Required

  • id: string
Optional (1)
  • limit: number
https://spotify-proxy.checkleaked.cc/audiobooks/{id}/chapters?id=06HL4z0CvFAxyc27GXpf02

🎙️Podcasts / Shows(5)

#

Podcast (show) and episode endpoints. Use for podcast directories, episode players and show-level analytics.

GET/shows

List/search podcast shows.

Optional (2)
  • q: string
  • market: string
https://spotify-proxy.checkleaked.cc/shows
GET/shows/{id}

Single show metadata.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/shows/{id}?id=06HL4z0CvFAxyc27GXpf02
GET/shows/{id}/episodes

Episodes of a show.

Required

  • id: string
Optional (2)
  • limit: number
  • offset: number
https://spotify-proxy.checkleaked.cc/shows/{id}/episodes?id=06HL4z0CvFAxyc27GXpf02
GET/episodes

List episodes by query.

Optional (1)
  • q: string
https://spotify-proxy.checkleaked.cc/episodes
GET/episodes/{id}

Single episode metadata.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/episodes/{id}?id=06HL4z0CvFAxyc27GXpf02

🔎Lookup(3)

#

Reverse-lookup endpoints by industry codes (ISRC, UPC) and the supported markets list. Useful for distribution backends and ingestion pipelines.

GET/isrc_lookup

Find a track by ISRC code.

Required

  • isrc: string
https://spotify-proxy.checkleaked.cc/isrc_lookup?isrc=06HL4z0CvFAxyc27GXpf02
GET/upc_lookup

Find an album by UPC code.

Required

  • upc: string
https://spotify-proxy.checkleaked.cc/upc_lookup?upc=06HL4z0CvFAxyc27GXpf02
GET/markets

List all supported Spotify markets.

https://spotify-proxy.checkleaked.cc/markets

🧬Partner / Pathfinder v2(6)

#

Partner endpoints that hit Spotify's internal Pathfinder GraphQL v2 layer for richer data than the public Web API. Use these when you need editorial copy, full discography graphs, or GraphQL-shape responses.

GET/partner/playlist

Pathfinder v2 playlist query.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/partner/playlist?id=06HL4z0CvFAxyc27GXpf02
GET/partner/track

Pathfinder v2 track query.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/partner/track?id=06HL4z0CvFAxyc27GXpf02
GET/partner/track/count

Aggregated play-count style metric for a track.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/partner/track/count?id=06HL4z0CvFAxyc27GXpf02
GET/partner/album

Pathfinder v2 album query.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/partner/album?id=06HL4z0CvFAxyc27GXpf02
GET/partner/artist-overview

Pathfinder v2 artist overview.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/partner/artist-overview?id=06HL4z0CvFAxyc27GXpf02
GET/partner/artist-discography

Pathfinder v2 full artist discography.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/partner/artist-discography?id=06HL4z0CvFAxyc27GXpf02

🎟️Concerts(5)

#

Live-event endpoints powered by Spotify's concert partner integration. Surface tour dates, location feeds and concert-artist search inside your app.

GET/partner/concert-locations

List supported concert locations.

Optional (1)
  • country: string
https://spotify-proxy.checkleaked.cc/partner/concert-locations
GET/partner/concert-feed

Upcoming concerts feed for a location.

Required

  • location: string
Optional (1)
  • limit: number
https://spotify-proxy.checkleaked.cc/partner/concert-feed?location=06HL4z0CvFAxyc27GXpf02
GET/partner/concert

Single concert detail.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/partner/concert?id=06HL4z0CvFAxyc27GXpf02
GET/partner/artist-concerts

Upcoming concerts for an artist.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/partner/artist-concerts?id=06HL4z0CvFAxyc27GXpf02
GET/partner/search-concert-artists

Search artists with active tour dates.

Required

  • q: string
https://spotify-proxy.checkleaked.cc/partner/search-concert-artists?q=06HL4z0CvFAxyc27GXpf02

📡Webhooks(6)

#

Subscribe to push notifications for Spotify events: chart movement, follower milestones, new releases. Replace polling with HTTP callbacks straight to your stack.

GET/webhooks

List your registered webhooks.

https://spotify-proxy.checkleaked.cc/webhooks
POST/webhooks/register

Register a new webhook URL for an event.

Required

  • url: string
  • event: string
Optional (1)
  • secret: string
https://spotify-proxy.checkleaked.cc/webhooks/register
GET/webhooks/stats

Delivery stats across all your webhooks.

https://spotify-proxy.checkleaked.cc/webhooks/stats
DELETE/webhooks/{id}

Delete a registered webhook.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/webhooks/{id}
POST/webhooks/{id}/test

Send a test payload to a registered webhook.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/webhooks/{id}/test
GET/webhooks/{id}/deliveries

Per-webhook delivery log.

Required

  • id: string
Optional (1)
  • limit: number
https://spotify-proxy.checkleaked.cc/webhooks/{id}/deliveries?id=06HL4z0CvFAxyc27GXpf02

📍Tracking(9)

#

Track Spotify entities (artists, tracks, albums) for change detection — perfect for follower-count monitoring, release alerts and chart-movement dashboards.

GET/tracking/track

Read tracked items (GET form).

Optional (1)
  • type: string
https://spotify-proxy.checkleaked.cc/tracking/track
POST/tracking/track

Start tracking a Spotify entity.

Required

  • spotifyType: string
  • spotifyId: string
https://spotify-proxy.checkleaked.cc/tracking/track
GET/tracking/untrack

Untrack via GET (idempotent).

Required

  • spotifyId: string
https://spotify-proxy.checkleaked.cc/tracking/untrack?spotifyId=06HL4z0CvFAxyc27GXpf02
DELETE/tracking/untrack

Untrack via DELETE.

Required

  • spotifyId: string
https://spotify-proxy.checkleaked.cc/tracking/untrack
GET/tracking/items

List all tracked items.

https://spotify-proxy.checkleaked.cc/tracking/items
GET/tracking/items/{spotifyType}/{spotifyId}

Detail for a single tracked item.

Required

  • spotifyType: string
  • spotifyId: string
https://spotify-proxy.checkleaked.cc/tracking/items/{spotifyType}/{spotifyId}?spotifyType=06HL4z0CvFAxyc27GXpf02&spotifyId=06HL4z0CvFAxyc27GXpf02
GET/tracking/logs

Change-event log across all tracked items.

Optional (1)
  • limit: number
https://spotify-proxy.checkleaked.cc/tracking/logs
GET/tracking/stats

Aggregate stats: total items, events/day, top movers.

https://spotify-proxy.checkleaked.cc/tracking/stats
GET/tracking/health

Tracking subsystem health probe.

https://spotify-proxy.checkleaked.cc/tracking/health

🤖AI Analysis(13)

#

LLM-powered analysis on top of Spotify data. Generate artist summaries, album reviews, chart-trend reports, mood profiles and viral predictions — see the live demo on the AI Insights page.

GET/ai/health

AI subsystem health probe.

https://spotify-proxy.checkleaked.cc/ai/health
GET/ai/types

List every AI analysis mode and its params.

https://spotify-proxy.checkleaked.cc/ai/types
POST/ai/analyze

Generic analyzer — pass type+id.

Required

  • type: string
  • id: string
https://spotify-proxy.checkleaked.cc/ai/analyze
POST/ai/chart-trends

AI commentary on chart movement.

Required

  • country: string
  • period: string
https://spotify-proxy.checkleaked.cc/ai/chart-trends
POST/ai/artist-summary

Editorial artist summary.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/ai/artist-summary
POST/ai/album-review

Long-form album review.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/ai/album-review
POST/ai/track-deep-dive

Lyric / production / cultural analysis.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/ai/track-deep-dive
POST/ai/playlist-curator

AI playlist concept from prompt + seeds.

Required

  • prompt: string
Optional (1)
  • seeds: string[]
https://spotify-proxy.checkleaked.cc/ai/playlist-curator
POST/ai/market-comparison

Compare two markets' charts.

Required

  • countryA: string
  • countryB: string
Optional (1)
  • period: string
https://spotify-proxy.checkleaked.cc/ai/market-comparison
POST/ai/genre-landscape

AI map of a genre's leaders & sub-genres.

Required

  • genre: string
https://spotify-proxy.checkleaked.cc/ai/genre-landscape
POST/ai/mood-profile

Multi-axis mood scoring of a track.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/ai/mood-profile
POST/ai/viral-potential

Viral score with TikTok hook reasoning.

Required

  • id: string
https://spotify-proxy.checkleaked.cc/ai/viral-potential
POST/ai/custom

Free-form prompt with structured params.

Required

  • prompt: string
Optional (1)
  • params: object
https://spotify-proxy.checkleaked.cc/ai/custom

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?

Free tier on this demo proxy: 10 requests / 15 min and 50 requests / day. Paid plans on RapidAPI / Direct Portal raise this to unlimited or per-minute quotas depending on tier.

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.

⚡ RapidAPI🕷️ Apify💎 Direct Portal