API publique des sondages Pouls

Lire les données

https://api.pouls.app/v1/polls.json renvoie du JSON. Aucun paramètre n'est nécessaire ; les lectures depuis d'autres sites sont autorisées par CORS.

curl 'https://api.pouls.app/v1/polls.json' -H 'Accept: application/json'

Spécification OpenAPI · Catalogue des API (RFC 9727).

Ce que contient le contrat

version

Version du contrat, actuellement 1. Les ajouts compatibles de champs ne changent pas cette version : ignorez les champs inconnus. Une nouvelle valeur signale un changement incompatible.

updatedAt

Date et heure de génération du contrat. Les dates de terrain des enquêtes sont indiquées séparément.

source et window

Source et crédit des données ; fenêtre glissante de premier tour, dates de terrain, instituts et nombre de sondages distincts.

sondages

Classement de premier tour : moyennes pondérées, marges d'erreur, tendances et couverture de chaque candidat, toutes hypothèses confondues.

tendance

Séries de moyennes glissantes à date. Chaque relevé peut porter sa marge et le nombre de nouveaux sondages du bucket. Ces deux champs sont optionnels dans l'historique.

recentPolls

Sondages individuels récents : institut, commanditaire, terrain, échantillon, population, hypothèse et résultats bruts. Plusieurs hypothèses du même terrain ne sont pas des enquêtes indépendantes.

duels

Moyennes de face-à-face de second tour réellement mesurés par les instituts, avec marges, dates et nombre de sondages.

latestPollId et newPolls

Dernier identifiant de sondage (ou null) et identifiants apparus depuis la génération précédente du contrat. Ce diff n'est pas propre à chaque client.

Fraîcheur et disponibilité

Le contrat est pré-calculé par un cron toutes les 30 minutes. Ce rythme décrit une tentative d'actualisation, pas une garantie qu'un nouveau sondage sera publié. Vérifiez updatedAt avant de présenter les données comme récentes.

La réponse porte Cache-Control: no-store. Gardez votre dernière copie valide pour fonctionner hors ligne ou en cas d'erreur HTTP. Espacez les requêtes : consulter l'API plus souvent que son cycle d'actualisation n'apporte pas de nouveaux sondages.

Chaque réponse porte un ETag. Renvoyez-le dans If-None-Match : tant que le contrat n'a pas changé, la réponse est un 304 sans corps et votre copie reste valable.

curl 'https://api.pouls.app/v1/polls.json' -H 'If-None-Match: "…"' -i

Lire et réutiliser les chiffres

Conservez le crédit de la source, la date, les marges d'erreur et le contexte des hypothèses lorsque vous reprenez les résultats. Les données amont proviennent de Mieux Voter (licence MIT). Pouls agrège, ne produit aucun sondage.

Un écart inférieur à la marge n'est pas significatif. La marge affichée est celle d'un sondage typique, pas celle d'un échantillon cumulé. Une intention de vote n'est pas une prévision du résultat.

Pour reproduire le calcul et comprendre ses limites : méthodologie et fiabilité des sondages.