ClaimReview API와 Google Fact Check Tools API

ClaimReview는 Google 검색, Bing, 그리고 공개 데이터 기반 팩트체크 생태계 전반에서 팩트체크 리치 결과를 구동하는 schema.org 타입입니다. Duke Reporters' Lab와 Google News Initiative가 개발했으며, AFP, Snopes, PolitiFact가 발행한 팩트체크를 수집 서비스(예: FAXTR)와 검색 엔진이 다시 노출할 수 있게 해주는 단일 데이터 규약입니다.

이 가이드는 세 가지 층위를 다룹니다: (1) 발행사로서 ClaimReview를 내보내기, (2) 소비자로서 Google Fact Check Tools API 조회하기, (3) 곧 공개될 FAXTR API가 그 위에 더하는 것.

1. ClaimReview 구조화 데이터 (발행사)

팩트체크를 발행한다면, 각 팩트체크 페이지에 ClaimReview JSON-LD를 삽입하면 Google의 Fact Check 리치 결과 대상이 되고 Fact Check Explorer에 노출됩니다. 최소 필수 필드는 claimReviewed, reviewRating, url 및 author입니다.

{
  "@context": "https://schema.org",
  "@type": "ClaimReview",
  "datePublished": "2026-05-20",
  "url": "https://example.org/fact-check/iran-strike-claim",
  "claimReviewed": "Iran officially declared war on Israel on May 19, 2026.",
  "itemReviewed": {
    "@type": "Claim",
    "appearance": "https://example.com/social-post/12345",
    "firstAppearance": {
      "@type": "CreativeWork",
      "url": "https://x.com/example/status/12345",
      "datePublished": "2026-05-19"
    },
    "author": { "@type": "Person", "name": "@example_account" }
  },
  "author": {
    "@type": "Organization",
    "name": "Example Fact Check",
    "url": "https://example.org"
  },
  "reviewRating": {
    "@type": "Rating",
    "ratingValue": 1,
    "bestRating": 5,
    "worstRating": 1,
    "alternateName": "False"
  }
}

배포 전에 Google Rich Results Test로 마크업을 검증하세요. Duke Reporters' Lab는 양식을 입력하면 규격에 맞는 JSON-LD를 생성해주는 Schema.org ClaimReview Generator도 운영합니다.

2. Google Fact Check Tools API (소비자)

Google Fact Check Tools API는 Fact Check Explorer를 구동하는 것과 동일한 데이터셋을 제공합니다. 무료이며, Google Cloud Console에서 발급받은 API 키가 필요하고, 언어 필터링과 함께 주장 단위 검색을 지원합니다.

# Search the Fact Check Tools API for a claim
# Docs: https://developers.google.com/fact-check/tools/api

curl -G 'https://factchecktools.googleapis.com/v1alpha1/claims:search' \
  --data-urlencode 'query=Iran war declaration' \
  --data-urlencode 'languageCode=en' \
  --data-urlencode 'key=YOUR_API_KEY'

각 결과에는 원 발행사, 주장 텍스트, 평가 등급, 그리고 출처 페이지로 돌아가는 링크가 담깁니다. 이 데이터셋은 전 세계를 아우르지만 영어와 스페인어가 주를 이루며, 한국어·일본어·아랍어 커버리지는 상대적으로 얇습니다. 이것이 FAXTR가 지역 팩트체크 기관 피드로 이를 보강하는 이유 중 하나입니다.

3. ClaimReview Project

ClaimReview Project(Duke Reporters' Lab + Google News Initiative)는 공개 ClaimReview 말뭉치를 관리하고, ClaimReview Schema Generator와 검증 도구를 비롯한 무료 도구를 발행사에 제공합니다. 팩트체크 매체를 만들고 있다면, 직접 내보내기 도구를 작성하기 전에 여기서 시작하세요.

4. FAXTR API (미리보기)

FAXTR의 API는 비공개 베타 단계입니다. 50개국 이상 100개 이상 기관의 ClaimReview 출력을 수집하고, 여기에 AI 생성 탐지와 원출처 링크를 결합합니다 — 그래서 한 번의 요청으로 "이 주장은 이미 검증되었는가?"와 "이 주장은 AI가 생성했을 가능성이 있는가?"를 모두 반환합니다.

# FAXTR API (preview — beta access)
# Endpoint: https://api.faxtr.com/v1/check

curl -X POST 'https://api.faxtr.com/v1/check' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "claim": "Iran officially declared war on Israel",
    "language": "en"
  }'

# Response: aggregated ClaimReview results from 100+ orgs
# plus an AI-detection score and primary source links.

승인된 베타 신청자는 비즈니스 등급을 무료로 이용할 수 있습니다. 활용 사례로는 LLM 가드레일(환각으로 생성된 주장이 사용자에게 가기 전에 걸러내기), 편집 워크플로(의심스러운 주장 자동 표시), 소셜/UGC 플랫폼(사용자 게시물 옆에 팩트체크 맥락 노출) 등이 있습니다.