Read the board with code

Getting started

Issue a key from your account page. The full key is shown only once — store it right away. Send it with every request:

Authorization: Bearer ktb_xxxxxxxxxxxxxxxx

The API requires Pro. Upgrade →

GET /api/v1/trends

Returns the full current board (up to 200 rows). Refreshes every 5 minutes.

curl -H "Authorization: Bearer ktb_..." \
  https://www.koreatrendboard.com/api/v1/trends

{
  "ok": true,
  "capturedAt": "2026-08-26T07:30:00.000Z",
  "rows": [
    { "rank": 1, "keyword": "전현무", "score": 45.0,
      "delta": 2.1, "sources": ["google", "youtube"] }
  ]
}

GET /api/v1/history

Returns the score time series for one keyword. hours defaults to 168 (7 days), max 4320 (180 days).

curl -H "Authorization: Bearer ktb_..." \
  "https://www.koreatrendboard.com/api/v1/history?keyword=hive&hours=720"

{
  "ok": true,
  "keyword": "hive",
  "hours": 720,
  "points": [
    { "capturedAt": "2026-08-25T10:00:00.000Z", "score": 27.6, "rank": 10 }
  ]
}

GET /api/v1/insights

Returns surges, fallers and board turnover in one call. limit defaults to 20, max 100.

curl -H "Authorization: Bearer ktb_..." \
  "https://www.koreatrendboard.com/api/v1/insights?limit=20"

{
  "ok": true,
  "generatedAt": "2026-08-26T01:40:00.000Z",
  "surges": [
    { "keyword": "hive", "rank": 6, "prevRank": 14, "rankJump": 8, "score": 31.2 }
  ],
  "fallers": [],
  "turnover": { "turnoverRate": 12.5, "entered": [], "exited": [] }
}

Limits & rules

Each key gets 120 requests per minute; beyond that you receive 429 until the window refills. v1 field names and shapes will not change without notice — breaking changes go to a new v2.

401 = missing/invalid key · 402 = not on Pro · 429 = rate limited