The KKBOX English Developer Hub

Welcome to the KKBOX English developer hub. You'll find comprehensive guides and documentation to help you start working with KKBOX English as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Getting Started

Step 1. Create the application client id and client secret

Please sign in KKBOX developer site. Create an app and get the client id and client secret.

Step 2. Get an access token

You can call KKBOX OAuth 2.0 Token API to get an access token.

Token API for Client Credentials Flow Request

POST /oauth2/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded


By Command Line Tool

curl -d "grant_type=client_credentials&&client_id={YOUR_CLIENT_ID}&client_secret={YOUR_CLIENT_SECRET}"
  "access_token": "fCVTwABPlcO6Qxc7Ll23rsdfsf",
  "expires_in": 1492982700,
  "token_type": "Bearer"

Step 3. Fetch resource from KKBOX APIs

While fetch resources from KKBOX APIs. You must add "Authorization: Bearer {YOUR_ACCESS_TOKEN}" to the HTTP header. For example, calling Search API.

KKBOX Search API Request

GET /v1.1/search?q=Different World&type=track&territory=TW HTTP/1.1
Authorization: Bearer fCVTwABPlcO6Qxc7Ll23rsdfsf

By Command Line Tool

curl --header "Authorization: Bearer fCVTwABPlcO6Qxc7Ll23rsdfsf" " World&type=track&territory=TW"

KKBOX Search API Response

  "tracks": {...},
  "paging": {...},
  "summary": {...}

Updated about a year ago

Getting Started

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.