Isoloir 2027
Point d'accès

Abonnés des comptes officiels

L'historique des abonnés de chaque compte officiel vérifié, relevé par Isoloir plusieurs fois par jour.

Mis à jour le 10 novembre 2026

GEThttps://isoloir2027.fr/api/v1/abonnes

Mise à jour : Toutes les 6 heures environ, par compte. Formats : JSON, CSV (?format=csv).

Ce que contiennent les données

Une ligne par relevé : le candidat, le réseau, l'identifiant du compte, l'heure exacte du relevé et le nombre d'abonnés. Les lignes les plus anciennes peuvent venir de captures de la Wayback Machine (Internet Archive) : leur champ archive donne l'adresse de la capture qui fait foi.

Combinez candidat, reseau, depuis et jusqua pour réduire la réponse ; sans filtre, elle contient tout l'historique de tous les comptes.

Comment elles sont collectées

Chaque compte est lu toutes les 6 heures environ sur sa page publique ou par une interface publique : FxEmbed pour X, la page du profil pour TikTok et YouTube, le module de page officiel de Facebook, les API publiques de Bluesky et de Mastodon, la page publique des chaînes Telegram. Chaque relevé a une clé (compte, jour et heure de Paris) : relancer la collecte n'ajoute pas de doublon.

Limites à connaître

  • Une audience n'est ni un soutien ni une intention de vote : on peut suivre un compte pour le critiquer.
  • YouTube arrondit à trois chiffres (arrondi: true). Facebook ne donne rien pour les profils personnels ni pour certaines Pages, et Instagram n'est pas lu du tout.
  • Le relevé de X dépend d'un service tiers qui ne répond pas toujours : un trou de quelques heures se comble au passage suivant.

Paramètres

NomTypeValeursRôle
candidatfacultatifstringun slug de /api/v1/candidatsLimite la réponse à un candidat. Un slug inconnu renvoie 404 not_found.
reseaufacultatifstringx, tiktok, youtube, facebook, bluesky, telegram, mastodonLimite la réponse à un réseau.
depuisfacultatifdateAAAA-MM-JJPremier jour inclus (heure de Paris).
jusquafacultatifdateAAAA-MM-JJDernier jour inclus (heure de Paris).
formatfacultatifstringcsvRenvoie un fichier CSV (UTF-8 avec BOM, séparateur virgule) au lieu du JSON.

Requête

curl "https://isoloir2027.fr/api/v1/abonnes?candidat=marine-tondelier&jusqua=2026-11-10" \
  -H "Authorization: Bearer $ISOLOIR_API_KEY"

Réponse

Comme tous les points d'accès, la réponse JSON contient meta (point d'accès, date de génération, licence, source, avertissement) et data. Champs de data :

ChampTypeContenu
slug, reseau, identifiantstringLe candidat, le réseau et le compte.
horodatagestring (date-time)Heure du relevé, en UTC.
abonnesintegerNombre d'abonnés lu.
arrondibooleanVrai si la plateforme arrondit le chiffre.
archivestring | nullCapture de la Wayback Machine dont vient le chiffre, sinon null.
Réponse 200
{
  "meta": {
    "endpoint": "/api/v1/abonnes",
    "version": "v1",
    "generatedAt": "2026-11-10T19:20:26.649Z",
    "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",
    "source": "Relevés quotidiens d'Isoloir sur les comptes officiels vérifiés (liste et preuves : /api/v1/candidats).",
    "avertissement": "Une audience n'est ni un soutien ni une intention de vote. YouTube arrondit ses chiffres à trois chiffres (arrondi = true).",
    "premierReleve": "2026-11-10",
    "dernierReleve": "2026-11-10"
  },
  "data": [
    {
      "slug": "marine-tondelier",
      "reseau": "x",
      "identifiant": "marinetondelier",
      "horodatage": "2026-11-10T01:14:38.519Z",
      "abonnes": 138972,
      "arrondi": false,
      "archive": null
    },
    {
      "slug": "marine-tondelier",
      "reseau": "x",
      "identifiant": "marinetondelier",
      "horodatage": "2026-11-10T05:35:27.706Z",
      "abonnes": 138978,
      "arrondi": false,
      "archive": null
    }
  ]
}
Réponse réelle de l'API en production, le 10 novembre 2026 à 20 h 20 (heure de Paris), à la requête /api/v1/abonnes?candidat=marine-tondelier&jusqua=2026-11-10. Listes coupées pour la lecture (data : 2 éléments sur 22) ; textes de plus de 160 caractères abrégés par « … ».

En CSV, une ligne par enregistrement et ces colonnes : slug, reseau, identifiant, horodatage, abonnes, arrondi, archive.

Licence et attribution

Relevés et calculs d'Isoloir 2027 : CC BY 4.0. Couvert par les offres payantes.

Attribution : « Isoloir 2027 (isoloir2027.fr) », avec un lien vers le site ou la page de la donnée.

Le détail de chaque licence : licences et attribution.