Ooki Developer Platform

Build the future
of music.

Access Ooki's full music ecosystem via REST APIs. Stream tracks, manage artists, process royalties, and power next-gen music applications.

Try Sandbox Full Docs Get API Key
48
API Endpoints
99.9%
Uptime SLA
2,400+
Active Developers
12M+
API Calls / Day
Platform Capabilities

Everything you need to build

Music Catalog API
Search, browse, and stream from Ooki's full catalog. Access track metadata, audio files, cover art, and ISRC codes.
Artist & Profile API
Retrieve artist profiles, bios, discographies, Sonic Capsules, follower counts, and virtual artist metadata.
Analytics API
Stream counts, DAU/MAU, listener demographics, geo breakdown, device split, and revenue analytics.
Royalty & Payments
Trigger payouts, query royalty splits, generate earnings reports, and integrate with Splurjj payment processing.
Webhooks
Real-time event streams for plays, uploads, follows, purchases, and royalty settlements via HMAC-signed payloads.
Sonic Capsule API
Create, read, and update Sonic Capsules with track metadata, inspiration details, artwork, and Tap-to-Reveal content.
Quick Start

Up and running in minutes

01
Create your account
Sign up as a Developer on Ooki. Your account unlocks sandbox access, API key management, and webhook configuration.
02
Generate an API key
Create a key with the appropriate scopes for your app from your developer dashboard API Keys section.
03
Make your first request
Use the sandbox to test without affecting production data. All requests require an Authorization: Bearer header.
04
Go live
Switch base URL from sandbox to production, register your webhooks, and start building.
Example

Search tracks

# Search the Ooki catalog curl -X GET \ 'https://api.ooki.music/v1/tracks?q=KIRA' \ -H 'Authorization: Bearer YOUR_API_KEY'
// Response 200 OK { "data": [{ "id": "trk_a9f3", "title": "Midnight Signal", "artist": "KIRA", "duration": 204, "streams": 3400000 }], "total": 24 }
API Reference

Core Endpoints

Tracks
GET/v1/tracksList tracks
GET/v1/tracks/{id}Get track
POST/v1/tracksUpload track
PATCH/v1/tracks/{id}Update metadata
DELETE/v1/tracks/{id}Remove track
Artists
GET/v1/artistsList artists
GET/v1/artists/{slug}Artist profile
GET/v1/artists/{slug}/capsulesCapsules
Sonic Capsules
GET/v1/capsulesAll capsules
POST/v1/capsulesCreate capsule
PATCH/v1/capsules/{id}Update capsule
Listeners
GET/v1/listeners/{id}Profile
GET/v1/listeners/{id}/historyPlay history
GET/v1/listeners/{id}/playlistsPlaylists
Analytics
GET/v1/analytics/streamsStream counts
GET/v1/analytics/audienceAudience data
GET/v1/analytics/revenueRevenue report
Webhooks & Auth
GET/v1/webhooksList endpoints
POST/v1/webhooksRegister endpoint
POST/v1/auth/tokenOAuth2 token
POST/v1/auth/refreshRefresh token
Client Libraries

Official SDKs

🟨
JavaScript / Node.js
@ooki/sdk v2.1.0
Stable
🐍
Python
ooki-sdk 1.4.2
Stable
☕
Java / Kotlin
com.ooki:sdk 1.2.0
Beta
🦀
Rust
ooki-rs 0.8.0
Beta
🍎
Swift / iOS
OokiKit 1.0.1
Stable
🤖
Android / Kotlin
ooki-android 1.1.0
Beta
Changelog

What's new

v2.3
April 2025
NEWNEW
Added Sonic Capsule API with Tap-to-Reveal endpoints. Added Covers API for artist gallery management.
v2.2
February 2025
FIXNEW
Fixed rate limit header inconsistency. Added real-time analytics via Server-Sent Events on /v1/analytics/stream.
v2.1
November 2024
BREAKING
Breaking: Renamed artist_id → artist_slug across all endpoints. SDK v2.1 handles migration automatically.
v2.0
August 2024
NEW
Major release: Webhooks v2 with HMAC-SHA256 verification, OAuth 2.0 + PKCE, and full Royalty & Payments API.