Questa è l'API di PolitPro

A chi è destinata l'API?

L'API è rivolta a media, editori, think tank, fornitori di dati e sviluppatori che desiderano integrare dati di sondaggi politici e trend elettorali nei propri prodotti, piattaforme o analisi.

Come posso utilizzare i dati?

I dati possono essere utilizzati a scopo editoriale, all'interno dei propri prodotti e per i propri clienti. Non è consentita la creazione di una piattaforma indipendente il cui prodotto principale sia costituito da dati di sondaggi politici, tendenze elettorali o offerte concorrenti simili a quelle di PolitPro. Contattaci tramite il modulo di contatto sottostante per scoprire come possiamo supportarti al meglio.

Quali dati fornisce l'API?

L'API fornisce trend elettorali attuali, sviluppi storici dei trend e dati grezzi di singoli sondaggi elettorali per oltre 70 parlamenti – suddivisi per attualità o istituto demoscopico. I dati vengono aggiornati il più tempestivamente possibile dopo la pubblicazione di nuovi sondaggi. Il trend elettorale attuale viene ricalcolato con ogni nuovo sondaggio. I dati storici dei trend vengono registrati una volta a settimana come punto dati.

Quali parlamenti sono disponibili?

AD - Andorra
AL - Albania
AM - Armenia
AT - Austria
AT-1 - Burgenland
AT-2 - Carinzia
AT-3 - Bassa Austria
AT-4 - Alta Austria
AT-5 - Salisburghese
AT-6 - Stiria
AT-7 - Tirolo
AT-8 - Vorarlberg
AT-9 - Vienna
BE - Belgio
BE-BR - Bruxelles
BE-VL - Fiandre
BE-WA - Vallonia
BG - Bulgaria
CH - Svizzera
CY - Cipro
CZ - Repubblica Ceca
DE - Germania
DE-BB - Brandeburgo
DE-BE - Berlino
DE-BW - Baden-Württemberg
DE-BY - Baviera
DE-HB - Brema
DE-HE - Assia
DE-HH - Amburgo
DE-MV - Meclemburgo-Pomerania Anteriore
DE-NI - Bassa Sassonia
DE-NW - Renania Settentrionale-Vestfalia
DE-RP - Renania-Palatinato
DE-SH - Schleswig-Holstein
DE-SL - Saarland
DE-SN - Sassonia
DE-ST - Sassonia-Anhalt
DE-TH - Turingia
DK - Danimarca
EE - Estonia
ES - Spagna
FI - Finlandia
FR - Francia
GB - Regno Unito
GE - Georgia
GR - Grecia
HR - Croazia
HU - Ungheria
IE - Irlanda
IS - Islanda
IT - Italia
LT - Lituania
LU - Lussemburgo
LV - Lettonia
MD - Moldavia
ME - Montenegro
MK - Macedonia del Nord
MT - Malta
NL - Paesi Bassi
NO - Norvegia
PL - Polonia
PT - Portogallo
RO - Romania
RU - Russia
SE - Svezia
SI - Slovenia
SK - Slovacchia
TR - Turchia
UA - Ucraina
XK - Kosovo

Quanto sono affidabili i dati?

Ogni dato è sottoposto a un rigoroso processo di verifica della qualità a più livelli, che integra algoritmi avanzati, intelligenza artificiale e controllo manuale. PolitPro è riconosciuto come una delle fonti più autorevoli e affidabili per le tendenze elettorali europee, utilizzato da media internazionali, istituti di ricerca e importanti istituzioni politiche. Tutti i dati sono forniti senza alcuna garanzia.

I punti dati storici vengono modificati retroattivamente?

I dati storici possono essere soggetti a modifiche in qualsiasi momento e senza preavviso. Le correzioni possono derivare, ad esempio, dall'ampliamento dei nostri dataset con dati attuali e storici, da modifiche alla metodologia di ponderazione o dalla risoluzione di errori. Dato che i nostri dataset sono in continua espansione, consigliamo di recuperare regolarmente i dati storici anziché considerarli come un insieme statico.

Devo citare PolitPro come fonte?

Sì, per ogni rappresentazione pubblica dei dati è richiesta l'attribuzione della fonte con un link a PolitPro.eu, ad esempio: "Fonte: PolitPro.eu".

Cos'è il trend elettorale PolitPro?

