공개 API
whydem의 실시간 데이터를 JSON으로 제공합니다. 인증 없이 바로 쓸 수 있고(무료 티어), 더 높은 한도가 필요하면 API 키로 상향됩니다. 모든 엔드포인트는 읽기 전용 GET이며 CORS를 허용합니다.
엔드포인트
| 엔드포인트 | 설명 |
|---|---|
GET /api/ranking | 상위 키워드 + 최신 '왜 떴는지' 요약 (60초 캐시) |
GET /api/board?source= | 통합(기본) 또는 소스별 실시간 보드 |
GET /api/keyword/:q | 키워드 상세 — 순위 추이 + 이유 |
GET /api/keyword/:q/reason | 키워드의 이유 + 출처만 |
예시
curl https://whydem.com/api/ranking
요금(레이트리밋)
무료는 IP당 분당 60회입니다. 키가 있으면 키별 상향 한도가 적용됩니다. 키는 x-api-key 헤더(또는 ?apiKey= 쿼리)로 전달하세요.
curl -H "x-api-key: YOUR_KEY" https://whydem.com/api/board
한도를 넘으면 429와 Retry-After 헤더를 돌려줍니다.
API 키 발급
Pro를 결제하면 상향 한도 키가 가입 메일로 자동 발급됩니다(받은 키를 x-api-key 헤더에 넣어 호출). 결제 출시 전이라면 Pro 페이지에 이메일을 남겨주시면 발급 안내를 보내드립니다.