API publique REST

Intégrez OpenProvena dans vos applications

Base URL

https://api.openprovena.org

GET/v1/trust

Analyze a domain and return its Trust Score with per-signal breakdown.

Paramètre	Requis	Description
domain	✓	Paramètre : domain (ex: lemonde.fr)
explain	—	Include signal breakdown (default: true)
force_refresh	—	Bypass Redis cache (default: false)

# Exemple

curl "https://api.openprovena.org/v1/trust?domain=lemonde.fr&explain=true" \
  -H "Authorization: Bearer YOUR_TOKEN"

// Réponse JSON

{
  "domain": "lemonde.fr",
  "trust_score": 78.4,
  "confidence": 0.91,
  "tier": "HIGH",
  "signals": [ … ],
  "cached": false
}

GET/v1/trust/batch

Analyze up to 20 domains in parallel.

Paramètre	Requis	Description
domains	✓	Comma-separated list (max 20)

# Exemple

curl "https://api.openprovena.org/v1/trust/batch?domains=lemonde.fr,rt.com"

// Réponse JSON

{ "results": [ … ], "count": 2 }

GET/v1/narratives

List active disinformation narratives.

Paramètre	Requis	Description
velocity	—	fast \| moderate \| slow
trend	—	rising \| stable \| declining

# Exemple

curl "https://api.openprovena.org/v1/narratives?velocity=fast"

// Réponse JSON

{ "items": [ … ], "meta": { "total": 3 } }

Authentification

Deux méthodes : Bearer JWT (utilisateurs enregistrés) ou header X-API-Key.

Authorization: Bearer eyJhbGci…
X-API-Key: opk_xxxxxxxxxxxxx