KKBOX API

Music / OAuth Advanced HTTPS
Varies by plan (check documentation)

Overview

KKBOX is a leading music streaming platform in Asia offering a vast catalog of Chinese, Japanese, and Korean music. The API provides access to track metadata, charts, playlists, and search via OAuth 2.0. It is a good choice for developers building apps targeting East Asian music audiences.

💡

Beginner Tip

Use the Client Credentials OAuth flow to get a token—you only need your app client ID and secret, no user login required for public catalog data. Tokens expire in one hour, so cache them and refresh when needed.

Available Data

track name and artist
album metadata
audio preview URLs
popularity score
genre classification

Example Response

JSON Response
{
  "name": "Bohemian Rhapsody",
  "artist": "Queen",
  "album": "A Night at the Opera",
  "duration_ms": 354000,
  "popularity": 92,
  "preview_url": "https://p.scdn.co/mp3-preview/..."
}

Field Reference

data List of chart or track objects returned by the endpoint.
data[].id Unique KKBOX identifier for the track or playlist.
data[].title Title of the track or playlist.
data[].album.images Array of image objects at different resolutions for the album art.
data[].artist.name Name of the artist who recorded the track.
pager.total Total number of results available for pagination.

Implementation Example

const url = "https://developer.kkbox.com/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized Access token is missing, expired, or incorrectly formatted.
Re-request a token using the Client Credentials flow and include it as: Authorization: Bearer YOUR_ACCESS_TOKEN
400 Bad Request on /charts The territory parameter is required but was omitted.
Add a valid territory code such as ?territory=TW, HK, SG, MY, or JP to the request.
Empty data array The requested territory has no available chart data.
Try a different territory code (TW and HK have the most complete data).

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 15/20
🔒 Security 15/15
🛠 Developer XP 3/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth OAuth
HTTPS REQUIRED
CORS UNKNOWN
Category Music
Difficulty Advanced
Verified: 2026-04-04

Similar APIs

View All →