Isoloir 2027
Point d'accès

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

Mise à jour : Chaque heure. Format : JSON.

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

NomTypeValeursRôle
candidatfacultatifstringun slug de /api/v1/candidatsLimite la réponse à un candidat. Un slug inconnu renvoie 404 not_found.
reseaufacultatifstringbluesky, telegram, mastodon, youtube (les autres réseaux sont acceptés mais ne renvoient rien)Limite la réponse à un réseau.
depuisfacultatifdateAAAA-MM-JJPublications de ce jour (UTC) ou plus récentes.
avantfacultatifdate-timehorodatage ISO 8601Publications strictement antérieures à cet instant : c'est le curseur de pagination.
limitefacultatifinteger1 à 200Nombre 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 :

ChampTypeContenu
idstringIdentifiant stable de la publication chez Isoloir.
slug, reseau, comptestringLe candidat, le réseau, le compte.
urlstring (URL)La publication d'origine.
textestringTexte tel que publié, 600 caractères au plus.
mediastring | nullType de média joint (video, image...).
publieLe, releveLestring (date-time)Publication, puis premier relevé par Isoloir.
Réponse 200
{
  "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"
    }
  ]
}
Réponse réelle de l'API en production, le 10 novembre 2026 à 20 h 20 (heure de Paris), à la requête /api/v1/publications?candidat=francois-ruffin&limite=2. textes de plus de 160 caractères abrégés par « … ».

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.