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. Chaque endpoint est décrit avec ses paramètres, ses schémas de réponse, un exemple de charge utile et les mises en garde méthodologiques qui s'y appliquent :
- https://monelu-production.up.railway.app/openapi.json - la spécification OpenAPI brute. C'est le format à donner à un agent, à un client généré, ou à un pont MCP.
- https://monelu-production.up.railway.app/docs - la même spécification, en documentation interactive (Swagger UI), pour explorer à la main.
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. Faites-en la demande via la page contact, 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 :
Suivre votre usage
Chaque clé peut consulter son propre historique de requêtes des 30 derniers jours, par endpoint et par jour :
Intégrer un vote (oEmbed)
Chaque page de scrutin expose un encart embarquable et déclare un point d'accès oEmbed. Sur Notion, Slack, Substack, Ghost, WordPress ou Discourse, coller l'URL de la page suffit : l'encart s'affiche à la place du lien.
Pour les intégrations sur mesure, le point d'accès répond directement :
La réponse est une charge utile oEmbed rich standard (version, type, title, width, height, html). Les paramètres maxwidth et maxheight sont pris en compte, format n'accepte que json (le XML renvoie 501). Une URL qui ne désigne pas un scrutin de MonÉlu renvoie 404. Le bouton « Intégrer » d'une page de scrutin donne le même encart sous forme d'<iframe> à copier, pour les plateformes qui ne parlent pas oEmbed.
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.