API PUBLIQUE

Les résultats de ta plateforme d'opinion, dans tes outils

L'API publique de VoxPop sert des résultats AGRÉGÉS — sondages, parts, tendances — pour les outils de veille et d'analyse. Aucune donnée de membre n'en sort : ni vote, ni profil, ni identifiant de personne.

Ce que l'API garantit

Aucune donnée de membre : jamais un vote, jamais un profil.
Plancher d'anonymat de 5 : un sondage de moins de 5 voix n'est pas servi ; une option de moins de 5 voix est fusionnée dans « autres » ; tous les comptes sont arrondis au multiple de 5.
Les parts sont calculées sur les comptes arrondis, et la marge d'erreur sur l'effectif arrondi.
Un sondage non public, sensible, en quarantaine ou retiré par la modération est introuvable (404), comme s'il n'existait pas.
Ces chiffres décrivent le panel VoxPop, jamais une population : ne les présente pas comme « ce que pense » un pays.

Lire comment VoxPop mesure et protège les résultats

Obtenir une clé

Les clés d'API sont remises sur demande, pendant le lancement gratuit de VoxPop : ce sont des clés d'essai, avec un petit quota. À l'ouverture des offres payantes, l'API est réservée aux comptes Pro et Annonceur — à venir.

Une clé t'est remise une seule fois : VoxPop n'en garde que l'empreinte et ne peut pas te la redonner. Si tu la perds, elle se remplace.

Demander une clé

S'authentifier

Envoie ta clé dans l'en-tête Authorization: Bearer vp_… (l'en-tête X-API-Key est aussi accepté). Jamais dans l'adresse : une adresse se retrouve dans les journaux.

Adresse de base

https://voxpopapp.app/api

Quotas

60 requêtes par minute, puis un quota par jour (jour UTC) selon le plan : 1 000 pour un compte Pro, 10 000 pour un compte Annonceur, 200 pour une clé d'essai. Au-delà : réponse 429 avec l'en-tête Retry-After.

Les routes

Toutes les routes répondent en JSON, en lecture seule (GET).

GET /api/v1/sondages

Les sondages publics qui ont au moins 5 voix, du plus récent au plus ancien.

Paramètres

`limite`	dans l'adresse · facultatif	Nombre de sondages par page (1 à 50, 20 par défaut).
`curseur`	dans l'adresse · facultatif	La valeur « curseur » de la page précédente ; « curseur » vaut null à la dernière page.
`categorie`	dans l'adresse · facultatif	Se limiter à un thème (par exemple « politique »).

Champs de la réponse

donnees
donnees.id
donnees.titre
donnees.categorie
donnees.creeLe
donnees.clos
donnees.sponsorise
donnees.voix
curseur
k

Exemple

curl -H "Authorization: Bearer $VOXPOP_API_KEY" "https://voxpopapp.app/api/v1/sondages?limite=5"

GET /api/v1/sondages/{id}/resultats

Les résultats agrégés d'un sondage public : parts, effectif arrondi et marge d'erreur.

Paramètres

id dans le chemin · obligatoire L'identifiant du sondage, tel que la liste des sondages le donne.

Champs de la réponse

id
titre
categorie
creeLe
clos
voix
margeDErreur
k
questions
questions.texte
questions.voix
questions.options
questions.options.libelle
questions.options.voix
questions.options.part
questions.autres

Exemple

curl -H "Authorization: Bearer $VOXPOP_API_KEY" "https://voxpopapp.app/api/v1/sondages/IDENTIFIANT_DU_SONDAGE/resultats"

GET /api/v1/tendances

La comparaison par thème et les sujets qui montent en ce moment.

Paramètres

categorie dans l'adresse · facultatif Se limiter à un thème.

Champs de la réponse

categories
categories.categorie
categories.disponible
categories.raison
categories.nbSondages
categories.nettete
categories.partOui
categories.calculeLe
sujetsEnMontee
sujetsEnMontee.id
sujetsEnMontee.titre
sujetsEnMontee.categorie
sujetsEnMontee.voix
sujetsEnMontee.fenetreHeures
k

Exemple

curl -H "Authorization: Bearer $VOXPOP_API_KEY" "https://voxpopapp.app/api/v1/tendances?categorie=politique"

GET /api/v1/ancrages

Les racines quotidiennes du journal des VOX, avec leur état d'ancrage. Tant que l'ancrage n'est pas actif, l'état dit « non_ancre » : on ne dit « ancré » qu'avec une transaction.

Paramètres

limite dans l'adresse · facultatif Nombre de jours (1 à 90, 30 par défaut).

Champs de la réponse

donnees
donnees.jour
donnees.racine
donnees.racinePrecedente
donnees.ancrage
donnees.ancrage.etat
donnees.ancrage.txHash

Exemple

curl -H "Authorization: Bearer $VOXPOP_API_KEY" "https://voxpopapp.app/api/v1/ancrages?limite=7"

Les erreurs

Le corps de la réponse porte toujours les champs « erreur » et « message ».

Statut	Code	Sens
401	`cle_manquante`	Aucune clé dans la requête.
401	`cle_invalide`	Clé inconnue.
401	`cle_revoquee`	Clé révoquée.
403	`a_venir`	L'API arrive avec les offres payantes (seules les clés d'essai répondent d'ici là).
404	`introuvable`	Sondage inexistant, non public, sensible, retiré, ou sous 5 voix.
429	`trop_de_requetes`	Quota par minute dépassé : attends Retry-After secondes.
429	`quota_epuise`	Quota du jour épuisé (jour UTC) : reprise à minuit UTC.

Spécification OpenAPI

La spécification complète (OpenAPI 3) est celle que ces pages décrivent : tu peux la charger dans tes outils.

Télécharger la spécification (YAML)

Conditions d'usage

Les agrégats peuvent être réutilisés en citant VoxPop ; toute tentative de ré-identifier des personnes est interdite. Le texte complet des conditions d'usage de l'API sera rattaché aux CGU avant l'ouverture des clés.