Données ouvertes Poligraph

Les trois exemples ci-dessous récupèrent les 260 affaires judiciaires publiées. Pour un usage pédagogique ou statistique, commencez par les exports CSV : ils contiennent tout en un seul fichier, correctement paginé, avec le poligraphId comme clé de jointure stable.

import requests
import pandas as pd

# Option 1: télécharger l'export CSV complet (recommandé pour l'analyse)
df = pd.read_csv("https://poligraph.fr/api/export/affaires?limit=10000")
print(df.shape, df["severityCode"].value_counts())

# Option 2: pagination de l'API JSON (10 000 max par page)
rows, page = [], 1
while True:
    r = requests.get(
        "https://poligraph.fr/api/affaires",
        params={"limit": 100, "page": page, "involvement": "DIRECT,MENTIONED_ONLY"},
        timeout=30,
    ).json()
    rows.extend(r["data"])
    if page >= r["pagination"]["totalPages"]:
        break
    page += 1

print(f"Total: {len(rows)} affaires")

Fichiers UTF-8 avec BOM (compatibles Excel et pandas), toutes les colonnes dénormalisées, jusqu'à 50 000 lignes par requête. Les descriptions sont nettoyées du markdown. Chaque ligne contient un poligraphId stable (voir ci-dessous) pour joindre plusieurs tables sans ambiguïté.

Toutes les routes JSON paginent à 20 résultats par défaut, avec un maximum de 100 par page. La réponse contient toujours un objet pagination pour savoir quand arrêter la boucle :

{
  "data": [ /* ... */ ],
  "pagination": {
    "page": 1,
    "limit": 100,
    "total": 260,
    "totalPages": 3
  }
}

Pour les volumes importants (plus de quelques centaines de lignes), préférez les exports CSV ci-dessus : une seule requête au lieu de N, et Cache-Control optimisé côté serveur.

Chaque entité citable reçoit un identifiant opaque, court et immuable que vous pouvez utiliser dans un article scientifique, un notebook, un export CSV ou un lien entrant. Contrairement aux slugs (qui peuvent changer si un titre est corrigé ou un nom mis à jour), le poligraphId est garanti stable dans le temps.

Format : XX-000542 (deux lettres, tiret, entier sur 6 chiffres minimum). Tout poligraphId est résoluble via un redirect 308 permanent qui suit les fusions d'affaires, pour que vos citations externes ne cassent jamais :

# URL canonique citable dans un article
https://poligraph.fr/id/AF-000042

# Exemple d'une jointure côté pandas
affaires = pd.read_csv("https://poligraph.fr/api/export/affaires?limit=10000")
politiques = pd.read_csv("https://poligraph.fr/api/export/politiques")
join = affaires.merge(
    politiques,
    left_on="politicianPoligraphId",
    right_on="poligraphId",
    suffixes=("_affaire", "_pol"),
)

Dictionnaire des données

Les colonnes XxxCode des exports CSV contiennent les valeurs brutes des énumérations ci-dessous (stables et filtrables), tandis que les colonnes sans suffixe contiennent la traduction française lisible.

• Présomption d'innocence. Les affaires en cours sont signalées avec un niveau d'implication conservateur par défaut. Filtrez par statusCode=CONDAMNATION_DEFINITIVE si vous voulez isoler les condamnations définitives.
• Gravité Sapin II. La colonne severity classe les infractions selon la spécificité au mandat (probité > infractions graves > autres), pas selon un jugement moral.
• Implication par défaut. Les routes JSON filtrent par défaut sur involvement=DIRECT. Passez involvement=DIRECT,MENTIONED_ONLY,SUSPECTED pour élargir.
• Sources vérifiées. Chaque affaire publiée a au moins une source journalistique vérifiable. La colonne sourceCount donne le nombre total, sourceUrl la première.

Méthodologie complète : /sources

Licence et citation

Les données publiées sont réutilisables pour des usages pédagogiques, journalistiques et de recherche avec citation de la source. Format recommandé pour un article ou un rapport :

Poligraph, observatoire civique des politiques français, poligraph.fr, consulté le 13/04/2026.

Pour signaler une erreur ou demander l'exercice d'un droit (correction, opposition) : nous contacter.

Explorateur Swagger complet

Spécification OpenAPI interactive : testez chaque route directement depuis le navigateur, voyez les paramètres et les schémas de réponse.