API ClaimReview e API Google Fact Check Tools

O ClaimReview é o tipo do schema.org que alimenta os resultados ricos de checagem de fatos no Google Search, no Bing e em todo o ecossistema de checagem de fatos de dados abertos. Foi desenvolvido pelo Duke Reporters' Lab e pela Google News Initiative, e é o único contrato de dados que permite que uma checagem publicada pela AFP, pela Snopes ou pela PolitiFact seja reexibida por agregadores (como a FAXTR) e por mecanismos de busca.

Este guia abrange três camadas: (1) emitir ClaimReview como publisher, (2) consultar a API Google Fact Check Tools como consumidor e (3) o que a futura API da FAXTR acrescentará a isso.

1. Dados estruturados do ClaimReview (publishers)

Se você publica checagens de fatos, incorporar o JSON-LD do ClaimReview em cada página de checagem as torna elegíveis para o resultado rico de checagem do Google e as exibe no Fact Check Explorer. Os campos mínimos obrigatórios são claimReviewed, reviewRating, url e 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"
  }
}

Valide a marcação com o Rich Results Test do Google antes de publicar. O Duke Reporters' Lab também mantém um Schema.org ClaimReview Generator que produz JSON-LD compatível a partir de um formulário.

2. API Google Fact Check Tools (consumidores)

A API Google Fact Check Tools expõe o mesmo conjunto de dados que alimenta o Fact Check Explorer. É gratuita, exige uma chave de API do Google Cloud Console e oferece suporte a busca por alegação com filtragem por idioma.

# 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'

Cada resultado retorna o publisher original, o texto da alegação, a classificação e um link de volta para a página de origem. O conjunto de dados é global, mas predominantemente em inglês e espanhol; a cobertura de coreano, japonês e árabe é mais limitada, e esse é um dos motivos pelos quais a FAXTR o complementa com feeds de checadores regionais.

3. O ClaimReview Project

O ClaimReview Project (Duke Reporters' Lab + Google News Initiative) mantém o corpus aberto do ClaimReview e oferece ferramentas gratuitas para publishers — incluindo o ClaimReview Schema Generator e validadores. Se você está criando uma publicação de checagem de fatos, comece por aí antes de escrever seu próprio emissor.

4. API da FAXTR (prévia)

A API da FAXTR está em beta privado. Ela agrega a saída de ClaimReview de mais de 100 organizações em mais de 50 países e a combina com detecção de geração por IA e links para fontes primárias — de modo que uma única requisição retorna tanto "esta alegação já foi verificada?" quanto "esta alegação foi plausivelmente gerada por IA?".

# 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.

Os candidatos aprovados ao beta recebem acesso gratuito ao nível Business. Os casos de uso incluem salvaguardas de LLM (filtrar alegações alucinadas antes que cheguem aos usuários), fluxos editoriais (sinalizar automaticamente alegações suspeitas) e plataformas sociais/UGC (exibir contexto de checagem de fatos ao lado das publicações dos usuários).