Live Access Token
Try It Live
Endpoints
GET
/api/token
Get current Spotify access token
GET
/api/health
API health check and uptime
GET
/api/search
?q= &type= &limit= &offset=
Search tracks, albums, artists, playlists
GET
/api/track/:id
Track details by Spotify ID
GET
/api/album/:id
Album details and track listing
GET
/api/playlist/:id
Playlist info and all tracks
GET
/api/artist/:id
Artist profile and metadata
GET
/api/artist/:id/top-tracks
?market=US
Artist top tracks by market
Click any card above to preview the live response here
Documentation
GET/api/token
Get a live Spotify access token▶
Returns the current anonymous Spotify web-player token. Use in any Spotify API call.
Request
GET /api/token
Response
{
"provider": "CASPER TECH",
"creator": "TRABY CASPER",
"success": true,
"access_token": "BQDxxxxxx...",
"token_type": "Bearer"
}
Use token directly with Spotify
curl -H "Authorization: Bearer BQDxxxxxx..." \
"https://api.spotify.com/v1/search?q=Faded&type=track&limit=5"
GET/api/search
Search Spotify catalogue▶
| Parameter | Type | Description |
|---|---|---|
| q | string · required | Search query e.g. Faded, Drake |
| type | string · required | track, album, artist, playlist, episode, show |
| limit | number · optional | Results to return. Default 10, max 50 |
| offset | number · optional | Pagination offset. Default 0 |
Track search
GET /api/search?q=Faded&type=track&limit=5
Artist search
GET /api/search?q=Drake&type=artist&limit=3
Multiple types
GET /api/search?q=Chill&type=track,album,playlist&limit=5
GET/api/track/:id
Get track by Spotify ID▶
The ID is the last part of any Spotify track URL: open.spotify.com/track/3n3Ppam7vgaVa1iaRUIOKE
Example
GET /api/track/3n3Ppam7vgaVa1iaRUIOKE
GET/api/album/:id
Get album details and track listing▶
Example
GET /api/album/1weenld61qoidwYuZ1GESA
GET/api/playlist/:id
Get playlist info and tracks▶
Example — Global Top 50
GET /api/playlist/37i9dQZEVXbMDoHDwVN2tF
GET/api/artist/:id
Get artist profile▶
Example — Drake
GET /api/artist/3TVXtAsR1Inumwj472S9r4
GET/api/artist/:id/top-tracks
Artist top tracks by market▶
| Parameter | Type | Description |
|---|---|---|
| market | string · optional | ISO country code. Default: US. e.g. KE, NG, GB, ZA |
Example
GET /api/artist/3TVXtAsR1Inumwj472S9r4/top-tracks?market=KE