To je PolitPro API

Komu je API namenjen?

API je namenjen medijskim hišam, založnikom, think tankom, ponudnikom podatkov in razvijalcem, ki želijo politične podatke anket in volilne trende integrirati v lastne izdelke, platforme ali analize.

Kako lahko uporabljam podatke?

Podatki se lahko uporabljajo v uredniške namene, v lastnih izdelkih in za lastne stranke. Ni dovoljeno vzpostaviti samostojne platforme, katere osrednji produkt bi bili podatki političnih anket, volilni trendi ali primerljive konkurenčne ponudbe PolitPro. Za več informacij o tem, kako vas lahko najbolje podpremo, nas kontaktirajte preko spodnjega kontaktnega obrazca.

Katere podatke zagotavlja API?

API zagotavlja aktualne volilne trende, razvoj zgodovinskih trendov in surove podatke posameznih volilnih anket za več kot 70 parlamentov – razčlenjeno po aktualnosti ali anketnem inštitutu. Podatki se posodabljajo čim hitreje po objavi novih anket. Trenutni volilni trend se ponovno izračuna z vsako novo anketo. Zgodovinski podatki o trendih se enkrat tedensko zabeležijo kot podatkovna točka.

Kateri parlamenti so na voljo?

AD - Andora
AL - Albanija
AM - Armenija
AT - Avstrija
AT-1 - Gradiščansko
AT-2 - Koroška
AT-3 - Spodnja Avstrija
AT-4 - Zgornja Avstrija
AT-5 - Salzburg
AT-6 - Štajerska
AT-7 - Tirolska
AT-8 - Predarlska
AT-9 - Dunaj
BE - Belgija
BE-BR - Bruselj
BE-VL - Flandrija
BE-WA - Valonija
BG - Bolgarija
CH - Švica
CY - Ciper
CZ - Češka
DE - Nemčija
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-Predpomorjansko
DE-NI - Spodnja Saška
DE-NW - Severno Porenje-Vestfalija
DE-RP - Porenje-Pfalška
DE-SH - Schleswig-Holstein
DE-SL - Posarje
DE-SN - Saška
DE-ST - Saška-Anhalt
DE-TH - Turingija
DK - Danska
EE - Estonija
ES - Španija
FI - Finska
FR - Francija
GB - Velika Britanija
GE - Gruzija
GR - Grčija
HR - Hrvaška
HU - Madžarska
IE - Irska
IS - Islandija
IT - Italija
LT - Litva
LU - Luksemburg
LV - Latvija
MD - Moldavija
ME - Črna gora
MK - Severna Makedonija
MT - Malta
NL - Nizozemska
NO - Norveška
PL - Poljska
PT - Portugalska
RO - Romunija
RU - Rusija
SE - Švedska
SI - Slovenija
SK - Slovaška
TR - Turčija
UA - Ukrajina
XK - Kosovo

Kako zanesljivi so podatki?

Vsi podatki so podvrženi večstopenjskemu preverjanju kakovosti, ki vključuje algoritme, umetno inteligenco in ročni nadzor. PolitPro velja za enega najzanesljivejših virov za evropske volilne trende, ki ga uporabljajo mednarodni mediji, raziskovalne ustanove in politične institucije. Podatki so zgolj informativne narave.

Ali se zgodovinski podatki naknadno prilagajajo?

Zgodovinski podatki se lahko kadar koli in brez predhodnega obvestila posodobijo. Popravki vključujejo, na primer, razširitev naših naborov podatkov z aktualnimi in zgodovinskimi informacijami, spremembe metodologije uteževanja ali odpravljanje napak. Ker nenehno širimo naše nabore podatkov, priporočamo, da zgodovinske podatke redno ponovno pridobivate, namesto da bi jih obravnavali kot statičen nabor podatkov.

Ali moram PolitPro navesti kot vir?

Da, ob vsaki javni predstavitvi podatkov je obvezna navedba vira s povezavo na PolitPro.eu, npr. "Vir: PolitPro.eu".

Kaj je volilni trend PolitPro?

Volilni trend PolitPro združuje rezultate anket vseh relevantnih inštitutov v tehtano povprečno vrednost. Aktualne ankete so močneje ponderirane kot starejše, upošteva pa se tudi zgodovinska napovedna natančnost inštitutov. Rezultat je statistično zanesljiva trendna črta, ki izravnava kratkoročne odklone in prikazuje resnično politično dinamiko skozi čas.

Kaj je PolitPro?

