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

Request
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).

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

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

Related Tags

Similar APIs

View All →