키팡 데이터 API
실시간 검색어 데이터를 API로
여러 채널의 인기검색어를 3시간 간격으로 실측 수집한 데이터입니다. 통합 TOP20과 급상승 랭킹은 지금 바로 무료로 호출할 수 있습니다. 대시보드, 자동화 봇, 리서치에 바로 쓰세요.
엔드포인트
| 엔드포인트 | 내용 | 갱신 | 상태 |
|---|---|---|---|
/api/v1/top | 현재 통합 TOP20 (순위, 검색어, 채널 수, 변동). ?n=10 지원 | 3시간 | 제공 중 |
/api/v1/rising | 직전 배치 대비 상승폭 랭킹 (상승+신규) | 3시간 | 제공 중 |
/api/v1/keyword/{검색어} | 검색어별 순위 이력 시계열 (배치 단위) | 3시간 | 준비 중 |
/api/v1/new | 최근 7일 신규 등장 검색어 (최초 포착 시각 포함) | 3시간 | 준비 중 |
제공 중 엔드포인트는 현재 인증 없이 무료입니다(CORS 허용, 정상 응답 180초 캐시). GET·HEAD만 지원합니다. 과도한 자동 호출은 사전 안내 없이 차단될 수 있습니다. 준비 중 스펙은 수요에 따라 조정됩니다.
최신성과 장애 처리
timezone은 Asia/Seoul이며, sources에서 소스별 마지막 수집 시각과 상태를 제공합니다. partial: true이면 일부 소스가 지연되었거나 비어 있습니다. 소스마다 수집 주기가 달라 통합 순위를 같은 시각의 검색량으로 해석하면 안 됩니다.
사용 가능한 데이터가 없으면 HTTP 503과 ok: false를 반환하며 캐시하지 않습니다. Retry-After: 180 이후 다시 확인하세요. 반면 급상승 결과가 없는 정상 배치는 HTTP 200의 빈 목록입니다. 현재 수집 상태 확인
응답 예시
| 요청 | 응답(요약) |
|---|---|
GET /api/v1/top?n=3 | {"ok": true, "updated": "2026-08-05T09:00:00+09:00", "rows": [{"rank": 1, "keyword": "...", "channels": 4, "delta": "NEW", "url": "https://keypang.kr/k/..."}]} |
이런 곳에 쓸 수 있습니다
| 사용처 | 예시 |
|---|---|
| 콘텐츠 자동화 | 매일 아침 뜨는 검색어를 내 노션·슬랙·디스코드로 전송 |
| 서비스 내 위젯 | 내 사이트에 실시간 인기검색어 표시 |
| 리서치·리포트 | 기간별 검색어 흐름 분석, 업종 키워드 추적 |
먼저 쓰고 싶다면 지금 알려주세요. 어떤 데이터를 어떤 주기로 쓰실지 한 줄이면 됩니다. 문의가 모이는 순서대로 우선 공개하고, 초기 신청자에게는 무료 구간을 넉넉히 드립니다.
메일로 도입 문의하기