Pro API

ボードをコードで読む

リアルタイム順位とキーワード推移をそのまま取得し、自分のダッシュボード・アラート・レポートに組み込めます。無料キーで 1 日 100 回まで今すぐ試せます — 決済は試してからで。

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

今のアカウントで 1 日 100 回まですぐ使えます。商用トラフィックなら Pro(毎分 120 回) →

GET /api/v1/sample キー不要

登録もキーも不要で今すぐ動きます。上位 5 行だけですが、レスポンスの形はすべて分かります。

curl https://www.koreatrendboard.com/api/v1/sample

レスポンス形式は JSON Schema でも提供します — /api/v1/schema。コード生成器や検証器にそのまま入れられます。

ブラウザでそのまま開けます。CORS を開けてあるので fetch でも動きます。

無料キーを取ると 10 行と履歴まで開きます。

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/feed

RSS・JSON フィードです。locale は ko・en・ja、format=json なら JSON Feed 1.1 で返します。キーなしで 20 位まで無料です。

GET https://www.koreatrendboard.com/api/feed?locale=ko
GET https://www.koreatrendboard.com/api/feed?locale=en&format=json

key パラメータに API キーを付けると 60 位まで増え、早期警報も一緒に届きます — まだ板に出ていないものを先に受け取ります。キーがない・誤っている場合は無料フィードに戻ります（購読が切れないように）。

GET https://www.koreatrendboard.com/api/feed?locale=ko&key=YOUR_KEY

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/backfill

期間をまとめて日単位で返します。keywords を省略するとその期間に上がったもの全件。Pro 92 日・無料 7 日。

curl -H "Authorization: Bearer ktb_..." \
  "https://www.koreatrendboard.com/api/v1/backfill?from=2026-07-01&to=2026-07-31&format=csv"

{
  "ok": true,
  "from": "2026-07-01",
  "to": "2026-07-31",
  "days": 31,
  "count": 1842,
  "rows": [
    { "day": "2026-07-01", "keyword": "ハイブ", "bestRank": 4, "avgScore": 31.2, "appearances": 61 }
  ]
}

Pro は直近 92 日まで取得できます。それ以前の記録が必要な場合は全期間データを別途ご提供します — [email protected]

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": [] }
}

GET /api/v1/daily

キーワード 1 件の日次・長期履歴を返します。days は既定 90、最大 730。直近は 5 分スナップショットの日次集計、それ以前は日次ロールアップですが、同じ形で返るため境界を意識する必要はありません。

curl -H "Authorization: Bearer ktb_..." \
  "https://www.koreatrendboard.com/api/v1/daily?keyword=%E3%83%8F%E3%82%A4%E3%83%96&days=365"

{
  "ok": true,
  "keyword": "ハイブ",
  "days": 365,
  "points": [
    { "day": "2026-03-14", "bestRank": 3, "peak": 52.8 }
  ]
}

ボードに載らなかった日は行がありません — 存在しない日を 0 で埋めて返すことはしません。

制限とルール

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

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

ボードをコードで読む準備ができたらPro にアップグレード →