Para desarrolladores y redacciones API de encuestas políticas, tendencias electorales y sondeos de intención de voto

Así es la API de PolitPro

¿Para quién es adecuada la API?

La API está dirigida a medios de comunicación, editoriales, think tanks, proveedores de datos y desarrolladores que deseen integrar datos de encuestas políticas y tendencias electorales en sus propios productos, plataformas o análisis.

¿Cómo puedo usar los datos?

Los datos pueden utilizarse editorialmente, en productos propios y para clientes propios. No está permitido crear una plataforma independiente cuyo producto principal sean datos de encuestas políticas, tendencias electorales u ofertas competitivas similares a PolitPro. Contáctanos a través del formulario de contacto de abajo para saber cómo podemos ayudarte mejor.

¿Qué datos proporciona la API?

La API proporciona Tendencias electorales actuales, desarrollos históricos de tendencias y datos brutos de encuestas electorales individuales para más de 70 parlamentos, desglosados por actualidad o instituto de encuestas. Los datos se actualizan lo antes posible después de la publicación de nuevas encuestas. La Tendencia electoral actual se recalcula con cada nueva encuesta. Los datos históricos de tendencias se registran una vez por semana como punto de datos.

¿Qué parlamentos están disponibles?

La API soporta los siguientes códigos de país:
AD – Andorra
AL – Albania
AM – Armenia
AT – Austria
AT-1 – Burgenland
AT-2 – Carintia
AT-3 – Baja Austria
AT-4 – Alta Austria
AT-5 – Salzburgo
AT-6 – Estiria
AT-7 – Tirol
AT-8 – Vorarlberg
AT-9 – Viena
BE – Bélgica
BE-BR – Bruselas
BE-VL – Flandes
BE-WA – Valonia
BG – Bulgaria
CH – Suiza
CY – Chipre
CZ – República Checa
DE – Alemania
DE-BB – Brandeburgo
DE-BE – Berlín
DE-BW – Baden-Wurtemberg
DE-BY – Baviera
DE-HB – Bremen
DE-HE – Hesse
DE-HH – Hamburgo
DE-MV – Mecklemburgo-Pomerania Occidental
DE-NI – Baja Sajonia
DE-NW – Renania del Norte-Westfalia
DE-RP – Renania-Palatinado
DE-SH – Schleswig-Holstein
DE-SL – Sarre
DE-SN – Sajonia
DE-ST – Sajonia-Anhalt
DE-TH – Turingia
DK – Dinamarca
EE – Estonia
ES – España
FI – Finlandia
FR – Francia
GB – Reino Unido
GE – Georgia
GR – Grecia
HR – Croacia
HU – Hungría
IE – Irlanda
IS – Islandia
IT – Italia
LT – Lituania
LU – Luxemburgo
LV – Letonia
MD – Moldavia
ME – Montenegro
MK – Macedonia del Norte
MT – Malta
NL – Países Bajos
NO – Noruega
PL – Polonia
PT – Portugal
RO – Rumanía
RU – Rusia
SE – Suecia
SI – Eslovenia
SK – Eslovaquia
TR – Turquía
UA – Ucrania
XK – Kosovo

¿Qué fiabilidad tienen los datos?

Todos los datos pasan por un proceso de control de calidad de varias etapas que incluye algoritmos, IA y control manual. PolitPro es considerada una de las fuentes más fiables para las Tendencias electorales europeas, utilizada por medios internacionales, centros de investigación e instituciones políticas. Todos los datos sin garantía.

¿Se ajustan los puntos de datos históricos posteriormente?

Los datos históricos pueden ajustarse en cualquier momento y sin previo aviso. Las correcciones se realizan, por ejemplo, mediante la ampliación de nuestros conjuntos de datos con datos actuales e históricos, cambios en la metodología de ponderación o correcciones de errores. Dado que ampliamos continuamente nuestros conjuntos de datos, recomendamos recuperar los datos históricos regularmente en lugar de tratarlos como un conjunto de datos estático.

¿Debo citar a PolitPro como fuente?

