ボードをコードで読む

3 分で始める

• 1Log in and issue a key from account — free accounts included
• 2下の curl をコピーし、キーだけ替えて実行
• 3JSON が返れば完了 — 無料は 1 日 100 回、Pro は毎分 120 回

料金

• Free1 日 100 回 · 個人・評価用
• Pro毎分 120 回 · 月 14,900 ウォン
• Developer商用サービス搭載可 · 月 10 万回 · メール SLA — 月 49,000 ウォン、導入のご相談: [email protected]
• Enterpriseブランドキーワード無制限トラッキング · カスタムレポート(週次/月次 PDF) · 専用アラートチャネル · データバックフィル — お見積り: [email protected]

認証とレート制限

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

現在のボード全体(最大 200 位)を返します。5 分ごとに更新。

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

キーワード 1 件のスコア時系列を返します。hours は既定 168(7 日)、最大 4320(180 日)。

curl -H "Authorization: Bearer ktb_..." \
  "https://www.koreatrendboard.com/api/v1/history?keyword=%ED%95%98%EC%9D%B4%EB%B8%8C&hours=720"

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

GET /api/v1/insights

急上昇・急落・入れ替わり率を一度に返します。limit は既定 20、最大 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": "ハイブ", "rank": 6, "prevRank": 14, "rankJump": 8, "score": 31.2 }
  ],
  "fallers": [],
  "turnover": { "turnoverRate": 12.5, "entered": [], "exited": [] }
}

制限とルール

キーごとに毎分 120 回まで受け付けます。超過時は 429 を返し、しばらく待てば再開します。v1 レスポンスのフィールド名と形は予告なく変えません — 変える必要が出たら v2 を新設します。

401 = キーなし/無効 · 402 = Pro でない · 429 = レート超過