Publications des candidats
Les messages des comptes officiels sur Bluesky, Telegram, Mastodon et YouTube, du plus récent au plus ancien, paginés.
Mis à jour le 10 novembre 2026
GEThttps://isoloir2027.fr/api/v1/publications
Ce que contiennent les données
Chaque publication donne son réseau, le compte, le lien vers l'original, le texte (coupé au-delà de 600 caractères), le type de média joint, l'heure de publication et l'heure à laquelle Isoloir l'a vue. Pour YouTube, le texte est le titre de la vidéo.
La réponse est paginée : limite fixe la taille de la page (50 par défaut, 200 au plus) et meta.suivant donne l'adresse de la page suivante, construite avec avant. meta.total compte toutes les publications qui répondent aux filtres.
Comment elles sont collectées
Lecture chaque heure de l'API publique de Bluesky, des pages publiques t.me/s des chaînes Telegram, de l'API des instances Mastodon et des flux RSS des chaînes YouTube. Le flux YouTube répond mal une fois sur deux : il est relu plusieurs fois par passage, et l'heure suivante rattrape le reste.
Limites à connaître
- X, Instagram, Facebook et TikTok ne figurent pas : leurs publications ne sont pas lisibles sans accès payant ou compte connecté. Le volume de publications ne mesure donc qu'une partie de l'activité en ligne d'un candidat.
- Les textes appartiennent à leurs auteurs. Ce point d'accès reste gratuit et n'est couvert par aucune offre payante : voir licences.
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 | bluesky, telegram, mastodon, youtube (les autres réseaux sont acceptés mais ne renvoient rien) | Limite la réponse à un réseau. |
depuisfacultatif | date | AAAA-MM-JJ | Publications de ce jour (UTC) ou plus récentes. |
avantfacultatif | date-time | horodatage ISO 8601 | Publications strictement antérieures à cet instant : c'est le curseur de pagination. |
limitefacultatif | integer | 1 à 200 | Nombre de publications par page. Par défaut : 50. |
Requête
curl "https://isoloir2027.fr/api/v1/publications?candidat=francois-ruffin&limite=2" \
-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 |
|---|---|---|
id | string | Identifiant stable de la publication chez Isoloir. |
slug, reseau, compte | string | Le candidat, le réseau, le compte. |
url | string (URL) | La publication d'origine. |
texte | string | Texte tel que publié, 600 caractères au plus. |
media | string | null | Type de média joint (video, image...). |
publieLe, releveLe | string (date-time) | Publication, puis premier relevé par Isoloir. |
{
"meta": {
"endpoint": "/api/v1/publications",
"version": "v1",
"generatedAt": "2026-11-10T19:20:40.998Z",
"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": "Comptes officiels vérifiés : API publique de Bluesky, pages publiques des chaînes Telegram, API des instances Mastodon, flux des chaînes YouTube (titres).",
"total": 79,
"suivant": "/api/v1/publications?candidat=francois-ruffin&limite=2&avant=2026-11-10T17%3A00%3A37.088Z",
"avertissement": "Textes cités tels que publiés, coupés au-delà de 600 caractères ; le lien mène à la publication entière."
},
"data": [
{
"id": "po:telegram:francoisruffin:4327",
"slug": "francois-ruffin",
"reseau": "telegram",
"compte": "francoisruffin",
"url": "https://t.me/francoisruffin/4327",
"texte": "Rendez-vous ce jeudi à la brasserie l'Eurostar d'Arras, en face de la gare, pour une réunion publique, à 18h.\nEt juste avant, dédicace du livre \"Au Boulot !\" à …",
"media": "image",
"publieLe": "2026-11-10T17:31:01.000Z",
"releveLe": "2026-11-10T17:44:30.591Z"
},
{
"id": "po:bluesky:francoisruffin.fr:3mzxw4bkz4v2v",
"slug": "francois-ruffin",
"reseau": "bluesky",
"compte": "francoisruffin.fr",
"url": "https://bsky.app/profile/francoisruffin.fr/post/3mzxw4bkz4v2v",
"texte": "Rendez-vous ce jeudi à la brasserie l'Eurostar d'Arras, en face de la gare, pour une réunion publique, à 18h.\nEt juste avant, dédicace du livre \"Au Boulot !\" à …",
"media": "image",
"publieLe": "2026-11-10T17:00:37.088Z",
"releveLe": "2026-11-10T17:44:29.702Z"
}
]
}Licence et attribution
Textes des publications des candidats : Droits de leurs auteurs. Gratuit, non couvert par les offres payantes.
Attribution : Citez l'auteur et le lien de la publication (champ url).
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.