Ovo je PolitPro API

Kome je API namijenjen?

API je namijenjen medijskim kućama, izdavačima, think tankovima, pružateljima podataka i developerima koji žele integrirati podatke političkih anketa i izborne trendove u vlastite proizvode, platforme ili analize.

Kako smijem koristiti podatke?

Podaci se smiju koristiti u uredničke svrhe, u vlastitim proizvodima i za vlastite klijente. Nije dopušteno stvaranje samostalne platforme čiji su glavni proizvod podaci o političkim anketama, izborni trendovi ili slične konkurentske ponude PolitPro-u. Kontaktirajte nas putem obrasca za kontakt u nastavku kako biste saznali više o tome kako vas možemo najbolje podržati.

Koje podatke pruža API?

API pruža aktualne izborne trendove, povijesne trendove razvoja te sirove podatke pojedinih izbornih anketa za više od 70 parlamenata – razvrstane prema aktualnosti ili institutu za istraživanje javnog mnijenja. Podaci se ažuriraju što je prije moguće nakon objave novih anketa. Aktualni izborni trend ponovno se izračunava sa svakom novom anketom. Povijesni podaci o trendovima bilježe se jednom tjedno kao mjerna točka.

Koji su parlamenti dostupni?

AD - Andora
AL - Albanija
AM - Armenija
AT - Austrija
AT-1 - Gradišće
AT-2 - Koruška
AT-3 - Donja Austrija
AT-4 - Gornja Austrija
AT-5 - Salzburg
AT-6 - Štajerska
AT-7 - Tirol
AT-8 - Vorarlberg
AT-9 - Beč
BE - Belgija
BE-BR - Bruxelles
BE-VL - Flandrija
BE-WA - Valonija
BG - Bugarska
CH - Švicarska
CY - Cipar
CZ - Češka
DE - Njemačka
DE-BB - Brandenburg
DE-BE - Berlin
DE-BW - Baden-Württemberg
DE-BY - Bavarska
DE-HB - Bremen
DE-HE - Hessen
DE-HH - Hamburg
DE-MV - Mecklenburg-Zapadno Pomorje
DE-NI - Donja Saska
DE-NW - Sjeverna Rajna-Vestfalija
DE-RP - Falačko Porajnje
DE-SH - Schleswig-Holstein
DE-SL - Saarland
DE-SN - Saska
DE-ST - Saska-Anhalt
DE-TH - Tiringija
DK - Danska
EE - Estonija
ES - Španjolska
FI - Finska
FR - Francuska
GB - Velika Britanija
GE - Gruzija
GR - Grčka
HR - Hrvatska
HU - Mađarska
IE - Irska
IS - Island
IT - Italija
LT - Litva
LU - Luksemburg
LV - Latvija
MD - Moldavija
ME - Crna Gora
MK - Sjeverna Makedonija
MT - Malta
NL - Nizozemska
NO - Norveška
PL - Poljska
PT - Portugal
RO - Rumunjska
RU - Rusija
SE - Švedska
SI - Slovenija
SK - Slovačka
TR - Turska
UA - Ukrajina
XK - Kosovo

Koliko su podaci pouzdani?

Svi podaci prolaze višestupanjsku provjeru kvalitete koja uključuje algoritme, umjetnu inteligenciju (AI) i ručnu kontrolu. PolitPro se smatra jednim od najpouzdanijih izvora za europske izborne trendove, a koriste ga međunarodni mediji, istraživačke institucije i političke ustanove. Podaci su isključivo informativnog karaktera.

Prilagođavaju li se povijesne mjerne točke naknadno?

Povijesni podaci mogu se prilagođavati u bilo kojem trenutku i bez prethodne najave. Ispravci se vrše, primjerice, proširenjem naših skupova podataka s aktualnim i povijesnim podacima, promjenama u metodologiji ponderiranja ili ispravcima pogrešaka. Budući da kontinuirano proširujemo naše skupove podataka, preporučujemo redovito ponovno preuzimanje povijesnih podataka umjesto da ih tretirate kao statičan skup podataka.

Moram li navesti PolitPro kao izvor?

Da, pri svakom javnom prikazivanju podataka obavezno je navesti izvor s poveznicom na PolitPro.eu, npr. "Izvor: PolitPro.eu".

Što je PolitPro izborni trend?

PolitPro izborni trend agregira rezultate anketa svih relevantnih instituta u ponderiranu prosječnu vrijednost. Aktualne ankete imaju veću težinu od starijih, a u obzir se uzima i povijesna točnost prognoza instituta. Rezultat je statistički pouzdana trend linija koja izglađuje kratkoročna odstupanja i čini vidljivom stvarnu političku dinamiku tijekom vremena.

