Isoloir 2027
Documentation

L'API d'Isoloir 2027

Les données du baromètre avec leur historique : sondages de premier tour, abonnés des comptes officiels des candidats, consultations de leurs articles Wikipédia, leurs publications et l'état de la collecte. En lecture seule, en JSON ou en CSV, mises à jour chaque heure.

Mis à jour le 10 novembre 2026

Démarrer en une minute

Tous les points d'accès répondent à une simple requête GET, sans corps ni paramètre obligatoire. Essayez la liste des candidats, qui donne les identifiants (slug) utilisés partout ailleurs :

curl
curl "https://isoloir2027.fr/api/v1/candidats"

Puis l'historique d'une mesure pour un candidat, par exemple ses abonnés depuis le début du mois, en CSV pour un tableur :

curl
curl "https://isoloir2027.fr/api/v1/abonnes?candidat=marine-tondelier&depuis=2026-11-01&format=csv" -o abonnes.csv

Aujourd'hui, ces appels marchent sans clé, dans la limite de 10 par minute et 60 par heure par adresse IP. Cet accès sans clé est transitoire : il prend fin le 1er février 2027, à condition que l'inscription soit ouverte. Une clé gratuite donne des quotas plus larges (60 par minute et 5 000 par jour) : voir authentification.

Forme des réponses

Une réponse JSON réussie contient deux objets. meta décrit la réponse : le point d'accès, la version, l'heure de génération (UTC), la licence et l'attribution à reprendre, la source des chiffres et, selon le cas, un avertissement sur ce qu'ils ne disent pas. data contient les données. Une erreur ne contient qu'un objet error, décrit sur la page erreurs.

  • Dates : les horodatages sont en UTC au format ISO 8601 (2026-11-10T05:34:23.029Z) ; les jours (AAAA-MM-JJ) sont des jours de Paris.
  • Noms de champs en français, comme dans les fichiers de la page données ouvertes, sauf pour les signaux et la data du jour.
  • CSV : ?format=csv sur /sondages, /abonnes et /wikipedia. Encodage UTF-8 avec BOM, pour qu'un tableur affiche bien les accents.
  • Pagination : seul /publications est paginé, par un curseur de date (meta.suivant).
  • Cache : les réponses portent Cache-Control: public, max-age=300. Rappeler le même point d'accès plus souvent que toutes les cinq minutes n'apporte rien de neuf.
  • CORS ouvert : l'API s'appelle depuis le navigateur, depuis n'importe quel site. Ne mettez pas de clé dans du code servi aux visiteurs.

Les points d'accès

La racine /api/v1 renvoie elle-même la liste des points d'accès et des formats. La version 1 restera en service si une version 2 voit le jour : un changement qui casse les clients passe par une nouvelle version, annoncée sur la page changements.

Réponse 200
{
  "meta": {
    "endpoint": "/api/v1/",
    "version": "v1",
    "generatedAt": "2026-11-10T19:19:58.111Z",
    "licence": {
      "name": "Creative Commons Attribution 4.0 (CC BY 4.0)",
      "url": "https://creativecommons.org/licenses/by/4.0/deed.fr",
      "attribution": "Isoloir 2027 (isoloir2027.fr)"
    },
    "docs": "https://isoloir2027.fr/donnees-ouvertes/api"
  },
  "data": {
    "description": "API en lecture des données d'Isoloir 2027 : sondages, audience des comptes officiels, consultations Wikipédia, publications des candidats.",
    "endpoints": {
      "/api/v1/candidats": "Candidats suivis, statut, comptes officiels vérifiés et preuve de chaque compte.",
      "/api/v1/barometre": "Dernier relevé de toutes les mesures, candidat par candidat (sans note globale).",
      "/api/v1/sondages": "Sondages de premier tour (hypothèse principale) et moyenne sur 30 jours.",
      "/api/v1/abonnes?candidat=&reseau=&depuis=&jusqua=": "Abonnés des comptes officiels, un relevé par compte et par jour.",
      "/api/v1/wikipedia?candidat=&depuis=&jusqua=": "Consultations quotidiennes des articles Wikipédia en français.",
      "/api/v1/publications?candidat=&reseau=&depuis=&avant=&limite=": "Publications des comptes officiels (Bluesky, Telegram, Mastodon, YouTube).",
      "/api/v1/signaux": "Mouvements notables détectés par des règles fixes, avec chiffre, source et limites.",
      "/api/v1/etat": "État de la collecte : dernier passage et erreurs de chaque relevé."
    },
    "formats": "JSON par défaut ; ?format=csv sur sondages, abonnes et wikipedia.",
    "dates": "Horodatages en UTC (ISO 8601) ; jours (AAAA-MM-JJ) en heure de Paris."
  }
}
Réponse réelle de l'API en production, le 10 novembre 2026 à 20 h 19 (heure de Paris), à la requête /api/v1. textes de plus de 160 caractères abrégés par « … ».

Spécification OpenAPI

Le contrat complet (paramètres, schémas des réponses, erreurs, en-têtes de limite) est décrit au format OpenAPI 3.1, à importer dans Postman, Insomnia, Bruno ou un générateur de client : /api/openapi.json.

Bon usage des données

Ces mesures décrivent une audience, une curiosité et des intentions de vote déclarées. Aucune n'est une prévision, et Isoloir ne les additionne jamais en une note globale. Gardez les avertissements de meta quand vous republiez un chiffre, citez la source (licences et attribution) et ne présentez pas ces données comme officielles : Isoloir 2027 est un site indépendant : il n'est lié à aucun parti, candidat, élu ou institut de sondage. La façon dont chaque mesure est relevée est décrite dans la méthode du baromètre.

Les fichiers des positions et des programmes, qui ne passent pas par l'API, se téléchargent sur la page données ouvertes, comme les trois tableaux des chiffres clés (candidats avec date de naissance sourcée, positions par thème, sondages), en CSV et en JSON, chacun avec sa licence et la mention « Source : Isoloir 2027 ». Une question, un besoin particulier : contact@isoloir2027.fr.