whydem의 실시간 데이터를 JSON으로 제공합니다. 인증 없이 바로 쓸 수 있고(무료 티어), 더 높은 한도가 필요하면 API 키로 상향됩니다. 모든 엔드포인트는 읽기 전용 GET이며 CORS를 허용합니다.
| 엔드포인트 | 설명 |
|---|---|
GET /api/event/:key | 사건 클러스터 상세 — 관련 검색어 + 순위 추이 + 이유 (60초 CDN 캐시) |
GET /api/ranking | 상위 키워드 + 최신 '왜 떴는지' 요약 (60초 CDN 캐시) |
GET /api/board?source= | 통합(기본) 또는 소스별 실시간 보드 (no-store) |
GET /api/keyword/:q | 키워드 상세 — 순위 추이 + 이유 (60초 CDN 캐시) |
GET /api/keyword/:q/reason | 키워드의 이유 + 출처만 (60초 CDN 캐시) |
curl https://whydem.com/api/ranking
이유 응답에는 rollout 단계에 따라 associationKind, temporalRelation, mode, observation이 포함됩니다. 이 필드들은 관련성과 시간 순서를 분리하며 인과 확정을 뜻하지 않습니다. 호환 필드 grounded도 “근거에 연결됨”만 뜻합니다. 선택적으로 evidenceKind, verification, evidenceFirstSeenAt, evidenceClusterCount, evidenceVersion이 포함됩니다. verification=propagation-only는 커뮤니티 확산만 확인됐고 게시물 주장의 진위는 확인되지 않았다는 뜻입니다. 각 출처의 kind와 relation은 근거 성격과 결론에 대한 관계를 나타냅니다.
무료는 IP당 분당 60회입니다. 키가 있으면 키별 상향 한도가 적용됩니다. 키는 x-api-key 헤더(또는 ?apiKey= 쿼리)로 전달하세요.
curl -H "x-api-key: YOUR_KEY" https://whydem.com/api/board
한도를 넘으면 429와 Retry-After 헤더를 돌려줍니다.
Pro를 결제하면 상향 한도 키가 가입 메일로 자동 발급됩니다(받은 키를 x-api-key 헤더에 넣어 호출). 결제 출시 전이라면 Pro 페이지에 이메일을 남겨주시면 발급 안내를 보내드립니다.