PolitPro je vodilna evropska platforma za volilne trende in podatke političnih anket. Mednarodni mediji, politične institucije ter univerze in raziskovalne ustanove že uporabljajo naše podatke pri svojem vsakdanjem delu. PolitPro je politično neodvisen in združuje javne podatke anket ter znanstvene zbirke podatkov z lastnimi algoritmi.

Oddajte nezavezujoče povpraševanje

Ime
Podjetje
E-pošta
Kako želite uporabiti podatke?
Kratek opis

Končne točke in tehnične podrobnosti

Končna točka: Trenutni volilni trend
https://politpro.eu/api/v1/{countryCode}/trend
Trenutni volilni trend PolitPro za parlament izračuna tehtano povprečje aktualnih anket o nedeljskem vprašanju.
diff Primerjava z zadnjo merilno točko prejšnjega tedna
election_diff Primerjava z zadnjimi volitvami
Priporočene posodobitve: Vsakih 12 ur
Dogodek spletne kljuke 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 } ] } } }

Končna točka: Razvoj volilnega trenda
https://politpro.eu/api/v1/{countryCode}/trend/history/{startYear}/{endYear}
Zgodovinski razvoj volilnega trenda PolitPro za izbrana leta. Volilni trend se enkrat tedensko shrani kot merilna točka. Zgodovinski podatki so na voljo najprej od leta 2019, odvisno od parlamenta.
?format=poll Neobvezen URL parameter. Prikazuje zgodovinske podatke kot ankete.
?format=party Neobvezen URL parameter. Prikazuje zgodovinske podatke kot zbirko vrednosti po strankah.
Priporočene posodobitve: Enkrat tedensko
Dogodek spletne kljuke 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 } ] } ] } }

Končna točka: Najnovejše volilne ankete
https://politpro.eu/api/v1/{countryCode}/polls/latest
Pet najnovejših parlamentarnih volilnih anket, razvrščenih po datumu od najnovejših do najstarejših. Ključen je zadnji dan anketnega obdobja.
diff Primerjava s prejšnjo raziskavo inštituta
election_diff Primerjava s prejšnjimi volitvami
Priporočene posodobitve: Vsakih 12 ur
Dogodek spletne kljuke 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 } ] } ] } }

Končna točka: Najnovejša anketa po inštitutu
https://politpro.eu/api/v1/{countryCode}/polls/institutes
Najnovejša anketa vsakega inštituta, ki je v zadnjih 365 dneh objavil rezultate anket. Merodajen je zadnji dan obdobja anketiranja.
diff Primerjava s prejšnjo raziskavo inštituta
election_diff Primerjava s prejšnjimi volitvami
score Če je na voljo: PolitPro ocena (0-100) inštituta za natančnost, ki temelji na zgodovinskih predvolilnih anketah in pristranskosti do strank.
Priporočene posodobitve: Vsakih 12 ur
Dogodek spletne kljuke 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 deluje spletna kljuka?

Prek spletne kljuke vaš strežnik samodejno obveščamo o novih podatkih. Struktura vsakega obvestila ustreza strukturi zadevne končne točke, dopolnjena z dodatnim poljem za vrsto dogodka.

Nastavitev

URL vašega strežnika vnesite v nastavitvah vašega PolitPro računa. Po želji lahko tam ustvarite tudi skrivnost spletne kljuke (Webhook Secret), s katero lahko preverite pristnost naših prenosov podatkov.

Dostava in format odgovora

Če vaš strežnik ne odgovori z »OK«, se dostava šteje za neuspešno. V tem primeru bomo poskusili dostavo ponovno do petkrat.

Preverjanje pristnosti podatkov

Vsako obvestilo v glavi (headerju) vsebuje polje »X-Webhook-Signature«. Vsebuje HMAC-SHA256 podpis vsebine sporočila, izračunan z vašo skrivnostjo spletne kljuke (Webhook Secret) kot ključem. Podpis na vaši strani izračunajte na enak način (HMAC-SHA256 nad celotnim obvestilom) in ga primerjajte s posredovano vrednostjo, da zagotovite, da podatki dejansko izvirajo od nas in niso bili spremenjeni med prenosom.

Avtentikacija

Avtentikacija poteka z uporabo Bearer žetona v glavi: "Authorization: Bearer {token}". Žeton najdete po registraciji v nastavitvah vašega PolitPro računa.

Največje število zahtevkov na minuto

API dovoljuje največ 30 zahtev na minuto. V primeru prekoračitve se vrne koda napake 429.

Kje najdem svoj API ključ?

Svoj API ključ najdete v nastavitvah vašega PolitPro računa.