B2B API

FactOn API

두 가지 상품을 제공합니다. 팩트체크 단일 호출은 AI 검증 도구로, 토픽별 여론 리포트는 FactOn 커뮤니티의 실제 여론 데이터를 집계한 분석 리포트입니다. 키 하나로 두 상품 모두 사용 가능합니다.

상품 1 — 팩트체크 API

주장 하나를 JSON으로 보내면 Gemini + Google Search로 최신 정보를 검증해서 판정 · 근거 · 출처를 돌려드립니다. 기사 검증 파이프라인 자동화, 허위 주장 스크리닝 용도.

POST /api/v1/factcheck

요청 바디: { "claim": string } · 최대 1000자

요청 예시

curl -X POST https://api.facton.kr/api/v1/factcheck \
  -H "Authorization: Bearer fc_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"claim":"한국은행이 2026년 4월 기준금리를 동결했다"}'

응답 예시

{
  "verdict": "fact",
  "summary": "사실",
  "evidence": "현재(2026년 4월 기준) 한국은행 금융통화위원회는 ...",
  "sources": [
    { "title": "한국은행 금통위 의결문", "url": "https://www.bok.or.kr/..." }
  ],
  "usage": { "month": "2026-04", "used": 27, "cap": 1000 }
}

상품 2 — 토픽 여론 리포트

FactOn 커뮤니티에 쌓인 댓글 · 팩트체크 · 인구 통계를 토픽 단위로 집계한 리포트입니다. 개별 댓글 본문이나 사용자 식별 정보는 포함되지 않으며 (익명 집계) 연령대 · 성별 · 지역 · 키워드 · 판정 분포 · 찬반 센티먼트 · 시간별 참여 양상을 숫자로 제공합니다.

센티먼트는 AI 분류 결과이며 한국어 반어/비꼬기는 오분류 가능성이 있습니다.sentiment.coverage가 낮을수록 분류 완료되지 않은 댓글이 많으니 전체 여론의 대표성을 판단할 때 참고하세요.

GET /api/v1/topics/:id/opinion-report

토픽 ID는 홈페이지 토픽 URL의 마지막 숫자. 숨김 처리된 댓글은 집계에서 자동 제외됩니다.

요청 예시

curl https://api.facton.kr/api/v1/topics/123/opinion-report \
  -H "Authorization: Bearer fc_live_xxxxxxxxxxxxxxxx"

응답 예시 (일부)

{
  "topic": { "id": 123, "title": "...", "category": "정치", "date": "2026-04-18" },
  "engagement": {
    "totalComments": 842,
    "uniqueParticipants": 613,
    "totalLikes": 4210,
    "firstCommentAt": "2026-04-18T00:12:09Z",
    "lastCommentAt":  "2026-04-18T22:47:31Z"
  },
  "factcheck": {
    "coverage": 0.47,
    "verdicts": { "fact": 21, "false": 94, "insufficient": 12, "opinion": 263 }
  },
  "sentiment": {
    "coverage": 0.92,
    "counts": { "support": 210, "oppose": 430, "neutral": 134, "unclassified": 68 }
  },
  "demographics": {
    "ageBuckets": { "20s": 180, "30s": 260, "40s": 201, "50s+": 110, "unknown": 91 },
    "gender":     { "male": 412, "female": 369, "other": 8, "unknown": 53 },
    "regions": [
      { "country": "KR", "region": "Seoul",    "count": 287 },
      { "country": "KR", "region": "Gyeonggi", "count": 201 }
    ]
  },
  "timeline":  [{ "date": "2026-04-18", "comments": 842 }],
  "keywords":  [{ "token": "반도체", "count": 310 }, { "token": "특별법", "count": 198 }]
}

대상

언론사 · 뉴스룸 — 자사 기사 검증 자동화 + 특정 이슈에 대한 사회 여론 파악
여론조사기관 · 정책 리서치 — 전통 설문 비용 대비 실시간 · 지속 측정 데이터
국회 보좌진 · 정당 전략팀 — 입법 이슈에 대한 국민 반응 모니터링
대학 · 연구소 — 허위정보 확산 · 여론 형성 연구

인증

모든 요청에 Bearer API 키를 포함하세요. 키 하나로 두 엔드포인트 모두 사용 가능하며 월 호출 한도는 두 상품 통합으로 계산됩니다. 키 발급은 문의 후 운영자가 수동 발급합니다.

Authorization: Bearer fc_live_xxxxxxxxxxxxxxxx

verdict 값

fact 최신 정보 기준으로 사실로 확인됨
false 허위로 확인됨
insufficient 검증 가능하지만 근거가 부족함
undetermined 정보 부재로 판단 보류
opinion 주관적 의견으로 팩트체크 대상 아님

제한 & 쿼터

키별 월 호출 한도 (계약 시 결정) — factcheck + report 합산
전체 시스템 공용: Gemini 일일 상한 (시스템 보호용)
초과 시 429 Too Many Requests
월 리셋은 UTC 기준 매월 1일

프라이버시

리포트 응답은 집계된 숫자만. 개별 댓글 본문이나 작성자 정보는 노출되지 않습니다.
GeoIP 기반 지역 정보는 시·도(Region) 단위까지만 기록합니다.
사용자가 숨김 처리 또는 신고 후 조치된 댓글은 집계에서 자동 제외됩니다.

에러 코드

401: Authorization 헤더 누락 또는 잘못된/폐기된 키
400: 요청 파라미터 오류 (claim 누락/길이 초과, topic id 형식 등)
404: 존재하지 않는 토픽 id
429: 월 한도 초과 또는 시스템 rate limit
500: AI 응답 파싱 실패 등 내부 오류 — 재시도 권장

문의 · 가격 협의

API 키 발급, 커스텀 한도, 월 구독 요금은 GitHub Issues로 연락 주세요. 사용 용도(언론 · 연구 · 정책)와 예상 월 호출량을 알려주시면 제안서를 보내드립니다.

← FactOn 홈