Sí, en cada presentación pública de los datos se requiere una atribución con un enlace a PolitPro.eu, por ejemplo, "Fuente: PolitPro.eu".

¿Qué es la Tendencia electoral de PolitPro?

La Tendencia electoral de PolitPro agrega los valores de las encuestas de todos los institutos relevantes en una media ponderada. Las encuestas actuales tienen un peso mayor que las antiguas, y también se incluye la precisión histórica de las previsiones de los institutos. El resultado es una línea de tendencia estadísticamente sólida que suaviza los valores atípicos a corto plazo y hace visible la dinámica política real a lo largo del tiempo.

¿Qué es PolitPro?

PolitPro es la plataforma líder en Europa para Tendencias electorales y datos de encuestas políticas. Medios internacionales, instituciones políticas, universidades y centros de investigación ya utilizan nuestros datos en su trabajo diario. PolitPro es políticamente independiente y combina datos de encuestas públicas y conjuntos de datos científicos con algoritmos propios.

Solicitar ahora sin compromiso

Nombre

Empresa

Correo electrónico

¿Cómo se deben utilizar los datos?

Breve descripción

Endpoints de la API

Endpoint: Tendencia electoral actual

GET https://politpro.eu/api/v1/{countryCode}/trend

La actual Tendencia electoral de PolitPro del parlamento calcula un valor promedio ponderado de los sondeos de intención de voto actuales.

diff: Comparación con el último punto de medición de la semana anterior
election_diff: Comparación con la última elección

Actualizaciones recomendadas: Cada 12 horas Evento de Webhook: parliament.polls.trend

{
    "success": 1,
    "data": {
        "poll": {
            "uuid": "74015bcf-d68e-442d-9d40-dd657dd0c0e1",
            "date": "2025-10-12",
            "parliament": "de",
            "seats_total": 630,
            "parties": [
                {
                    "uuid": "3b54fa84-ac25-44c6-843b-20ef62f21ac1",
                    "name_short": "SPD",
                    "name_long": "Sozialdemokratische Partei Deutschlands",
                    "color": "#f30100",
                    "font_color": "#ffffff",
                    "percent": 14.4,
                    "seats": 104,
                    "diff": -0.1,
                    "election_diff": 2
                }
            ]
        }
    }
}

Endpoint: Evolución de la Tendencia electoral

GET https://politpro.eu/api/v1/{countryCode}/trend/history/{startYear}/{endYear}

Evolución histórica de la Tendencia electoral de PolitPro de los años seleccionados. La Tendencia electoral se guarda una vez por semana como punto de medición. Los datos históricos están disponibles a partir de 2019, dependiendo del parlamento.

?format=poll: Parámetro URL opcional. Muestra los datos históricos como encuestas
?format=party: Parámetro URL opcional. Muestra los datos históricos como una colección de valores por partido

Actualizaciones recomendadas: Una vez por semana Evento de Webhook: parliament.polls.development

{
    "success": 1,
    "data": {
        "parliament": "de",
        "start": 2025,
        "end": 2026,
        "datasets": [
            {
                "uuid": "3b54fa84-ac25-44c6-843b-20ef62f21ac1",
                "name_short": "SPD",
                "name_long": "Sozialdemokratische Partei Deutschlands",
                "color": "#f30100",
                "font_color": "#ffffff",
                "max": 16.1,
                "min": 15.8,
                "history": [
                    {
                        "date": "2025-01-05",
                        "percent": 16.1
                    },
                    {
                        "date": "2025-01-12",
                        "percent": 15.8
                    }
                ]
            }
        ]
    }
}

Endpoint: Últimas encuestas electorales

GET https://politpro.eu/api/v1/{countryCode}/polls/latest

Las cinco encuestas electorales más recientes del parlamento, ordenadas cronológicamente de forma descendente. La fecha clave es el último día del período de la encuesta.

diff: Comparación con la encuesta anterior del instituto
election_diff: Comparación con la elección anterior

Actualizaciones recomendadas: Cada 12 horas Evento de Webhook: parliament.polls.latest

