판을 코드로 읽는다

시작하기

키는 계정 화면에서 발급합니다. 발급 직후 한 번만 전체가 표시되니 바로 보관하세요. 모든 요청에 아래처럼 붙입니다.

Authorization: Bearer ktb_xxxxxxxxxxxxxxxx

API는 Pro 전용입니다. Pro로 올리기 →

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

키워드 하나의 점수 시계열을 돌려줍니다. 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 = 한도 초과