Što je PolitPro?

PolitPro je vodeća europska platforma za izborne trendove i podatke političkih anketa. Međunarodni mediji, političke institucije, sveučilišta i istraživačke ustanove već koriste naše podatke u svom svakodnevnom radu. PolitPro je politički neovisan i kombinira javne podatke anketa i znanstvene skupove podataka s vlastitim algoritmima.

Pošaljite neobvezujući upit

Ime
Tvrtka
E-mail
Na koji način želite koristiti podatke?
Kratak opis

Krajnje točke i tehnički detalji

Krajnja točka: Trenutni izborni trend
https://politpro.eu/api/v1/{countryCode}/trend
Trenutni PolitPro izborni trend parlamenta izračunava ponderiranu prosječnu vrijednost aktualnih predizbornih anketa.
diff Usporedba s posljednjom mjernom točkom iz prethodnog tjedna
election_diff Usporedba s posljednjim izborima
Preporučena ažuriranja: Svakih 12 sati
Webhook događaj 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 } ] } } }

Krajnja točka: Razvoj izbornog trenda
https://politpro.eu/api/v1/{countryCode}/trend/history/{startYear}/{endYear}
Povijesni razvoj PolitPro izbornog trenda za odabrane godine. Izborni trend se jednom tjedno sprema kao mjerna točka. Povijesni podaci dostupni su najranije od 2019. godine, ovisno o parlamentu.
?format=poll Neobvezni URL parametar. Prikazuje povijesne podatke kao ankete.
?format=party Neobvezni URL parametar. Prikazuje povijesne podatke kao skup vrijednosti po stranci.
Preporučena ažuriranja: Jednom tjedno
Webhook događaj 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 } ] } ] } }

Krajnja točka: Najnovije izborne ankete
https://politpro.eu/api/v1/{countryCode}/polls/latest
Pet najnovijih parlamentarnih izbornih anketa, poredanih kronološki silazno. Mjerodavan je zadnji dan razdoblja anketiranja.
diff Usporedba s prethodnom anketom instituta
election_diff Usporedba s prethodnim izborima
Preporučena ažuriranja: Svakih 12 sati
Webhook događaj 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 } ] } ] } }

Krajnja točka: Najnovija anketa po institutu
https://politpro.eu/api/v1/{countryCode}/polls/institutes
Najnovija anketa svakog instituta koji je objavio rezultate istraživanja u posljednjih 365 dana. Mjerodavan je posljednji dan razdoblja anketiranja.
diff Usporedba s prethodnom anketom instituta
election_diff Usporedba s prethodnim izborima
score Ako je dostupno: PolitPro ocjena (0-100) instituta za preciznost, temeljena na povijesnim predizbornim anketama i pristranosti prema strankama.
Preporučena ažuriranja: Svakih 12 sati
Webhook događaj 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 } ] } ] } }

Kako funkcionira web-hook?

Putem web-hooka automatski obavještavamo vaš server o novim podacima. Struktura svake obavijesti odgovara strukturi dotične krajnje točke, dopunjena dodatnim poljem za vrstu događaja.

Postavljanje

Unesite URL vašeg servera u postavkama vašeg PolitPro računa. Opcionalno, tamo možete kreirati i tajni ključ web-hooka (Webhook Secret) pomoću kojeg možete provjeriti autentičnost naših prijenosa podataka.

Isporuka i format odgovora

Ako vaš server ne odgovori s "OK", isporuka se smatra neuspješnom. U tom slučaju, pokušat ćemo isporuku ponoviti do pet puta.

Provjera autentičnosti podataka

Svaka obavijest u zaglavlju sadrži polje "X-Webhook-Signature". Ono sadrži HMAC-SHA256 potpis sadržaja poruke, izračunat pomoću vašeg tajnog ključa web-hooka (Webhook Secret) kao ključa. Izračunajte potpis na vašoj strani na isti način (HMAC-SHA256 preko cijele obavijesti) i usporedite ga s poslanom vrijednošću kako biste osigurali da podaci zaista potječu od nas i da nisu mijenjani u tranzitu.

Autentifikacija

Autentifikacija se provodi putem Bearer tokena u zaglavlju: "Authorization: Bearer {token}". Token možete pronaći nakon registracije u postavkama vašeg PolitPro računa.

Maks. zahtjeva po minuti

API dopušta maksimalno 30 zahtjeva po minuti. U slučaju prekoračenja, vraća se kod pogreške 429.

Gdje mogu pronaći svoj API ključ?

Svoj API ključ možete pronaći u postavkama vašeg PolitPro računa.