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
Host: account.kkbox.com
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials&client_id={YOUR_CLIENT_ID}&client_secret={YOUR_CLIENT_SECRET}

By Command Line Tool

curl -d "grant_type=client_credentials&&client_id={YOUR_CLIENT_ID}&client_secret={YOUR_CLIENT_SECRET}" https://account.kkbox.com/oauth2/token
{
  "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=剛好遇見你&type=track&territory=TW HTTP/1.1
Host: api.kkbox.com
Authorization: Bearer fCVTwABPlcO6Qxc7Ll23rsdfsf

By Command Line Tool

curl --header "Authorization: Bearer fCVTwABPlcO6Qxc7Ll23rsdfsf" "https://api.kkbox.com/v1.1/search?q=剛好遇見你&type=track&territory=TW"

KKBOX Search API Response

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