Données à jour au 6 juillet 2026
API

Construire avec MonÉlu

L'API

MonÉlu expose l'intégralité des votes et des fiches de députés via une API REST publique. La documentation interactive (OpenAPI/Swagger) liste tous les endpoints, leurs paramètres et leurs schémas de réponse :

https://monelu-production.up.railway.app/docs

Limites de débit

Toute requête anonyme partage un même quota par adresse IP :

  • 30 requêtes / minute sur la plupart des endpoints (listes, fiches, votes).
  • 10 requêtes / minute sur les endpoints coûteux (scorecards, alignement, recherche sémantique).

Une clé d'API donne un quota individuel plus élevé sur ces mêmes limites (multiple de la limite anonyme selon la clé) - utile si vous scrapez le jeu de données complet ou intégrez MonÉlu dans un produit. Le comportement anonyme reste inchangé.

Obtenir une clé

Les clés sont émises manuellement pour l'instant - pas d'inscription en libre-service. Écrivez à walidelkhoukh99@gmail.com en précisant votre usage prévu (recherche, rédaction, produit) et le volume de requêtes attendu.

Une fois la clé reçue, passez-la dans l'en-tête X-API-Key de chaque requête :

curl -H "X-API-Key: votre_cle" https://monelu-production.up.railway.app/deputes/

Suivre votre usage

Chaque clé peut consulter son propre historique de requêtes des 30 derniers jours, par endpoint et par jour :

curl -H "X-API-Key: votre_cle" https://monelu-production.up.railway.app/keys/usage

Licence des données

Les données servies par l'API sont publiées sous la Licence Ouverte / Open Licence 2.0 (« Etalab 2.0 ») - réutilisation libre, y compris commerciale, sous réserve d'attribution. Détails complets sur la page Licence des données.