Checkwise Logo
API Checkwise

La vérification d'information, dans vos produits.

Vérifiez une affirmation, notez un site, détectez une image générée par IA. Chaque réponse porte ses sources, et le verdict est calculé à partir d'elles, pas décidé par un modèle de langage.

Déjà client ? Gérez vos clés depuis votre tableau de bord.

Fact-checking

Un verdict par affirmation, avec les sources retenues et leur fiabilité.

/v1/check

Notation de sites

La fiabilité d'un domaine, selon une méthodologie publique.

/v1/rate-site
Accès anticipé

Détection d'images IA

Image authentique ou générée, avec score, générateur et carte de chaleur.

/v1/image-analysis

Démarrer

Toutes les requêtes portent votre clé dans l'en-tête X-Checkwise-API-Key. L'en-tête Authorization: Bearer est aussi accepté.

URL de base https://developer.checkwise.ai

Pas encore de clé ? 

curl https://developer.checkwise.ai/v1/check \
  -H "X-Checkwise-API-Key: YOUR_API_KEY"
POST/v1/check

Vérifier une affirmation, un article ou une image

Envoyez du texte, l'URL d'un article ou une image encodée en base64. Les affirmations vérifiables sont extraites, les sources recherchées, puis un verdict est calculé par affirmation et pour l'ensemble.

Requête

curl -X POST https://developer.checkwise.ai/v1/check \
  -H "Content-Type: application/json" \
  -H "X-Checkwise-API-Key: YOUR_API_KEY" \
  -d '{
    "text": "Le SMIC en France a atteint 1766,92 euros brut par mois en janvier 2024"
  }'

Corps de la requête, un seul champ parmi :

  • text(string)l'affirmation ou le texte à vérifier.
  • url(string)l'adresse d'un article à vérifier.
  • image(string)une image encodée en base64 contenant une affirmation.

Réponse

{
  "ok": true,
  "report_code": "76W3FC",
  "global_verdict": "true",
  "global_confirmed": true,
  "global_verdict_level": "confirmed",
  "global_verdict_label": "Confirmed",
  "synthesis": "Les sources officielles confirment que le SMIC brut mensuel a été fixé à 1 766,92 € au 1er janvier 2024.",
  "claims": [
    {
      "id": "c1",
      "text": "Le SMIC en France a atteint 1766,92 euros brut par mois en janvier 2024",
      "category": "economic",
      "verdict": "true",
      "confirmed": true,
      "verdict_level": "confirmed",
      "verdict_label": "Confirmed",
      "sources_kept": [
        {
          "url": "https://www.service-public.fr/...",
          "organization": "Service-Public.fr",
          "summary": "Le SMIC brut mensuel a été fixé à 1 766,92 € au 1er janvier 2024.",
          "verdict": "true",
          "site_rating": "A",
          "biases": []
        },
        {
          "url": "https://www.insee.fr/...",
          "organization": "INSEE",
          "summary": "SMIC mensuel brut : 1 766,92 € au 1er janvier 2024.",
          "verdict": "true",
          "site_rating": "A",
          "biases": []
        },
        {
          "url": "https://www.legifrance.gouv.fr/...",
          "organization": "Légifrance",
          "summary": "Le décret n° 2023-1216 fixe le SMIC à 1 766,92 € brut mensuel.",
          "verdict": "true",
          "site_rating": "A",
          "biases": []
        }
      ]
    }
  ],
  "metadata": {
    "total_sources": 3,
    "input_type": "text",
    "credits_consumed": 1
  },
  "rate_limit": { "credits_total": "…", "credits_remaining": "…" }
}

Champs clés

  • claims[].verdictverdict par affirmation, calculé à partir du consensus des sources retenues : "true", "false", "mixed" ou "not_rated".
  • claims[].verdict_levelle niveau affiché sur checkwise.ai et dans l'extension : "confirmed" (toutes les sources confirment), "likely_true", "mixed", "refuted" ou "no_evidence", avec son libellé dans verdict_label.
  • global_verdictverdict d'ensemble, avec global_verdict_level et global_verdict_label sur la même échelle.
  • claims[].sources_keptsources retenues, chacune avec son verdict, son résumé et la lettre de fiabilité de son site (site_rating : "A" à "D", la même que sur checkwise.ai, ou "not_rated").
  • synthesisrésumé lisible de l'analyse.
  • report_codecode unique pour retrouver ou partager le rapport.
  • rate_limitcrédits totaux et restants de votre clé.

Le verdict est calculé à partir des sources. Il n'est pas décidé par un modèle de langage.

POST/v1/rate-site

Noter la fiabilité d'un site

