482K
API calls this month
99.98%
Uptime (30d)
142ms
Avg response time
3
Active API keys
Quick Start
# 1. Authenticate
curl -X POST https://api.ookimusic.com/v1/auth/token \
-H "Content-Type: application/json" \
-d '{"api_key": "ok_live_YOUR_KEY_HERE"}'
# 2. Fetch tracks
curl https://api.ookimusic.com/v1/tracks \
-H "Authorization: Bearer YOUR_JWT" \
-H "X-API-Key: ok_live_YOUR_KEY_HERE"
# Response
{
"data": [...],
"total": 12400,
"page": 1,
"limit": 20
}
API Reference
Authentication
POST/v1/auth/tokenExchange API key for JWT bearer token
POST/v1/auth/refreshRefresh expired access token
POST/v1/auth/revokeRevoke current session token
Tracks
GET/v1/tracksList tracks (paginated)
GET/v1/tracks/{id}Get track by ID
POST/v1/tracksUpload new track (Artist scope)
PATCH/v1/tracks/{id}Update track metadata
DELETE/v1/tracks/{id}Remove track
GET/v1/tracks/{id}/streamGet stream URL (CDN redirect)
Artists
GET/v1/artistsList artists
GET/v1/artists/{slug}Get artist by slug
GET/v1/artists/{id}/tracksList artist's tracks
GET/v1/artists/{id}/analyticsArtist analytics (requires artist scope)
Users
GET/v1/users/meCurrent authenticated user
PATCH/v1/users/meUpdate profile
GET/v1/users/me/librarySaved tracks & albums
POST/v1/users/me/library/{id}Save track to library
Analytics
GET/v1/analytics/streamsStream data (requires analytics scope)
GET/v1/analytics/top-tracksGlobal top tracks
GET/v1/analytics/top-artistsGlobal top artists
Webhooks
GET/v1/webhooksList registered webhooks
POST/v1/webhooksRegister new webhook
DELETE/v1/webhooks/{id}Remove webhook
OMG Radio API β
GET/omg/v1/radio/now-playingCurrent now-playing card
POST/omg/v1/generate/trackGenerate AI track (async)
POST/omg/v1/generate/lyricsGenerate AI lyrics
GET/omg/v1/admin/configStation configuration (admin)
GET/omg/v1/registry/tracksAI track registry (admin)
Rate Limits & Scopes
Rate Limits
live Production
1,000,000 req/month
test Sandbox
100,000 req/month
Per-minute burst
500 req/min
Available Scopes
streams:read
tracks:read · tracks:write
users:read
analytics:read
webhooks:read · webhooks:write