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
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
| Nom | Type | Valeurs | Rôle |
|---|---|---|---|
candidatfacultatif | string | un slug de /api/v1/candidats | Limite la réponse à un candidat. Un slug inconnu renvoie 404 not_found. |
reseaufacultatif | string | x, tiktok, youtube, facebook, bluesky, telegram, mastodon | Limite la réponse à un réseau. |
depuisfacultatif | date | AAAA-MM-JJ | Premier jour inclus (heure de Paris). |
jusquafacultatif | date | AAAA-MM-JJ | Dernier jour inclus (heure de Paris). |
formatfacultatif | string | csv | Renvoie 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 :
| Champ | Type | Contenu |
|---|---|---|
slug, reseau, identifiant | string | Le candidat, le réseau et le compte. |
horodatage | string (date-time) | Heure du relevé, en UTC. |
abonnes | integer | Nombre d'abonnés lu. |
arrondi | boolean | Vrai si la plateforme arrondit le chiffre. |
archive | string | null | Capture de la Wayback Machine dont vient le chiffre, sinon null. |
{
"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
}
]
}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.