{
    "success": 1,
    "data": {
        "polls": [
            {
                "uuid": "0ce2f646-f652-4e9d-82f0-ad633b9709c1",
                "parliament": "de",
                "start": "2025-10-06",
                "end": "2025-10-10",
                "sample_size": 1224,
                "seats_total": 630,
                "institute": {
                    "uuid": "2eb3e83b-c645-4e72-a686-124acf30033b",
                    "name": "INSA",
                    "score": 82
                },
                "parties": [
                    {
                        "uuid": "3b54fa84-ac25-44c6-843b-20ef62f21ac1",
                        "name_short": "SPD",
                        "name_long": "Sozialdemokratische Partei Deutschlands",
                        "color": "#f30100",
                        "font_color": "#ffffff",
                        "percent": 14,
                        "seats": 101,
                        "diff": -0.5,
                        "election_diff": 2.4
                    }
                ]
            }
        ]
    }
}

Endpoint: Última encuesta por instituto

GET https://politpro.eu/api/v1/{countryCode}/polls/institutes

La encuesta más reciente de cada instituto que haya publicado valores de encuestas en los últimos 365 días. La fecha clave es el último día del período de la encuesta.

diff: Comparación con la encuesta anterior del instituto
election_diff: Comparación con la elección anterior
score: Si está disponible: Puntuación PolitPro (0-100) del instituto sobre la precisión basada en encuestas preelectorales históricas y el sesgo de los partidos.

Actualizaciones recomendadas: Cada 12 horas Evento de Webhook: parliament.polls.institutes

{
    "success": 1,
    "data": {
        "polls": [
            {
                "uuid": "62b60fcf-24db-4479-b89d-e5a2aa3f20e5",
                "parliament": "de",
                "start": "2025-09-30",
                "end": "2025-10-06",
                "sample_size": 2001,
                "seats_total": 630,
                "institute": {
                    "uuid": "ba0ef610-f639-40cd-a60b-233989270c6f",
                    "name": "Forsa",
                    "score": 83
                },
                "parties": [
                    {
                        "uuid": "3b54fa84-ac25-44c6-843b-20ef62f21ac1",
                        "name_short": "SPD",
                        "name_long": "Sozialdemokratische Partei Deutschlands",
                        "color": "#f30100",
                        "font_color": "#ffffff",
                        "percent": 13,
                        "seats": 94,
                        "diff": 0,
                        "election_diff": 3.4
                    }
                ]
            }
        ]
    }
}

Webhook: recibe los nuevos datos automáticamente

¿Cómo funciona el Webhook?

A través del Webhook, informamos automáticamente a tu servidor sobre nuevos datos. La estructura de cada notificación corresponde a la del punto final respectivo, complementada con un campo adicional para el tipo de evento.

Configuración

Introduce la URL de tu servidor en la configuración de tu cuenta PolitPro. Opcionalmente, también puedes crear un Secreto de Webhook allí, con el que puedes verificar la autenticidad de nuestras transmisiones de datos.

Entrega y formato de respuesta

Si tu servidor no responde con "OK", la entrega se considera fallida. En este caso, intentaremos la entrega hasta cinco veces más.

Verificación de los datos

Cada notificación contiene en el encabezado el campo "X-Webhook-Signature". Contiene una firma HMAC-SHA256 del contenido del mensaje, calculada con tu Secreto de Webhook como clave. Calcula la firma en tu lado de la misma manera (HMAC-SHA256 sobre toda la notificación) y compárala con el valor transmitido para asegurar que los datos provienen realmente de nosotros y no han sido alterados en el camino.

Autenticación y límites de uso

Autenticación

La autenticación se realiza mediante un token Bearer en el encabezado: "Authorization: Bearer {token}". El token lo encontrarás después de registrarte en la configuración de tu cuenta PolitPro.

Máx. solicitudes por minuto

La API permite un máximo de 30 solicitudes por minuto. Si se excede, se devolverá el código de error 429.

¿Dónde encuentro mi clave API?

Tu clave API se encuentra en la configuración de tu cuenta PolitPro.