API ClaimReview et API Google Fact Check Tools

ClaimReview est le type schema.org qui alimente les résultats enrichis de vérification des faits dans Google Search, Bing et dans l'ensemble de l'écosystème ouvert de vérification des faits. Il a été développé par le Duke Reporters' Lab et la Google News Initiative, et c'est le contrat de données unique qui permet à une vérification publiée par l'AFP, Snopes ou PolitiFact d'être reprise par des agrégateurs (comme FAXTR) et des moteurs de recherche.

Ce guide couvre trois niveaux : (1) l'émission de ClaimReview en tant qu'éditeur, (2) l'interrogation de l'API Google Fact Check Tools en tant que consommateur, et (3) ce que la future API FAXTR viendra ajouter par-dessus.

1. Données structurées ClaimReview (éditeurs)

Si vous publiez des vérifications de faits, intégrer du JSON-LD ClaimReview sur chaque page de vérification les rend éligibles au résultat enrichi de vérification des faits de Google et les fait apparaître dans le Fact Check Explorer. Les champs minimaux requis sont claimReviewed, reviewRating, url et 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"
  }
}

Validez le balisage avec le test des résultats enrichis de Google avant le déploiement. Le Duke Reporters' Lab maintient également un générateur ClaimReview Schema.org qui produit du JSON-LD conforme à partir d'un formulaire.

2. API Google Fact Check Tools (consommateurs)

L'API Google Fact Check Tools expose le même jeu de données qui alimente le Fact Check Explorer. Elle est gratuite, nécessite une clé d'API de la Google Cloud Console et prend en charge la recherche par affirmation avec filtrage par langue.

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

Chaque résultat renvoie l'éditeur d'origine, le texte de l'affirmation, l'évaluation et un lien vers la page source. Le jeu de données est mondial mais dominé par l'anglais et l'espagnol ; la couverture du coréen, du japonais et de l'arabe est plus limitée, ce qui est l'une des raisons pour lesquelles FAXTR le complète avec des flux de vérificateurs de faits régionaux.

3. Le ClaimReview Project

Le ClaimReview Project (Duke Reporters' Lab + Google News Initiative) maintient le corpus ouvert ClaimReview et propose des outils gratuits pour les éditeurs — dont le ClaimReview Schema Generator et des validateurs. Si vous construisez une publication de vérification des faits, commencez par là avant d'écrire votre propre émetteur.

4. API FAXTR (aperçu)

L'API de FAXTR est en bêta privée. Elle agrège la production ClaimReview de plus de 100 organisations dans plus de 50 pays et la combine avec la détection de génération par IA et des liens vers les sources primaires — de sorte qu'une seule requête renvoie à la fois « cette affirmation a-t-elle déjà été vérifiée ? » et « cette affirmation est-elle plausiblement générée par 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.

Les candidats approuvés à la bêta bénéficient d'un accès gratuit au niveau Business. Les cas d'usage incluent les garde-fous pour LLM (filtrer les affirmations hallucinées avant qu'elles n'atteignent les utilisateurs), les flux de travail éditoriaux (signaler automatiquement les affirmations suspectes) et les plateformes sociales / de contenu généré par les utilisateurs (afficher le contexte de vérification à côté des publications des utilisateurs).