팩트체크 API · 시작하기

기사 초안의 사실 오류를 출고 전에 찾습니다

초안의 사실 주장을 출고 예정 시각의 사실과 맞춰 보고, 다르면 올바른 값과 근거를 돌려줍니다.

무엇을 하나요

  • “현 대통령인 윤석열은 …” 같은 직함을 기준일의 재직자와 맞춰 봅니다.
  • 대수·사건 날짜·국경일·국회 대수·기관과 정당 이름을 확인합니다.
  • 판정마다 correct(올바른 값)와 evidence(근거)가 붙습니다.
  • 필요하면 값 단위로 웹 자료와 맞춰 볼 수 있습니다(웹에서 더 확인).

무엇을 확인하고 무엇을 아직 못 하는지는 확인하는 것과 못 하는 것에 정리했습니다.

기본 주소는 https://api.neta-ai.com/fact-check/v1 입니다. 키마다 하루 1,000건(한국 시간 자정 초기화)·분당 30건까지 쓸 수 있습니다.

STEP 1

API 키 받기

키 받기에서 받습니다. 키 원문은 한 번만 보이니 바로 환경 변수에 넣으세요.

POSThttps://api.neta-ai.com/fact-check/v1/keys

예시는 모두 키를 환경 변수 FC_KEY에서 읽습니다.

export FC_KEY="fck_…"
키 발급
curl -X POST 'https://api.neta-ai.com/fact-check/v1/keys'

STEP 2

첫 요청 보내기

본문 text와 기준일 as_of(출고 예정 시각)를 보냅니다. 키는 X-API-Key 머리로 보냅니다.

POSThttps://api.neta-ai.com/fact-check/v1/check

6,000자가 넘는 초안

/check는 6,000자까지입니다. 더 긴 초안은 스트림(20,000자까지)으로 보내세요.
POST /check
curl -X POST 'https://api.neta-ai.com/fact-check/v1/check' \
  -H "X-API-Key: $FC_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "尹 대통령, 오늘 담화",
  "text": "현 대통령인 윤석열은 13일 대국민 담화를 냈다. 제19대 대통령 윤석열은 2022년 5월 취임했다.",
  "as_of": "2026-11-13T15:00:00+09:00"
}'

STEP 3

결과 읽기

claims는 뽑은 주장 모두, verdicts는 띄울 판정만 담습니다. claim_id로 잇고, start·end(문장 안 위치)로 밑줄을 그으세요.

verdict뜻할 일
refuted 틀림공식 기록과 다릅니다. correct에 올바른 값이 옵니다.고치기
recommend-check 확인 권장다르게 보이지만 확정하지는 못했습니다. correct에 그래 보이는 값이 옵니다.확인
style 표기 권고사실 오류가 아니라 표기 문제입니다(예: 전직자에 '전'이 빠짐).매체 표기 규칙대로
source-check 출처 확인 필요인용한 보고서·조사·발표를 공개 자료에서 찾지 못했습니다.출처 확인
new-change 신규 변동 가능공식 확정 전 기록만 있습니다(최근 인사·변동).최신 소식 확인

구절·제목·URL은 평문이니 이스케이프해서 그리세요. 자세한 것은 판정 값, 근거.

curl -X POST 'https://api.neta-ai.com/fact-check/v1/check' \
  -H "X-API-Key: $FC_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "尹 대통령, 오늘 담화",
  "text": "현 대통령인 윤석열은 13일 대국민 담화를 냈다. 제19대 대통령 윤석열은 2022년 5월 취임했다.",
  "as_of": "2026-11-13T15:00:00+09:00"
}'
응답(줄임)
{
  "claims": [
    {"id": "s2c1", "sentence_id": "s2", "kind": "holder_at",
     "text": "현 대통령인 윤석열", "start": 0, "end": 10, "at_text": null}
  ],
  "verdicts": [
    {"claim_id": "s2c1", "verdict": "refuted",
     "correct": "이재명 제21대 대통령", "issue": "현직자",
     "evidence": [{"kind": "tenure", "person": "이재명", "ordinal": 21,
                   "start": "2025-06-04", "status": "confirmed",
                   "sources": [{"title": "대통령기록관", "tier": "tier-1",
                                "url": "https://www.pa.go.kr/"}]}],
     "confidence": {"level": "보통"}},
    …
  ],
  "verdict_counts": {"refuted": 2},
  "request_id": "9f2c1a7be04d3c55"
}

다음으로