Passez une URL complète ou un simple domaine, l'API normalise. Un domaine déjà évalué répond immédiatement ; un domaine inconnu déclenche une analyse complète, plus lente.

Besoin de la base en volume ?

La base des sites notés est disponible sous licence, sur devis, pour la brand safety, la recherche et la modération.

Requête

curl -X POST https://developer.checkwise.ai/v1/rate-site \
  -H "Content-Type: application/json" \
  -H "X-Checkwise-API-Key: YOUR_API_KEY" \
  -d '{
    "url": "https://www.lemonde.fr"
  }'

Corps de la requête :

  • url(string)n'importe quelle adresse du site ; le domaine est extrait.
  • domain(string)ou le domaine directement, par exemple "lemonde.fr".

Réponse

{
  "ok": true,
  "domain": "lemonde.fr",
  "name": "Le Monde",
  "letter": "A",
  "verdict": "Excellent reliability",
  "categories": ["general", "breaking_news", "politics", "society"],
  "country_code": "FR",
  "region": "Europe",
  "type": "media",
  "language": "fr",
  "last_updated": "…",
  "rate_limit": { "credits_total": "…", "credits_remaining": "…" }
}

Champs clés

  • letterlettre de fiabilité, de "A" à "D", la même que sur checkwise.ai, attribuée selon la méthodologie publique.
  • verdictlibellé de la lettre, par exemple "Excellent reliability".
  • categories, country_code, region, type, languagemétadonnées du site.

Le détail par critère n'est pas renvoyé pour l'instant : il dépendra du plan. Intéressé ? Dites-le-nous, c'est ce qui décide de la suite.

POST/v1/image-analysis

Détecter une image générée par IA

Déterminez si une image a été générée par une IA. L'analyse combine plusieurs détecteurs indépendants et renvoie un verdict, un score, le générateur identifié quand il l'est, une carte de chaleur et une explication.

Accès anticipé

Cet endpoint est ouvert sur inscription. Dites-nous votre volume d'images, nous activons l'accès sur votre clé.

Requête

curl -X POST https://developer.checkwise.ai/v1/image-analysis \
  -H "Content-Type: application/json" \
  -H "X-Checkwise-API-Key: YOUR_API_KEY" \
  -d '{
    "image": "<base64>"
  }'

Corps de la requête :

  • image(string)image encodée en base64 (JPEG, PNG, WebP).
  • url(string)adresse de l'image, utilisée si image est absent.

Réponse

{
  "ok": true,
  "verdict": "likely_ai",
  "ai_score": 62.2,
  "is_ai": true,
  "confidence": 62.2,
  "explanation": "…",
  "generator": "Stable Diffusion",
  "heatmap": "<base64>",
  "rate_limit": { "credits_total": "…", "credits_remaining": "…" }
}

Champs clés

  • verdictai_generated (très forte probabilité de génération par IA), likely_ai (forte probabilité), uncertain (non concluant), likely_real (probablement authentique), authentic (très probablement authentique).
  • ai_score(0–100)score de détection, de 0 (authentique) à 100 (générée).
  • is_aivrai pour les verdicts ai_generated et likely_ai.
  • generator, heatmap, explanationgénérateur identifié quand il l'est, carte des zones ayant pesé (base64), explication lisible.

Aucun détecteur n'est fiable à 100 %. Le résultat est un indice à croiser avec la provenance de l'image.

Codes de réponse

L'API utilise les codes HTTP standards.

  • 200succès, le corps contient le résultat.
  • 400requête incomplète ou mal formée.
  • 401clé absente ou invalide.
  • 402crédits épuisés pour cette clé.
  • 404domaine inconnu et non évaluable (notation de site).
  • 500erreur interne.
  • 502service de vérification momentanément indisponible, réessayez.

Format d'une erreur

{
  "ok": false,
  "error": "VALIDATION_ERROR",
  "message": "Provide \"text\", \"url\" or \"image\" field"
}

Limites et plans

Les limites, le détail par critère et les engagements de service dépendent de votre plan ; vos crédits sont visibles dans votre tableau de bord et dans rate_limit de chaque réponse. Un besoin précis ? Manifestez votre intérêt, nous revenons vers vous.

Spécification OpenAPI

La spécification publique, au format OpenAPI 3.1, couvre les endpoints publics, les schémas de réponse et les deux modes d'authentification. Chargez-la dans Postman, un générateur de client, ou donnez-la à un agent.

https://checkwise.ai/openapi.json

Connecté à votre compte, vous accédez à la spécification complète : /api/account/openapi.json

Pour les organisations

Un volume à cadrer, une intégration à préparer, des questions sur l'hébergement : vingt minutes suffisent pour en parler sur vos propres contenus.