Il trend elettorale PolitPro aggrega i valori dei sondaggi di tutti gli istituti rilevanti in una media ponderata. I sondaggi attuali sono ponderati più fortemente rispetto a quelli più vecchi, e viene inclusa anche l'accuratezza storica delle previsioni degli istituti. Il risultato è una linea di tendenza statisticamente robusta che smussa le fluttuazioni a breve termine e rende visibile la reale dinamica politica nel tempo.

Cos'è PolitPro?

PolitPro è la piattaforma leader in Europa per i trend elettorali e i dati dei sondaggi politici. Media internazionali, istituzioni politiche, università e centri di ricerca utilizzano già i nostri dati nel loro lavoro quotidiano. PolitPro è politicamente indipendente e combina dati di sondaggi pubblici e set di dati scientifici con i propri algoritmi.

Richiedi ora senza impegno

Nome
Azienda
Email
Come verranno utilizzati i dati?
Breve descrizione

Endpoint e dettagli tecnici

Endpoint: Trend elettorale attuale

https://politpro.eu/api/v1/{countryCode}/trend
L'attuale trend elettorale PolitPro del Parlamento calcola una media ponderata dei sondaggi sulle intenzioni di voto attuali.
diff Confronto con l'ultimo punto di rilevazione della settimana precedente
election_diff Confronto con le ultime elezioni
Aggiornamenti consigliati: Ogni 12 ore
Evento 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: Evoluzione del trend elettorale

https://politpro.eu/api/v1/{countryCode}/trend/history/{startYear}/{endYear}
Evoluzione storica del trend elettorale PolitPro per gli anni selezionati. Il trend elettorale viene registrato come punto di misurazione una volta a settimana. I dati storici sono disponibili a partire dal 2019, a seconda del parlamento.
?format=poll Parametro URL opzionale. Mostra i dati storici come sondaggi.
?format=party Parametro URL opzionale. Mostra i dati storici come una raccolta di valori per partito.
Aggiornamenti consigliati: Una volta a settimana
Evento 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: Ultimi sondaggi elettorali

https://politpro.eu/api/v1/{countryCode}/polls/latest
Le cinque più recenti rilevazioni elettorali del parlamento, ordinate cronologicamente in senso decrescente. La data di riferimento è l'ultimo giorno del periodo di rilevazione.
diff Confronto con il sondaggio precedente dell'istituto
election_diff Confronto con le elezioni precedenti
Aggiornamenti consigliati: Ogni 12 ore
Evento 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: Ultimo sondaggio per istituto

https://politpro.eu/api/v1/{countryCode}/polls/institutes
L'ultimo sondaggio di ogni istituto che ha pubblicato dati negli ultimi 365 giorni. La data di riferimento è l'ultimo giorno del periodo di rilevazione.
diff Confronto con il sondaggio precedente dell'istituto
election_diff Confronto con le elezioni precedenti
score Se disponibile: PolitPro Score (0-100) dell'istituto, che indica l'accuratezza basata su sondaggi pre-elettorali storici e il bias di partito.
Aggiornamenti consigliati: Ogni 12 ore
Evento 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 } ] } ] } }

Come funziona il Webhook?

Tramite il Webhook, il tuo server viene automaticamente informato su nuovi dati. La struttura di ogni notifica rispecchia quella dell'endpoint corrispondente, arricchita da un campo aggiuntivo per il tipo di evento.

Configurazione

Configura l'URL del tuo server nelle impostazioni del tuo account PolitPro. Hai inoltre la possibilità di creare un Webhook Secret, con cui potrai verificare l'autenticità delle nostre trasmissioni di dati.

Consegna e Formato della Risposta

Se il tuo server non risponde con "OK", la consegna viene considerata fallita. In tal caso, riproveremo la consegna fino a cinque volte.

Verifica dei Dati

Ogni notifica include nell'header il campo "X-Webhook-Signature". Questo campo contiene una firma HMAC-SHA256 del contenuto del messaggio, calcolata utilizzando il tuo Webhook Secret come chiave. Calcola la firma sul tuo server nello stesso modo (HMAC-SHA256 sull'intera notifica) e confrontala con il valore trasmesso, per assicurarti che i dati provengano effettivamente da noi e non siano stati alterati durante il transito.

Autenticazione

L'autenticazione avviene tramite Bearer Token nell'header: "Authorization: Bearer {token}". Il token è disponibile nelle impostazioni del tuo account PolitPro dopo la registrazione.

Max. richieste al minuto

L'API consente un massimo di 30 richieste al minuto. In caso di superamento, viene restituito il codice di errore 429.

Dove trovo la mia chiave API?

La tua chiave API si trova nelle impostazioni del tuo account PolitPro.