API 레퍼런스 · 사실 조회

기준일의 사실

GEThttps://api.neta-ai.com/fact-check/v1/facts

기준일의 공개 사실을 조회합니다. post(직위) · person(사람) · org(기관·정당·기업·행정구역) · event(사건) 중 하나를 as_of 와 함께 보냅니다.

이름이 여러 개체에 맞으면 409와 candidates 가 옵니다. 그중 id 로 다시 물어 주세요. 날짜는 earliest·latest 쌍이고, 기간은 끝 날짜를 포함하지 않습니다. 하루 건수에 세지 않습니다.

요청 머리

이름타입설명
X-API-Key필수stringAPI 키. URL 쿼리·쿠키로는 받지 않습니다

쿼리 매개변수

이름타입설명
poststring직위 → 기준일 보유자(incumbents · uncertain). id 또는 이름(옛 이름 포함)
personstring사람 → 기준일 상태(held · uncertain · suspended · elect · former · deceased). event 와 같이 주면 그 사람의 사건
orgstring기관·정당·기업·행정구역 → 기준일 공식 명칭. event 와 같이 주면 그 기관의 사건
eventstring사건 유형(et-…) 또는 사건 id → 사건 날짜(events)
as_ofstring(YYYY-MM-DD)기준일. 비우면 오늘
include_candidatesboolean공식 확정 전 후보 기록(status: candidate)도 포함

응답

200질문에 따라 incumbents · held · official_name · events 등

이름타입설명
querystringpost · person · org · event
…[].status · verifiedstring · booleanconfirmed·candidate, 공식 출처로 확정됐는지
…[].sources[]arraytitle · url · tier · published_on
graph_updatedstring자료의 마지막 갱신 시각
응답 머리뜻
X-Daily-Limit하루 상한
X-Daily-Remaining오늘 남은 건수

오류

코드뜻
404맞는 개체가 없음
409이름이 여러 개체에 맞음. candidates 의 id 로 다시
401키가 없거나 틀림(폐기한 키 포함)
422요청 형식 오류(필드·길이·매개변수 조합). detail 에 위치
429하루 한도(1,000건) 또는 분당 한도(30) 초과. Retry-After(초)
503일시적으로 쓸 수 없음. Retry-After(초)