API publique VigiCité
Accédez aux données croisées des élus, marchés publics et déclarations HATVP en JSON. Conçue pour le data journalism et les projets citoyens.
Endpoints disponibles
Commencez par /cas-qualifies — tableau filtré des croisements signal fort : élus dirigeants d'entités privées avec marchés publics dans leur territoire.
Export JSON : /api/v2/cas-qualifies?min_score=80&format=json ·
CSV : ?format=csv · Filtre dpt : &departement=XX
v2 — Recommandée stable
| Méthode | Endpoint | Description |
|---|---|---|
| GET | /api/v2/cas-qualifies |
Croisements filtrés (score ≥ 60). Params : min_score, departement, format=json|csv |
| GET | /api/v2/elu/{id}/narrative | Résumé narratif d'un élu (faits + sources) |
| GET | /api/v2/departement/{code}/resume | Résumé départemental enrichi |
| GET | /api/v2/croisements/top | Top croisements par montant brut. Params : limit, departement |
| GET | /api/v2/search?q=... | Recherche unifiée élus + entreprises |
v1 — Légacy stable
| Méthode | Endpoint | Description |
|---|---|---|
| GET | /api/v1/elus | Liste paginée des élus avec score composite |
| GET | /api/v1/elus/{id} | Fiche complète d'un élu (scores, déclarations, relations) |
| GET | /api/v1/elus/{id}/scores | Scores détaillés par dimension |
| GET | /api/v1/entreprises/{siren} | Profil entreprise (marchés, élus déclarants) |
| GET | /api/v1/search?q=... | Recherche multi-entités (élus + entreprises) |
| GET | /api/v1/stats | Compteurs globaux de la base |
| GET | /api/v1/health | Health check avec métriques |
Bulk bulk
| Méthode | Endpoint | Description |
|---|---|---|
| GET | /api/v1/elus/bulk?ids=1,2,3 | Fiches complètes de plusieurs élus (max 50) |
| GET | /api/v1/departement/{code}/elus | Tous les élus d'un département, paginé |
Graphes stable
| Méthode | Endpoint | Description |
|---|---|---|
| GET | /api/elus/{id}/graphe.json | Graphe de relations d'un élu (D3.js ready) |
| GET | /api/departements/{code}/graphe.json | Graphe départemental multi-élu |
Exports stable
| Méthode | Endpoint | Description |
|---|---|---|
| GET | /api/elus/{id}/export.json | Export JSON complet d'un élu |
| GET | /api/elus/{id}/export.csv | Export CSV d'un élu |
| GET | /api/export/dataset.json | Dataset anonymisé complet |
Exemples
Rechercher un élu :
Fiche complète d'un élu :
Récupérer plusieurs élus en bulk :
Avec clé API (rate limit élevé) :
Rate limiting
Anonyme
Suffisant pour la navigation et les recherches ponctuelles.
Avec clé API
Pour le scraping responsable et le data journalism.
Envoyez un email à api@vigicite.org pour obtenir une clé.
Les headers X-RateLimit-Limit, X-RateLimit-Remaining et
X-RateLimit-Reset sont inclus dans chaque réponse.
Documentation interactive
Principes
- Uniquement des données issues de sources publiques légales
- Scores de cohérence factuels, pas de jugements
- Méthodologie transparente et reproductible
- Licence AGPL-3.0 (open source, copyleft fort)
- Pas de tracking, pas de cookies, pas de données personnelles