API PÚBLICA

Los resultados de tu plataforma de opinión, en tus herramientas

La API pública de VoxPop sirve resultados AGREGADOS — encuestas, porcentajes, tendencias — para herramientas de vigilancia y análisis. Ningún dato de miembros sale de ella: ni voto, ni perfil, ni identificador de persona.

Lo que garantiza la API

Ningún dato de miembros: nunca un voto, nunca un perfil.
Umbral de anonimato de 5: una encuesta con menos de 5 votos no se sirve; una opción con menos de 5 votos se fusiona en «otros»; todos los recuentos se redondean a un múltiplo de 5.
Los porcentajes se calculan sobre los recuentos redondeados, y el margen de error sobre el tamaño redondeado.
Una encuesta no pública, sensible, en cuarentena o retirada por la moderación no se encuentra (404), como si no existiera.
Estas cifras describen el panel de VoxPop, nunca una población: no las presentes como «lo que piensa» un país.

Leer cómo VoxPop mide y protege los resultados

Obtener una clave

Las claves de API se entregan bajo petición durante el lanzamiento gratuito de VoxPop: son claves de prueba, con una cuota pequeña. Cuando se abran los planes de pago, la API estará reservada a las cuentas Pro y Anunciante — próximamente.

Una clave se entrega una sola vez: VoxPop solo guarda su huella y no puede devolvértela. Si la pierdes, se sustituye.

Pedir una clave

Autenticarse

Envía tu clave en el encabezado Authorization: Bearer vp_… (también se acepta el encabezado X-API-Key). Nunca en la dirección: las direcciones acaban en los registros.

Dirección base

https://voxpopapp.app/api

Cuotas

60 solicitudes por minuto, luego una cuota diaria (día UTC) según el plan: 1 000 para una cuenta Pro, 10 000 para una cuenta Anunciante, 200 para una clave de prueba. Más allá: respuesta 429 con el encabezado Retry-After.

Las rutas

Todas las rutas responden en JSON, solo lectura (GET).

GET /api/v1/sondages

Las encuestas públicas con al menos 5 votos, de la más reciente a la más antigua.

Parámetros

`limite`	en la dirección · opcional	Número de encuestas por página (de 1 a 50, 20 por defecto).
`curseur`	en la dirección · opcional	El valor «curseur» de la página anterior; «curseur» es null en la última página.
`categorie`	en la dirección · opcional	Limitarse a un tema (por ejemplo «politique»).

Campos de la respuesta

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

Ejemplo

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

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

Los resultados agregados de una encuesta pública: porcentajes, tamaño redondeado y margen de error.

Parámetros

id en la ruta · obligatorio El identificador de la encuesta, tal como lo da la lista de encuestas.

Campos de la respuesta

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

Ejemplo

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

GET /api/v1/tendances

La comparación por tema y los temas que suben ahora mismo.

Parámetros

categorie en la dirección · opcional Limitarse a un tema.

Campos de la respuesta

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

Ejemplo

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

GET /api/v1/ancrages

Las raíces diarias del diario de VOX, con su estado de anclaje. Mientras el anclaje no esté activo, el estado dice «non_ancre»: solo decimos «anclado» con una transacción.

Parámetros

limite en la dirección · opcional Número de días (de 1 a 90, 30 por defecto).

Campos de la respuesta

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

Ejemplo

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

Los errores

El cuerpo de la respuesta siempre lleva los campos «erreur» y «message».

Estado	Código	Significado
401	`cle_manquante`	No hay clave en la solicitud.
401	`cle_invalide`	Clave desconocida.
401	`cle_revoquee`	Clave revocada.
403	`a_venir`	La API llega con los planes de pago (hasta entonces solo responden las claves de prueba).
404	`introuvable`	La encuesta no existe, no es pública, es sensible, está retirada o tiene menos de 5 votos.
429	`trop_de_requetes`	Cuota por minuto superada: espera Retry-After segundos.
429	`quota_epuise`	Cuota del día agotada (día UTC): se reanuda a medianoche UTC.

Especificación OpenAPI

La especificación completa (OpenAPI 3) es la que describen estas páginas: puedes cargarla en tus herramientas.

Descargar la especificación (YAML)

Condiciones de uso

Los agregados pueden reutilizarse citando a VoxPop; cualquier intento de reidentificar personas está prohibido. El texto completo de las condiciones de uso de la API se añadirá a las condiciones generales antes de abrir las claves.