Toto je API PolitPro

Pre koho je API vhodné?

API je určené pre mediálne domy, vydavateľstvá, think tanky, poskytovateľov dát a vývojárov, ktorí chcú integrovať dáta z politických prieskumov a volebné trendy do vlastných produktov, platforiem alebo analýz.

Ako môžem dáta používať?

Dáta môžu byť použité redakčne, vo vlastných produktoch a pre vlastných klientov. Nie je povolené vytvárať samostatnú platformu, ktorej hlavným produktom sú politické prieskumy, volebné trendy alebo porovnateľné konkurenčné ponuky k PolitPro. Kontaktujte nás prostredníctvom kontaktného formulára nižšie, aby ste sa dozvedeli viac o tom, ako vás môžeme čo najlepšie podporiť.

Aké dáta poskytuje API?

API poskytuje aktuálne volebné trendy, historický vývoj trendov, ako aj surové dáta z jednotlivých volebných prieskumov pre viac ako 70 parlamentov – rozdelené podľa aktuálnosti alebo prieskumnej agentúry. Dáta sa aktualizujú čo najskôr po zverejnení nových prieskumov. Aktuálny volebný trend sa prepočítava s každým novým prieskumom. Historické trendové dáta sa zaznamenávajú raz týždenne ako dátový bod.

Ktoré parlamenty sú k dispozícii?

AD - Andorra
AL - Albánsko
AM - Arménsko
AT - Rakúsko
AT-1 - Burgenland
AT-2 - Korutánsko
AT-3 - Dolné Rakúsko
AT-4 - Horné Rakúsko
AT-5 - Salzbursko
AT-6 - Štajersko
AT-7 - Tirolsko
AT-8 - Vorarlbersko
AT-9 - Viedeň
BE - Belgicko
BE-BR - Brusel
BE-VL - Flámsko
BE-WA - Valónsko
BG - Bulharsko
CH - Švajčiarsko
CY - Cyprus
CZ - Česko
DE - Nemecko
DE-BB - Brandenbursko
DE-BE - Berlín
DE-BW - Bádensko-Württembersko
DE-BY - Bavorsko
DE-HB - Brémy
DE-HE - Hesensko
DE-HH - Hamburg
DE-MV - Meklenbursko-Predpomoransko
DE-NI - Dolné Sasko
DE-NW - Severné Porýnie-Vestfálsko
DE-RP - Porýnie-Falcko
DE-SH - Schleswig-Holstein
DE-SL - Sársko
DE-SN - Sasko
DE-ST - Sasko-Anhaltsko
DE-TH - Durínsko
DK - Dánsko
EE - Estónsko
ES - Španielsko
FI - Fínsko
FR - Francúzsko
GB - Veľká Británia
GE - Gruzínsko
GR - Grécko
HR - Chorvátsko
HU - Maďarsko
IE - Írsko
IS - Island
IT - Taliansko
LT - Litva
LU - Luxembursko
LV - Lotyšsko
MD - Moldavsko
ME - Čierna Hora
MK - Severné Macedónsko
MT - Malta
NL - Holandsko
NO - Nórsko
PL - Poľsko
PT - Portugalsko
RO - Rumunsko
RU - Rusko
SE - Švédsko
SI - Slovinsko
SK - Slovensko
TR - Turecko
UA - Ukrajina
XK - Kosovo

Aká je spoľahlivosť dát?

Všetky údaje prechádzajú viacstupňovou kontrolou kvality, ktorá kombinuje algoritmy, umelú inteligenciu (AI) a manuálny dohľad. PolitPro patrí medzi najspoľahlivejšie zdroje pre európske volebné trendy – využívané medzinárodnými médiami, výskumnými inštitúciami a politickými inštitúciami. Všetky údaje bez záruky.

Upravujú sa historické dátové body dodatočne?

Historické dáta môžu byť upravené kedykoľvek a bez predchádzajúceho upozornenia. Opravy sa vykonávajú napríklad rozšírením našich dátových súborov o aktuálne a historické dáta, zmenami v metodike váženia alebo opravami chýb. Keďže naše dátové súbory neustále rozširujeme, odporúčame historické dáta pravidelne nanovo sťahovať, namiesto toho, aby ste ich považovali za statický dátový súbor.

Musím uviesť PolitPro ako zdroj?

Áno, pri každom verejnom zobrazení dát je potrebné uviesť zdroj s odkazom na PolitPro.eu, napr. „Zdroj: PolitPro.eu“.

Čo je volebný trend PolitPro?

Volebný trend PolitPro agreguje výsledky prieskumov všetkých relevantných inštitútov do váženého priemeru. Aktuálne prieskumy sú vážené silnejšie ako staršie a zohľadňuje sa aj historická presnosť predpovedí inštitútov. Výsledkom je štatisticky spoľahlivá trendová línia, ktorá vyhladzuje krátkodobé odchýlky a zviditeľňuje skutočnú politickú dynamiku v čase.

Čo je PolitPro?

PolitPro je popredná európska platforma pre volebné trendy a dáta z politických prieskumov. Medzinárodné médiá, politické inštitúcie, ako aj univerzity a výskumné centrá už využívajú naše dáta vo svojej každodennej práci. PolitPro je politicky nezávislé a kombinuje verejné dáta z prieskumov a vedecké súbory dát s vlastnými algoritmami.

Nezáväzne požiadať teraz

Meno
Firma
E-mail
Ako majú byť dáta využité?
Krátky popis

Koncové body a technické detaily

Koncový bod: Aktuálny volebný trend
https://politpro.eu/api/v1/{countryCode}/trend
Aktuálny volebný trend PolitPro pre parlament vypočítava vážený priemer aktuálnych prieskumov verejnej mienky.
diff Porovnanie s posledným meraním z predchádzajúceho týždňa
election_diff Porovnanie s poslednými voľbami
Odporúčané aktualizácie: Každých 12 hodín
Webhook udalosť 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 } ] } } }

Koncový bod: Vývoj volebného trendu
https://politpro.eu/api/v1/{countryCode}/trend/history/{startYear}/{endYear}
Historický vývoj volebného trendu PolitPro za vybrané roky. Volebný trend sa ukladá raz týždenne ako merací bod. Historické dáta sú dostupné najskôr od roku 2019, v závislosti od parlamentu.
?format=poll Voliteľný URL parameter. Zobrazuje historické dáta ako prieskumy.
?format=party Voliteľný URL parameter. Zobrazuje historické dáta ako súbor hodnôt podľa politickej strany.
Odporúčané aktualizácie: Raz týždenne
Webhook udalosť 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 } ] } ] } }

Koncový bod: Najnovšie volebné prieskumy
https://politpro.eu/api/v1/{countryCode}/polls/latest
Päť najnovších volebných prieskumov parlamentu, zoradených chronologicky zostupne. Rozhodujúci je posledný deň obdobia prieskumu.
diff Porovnanie s predchádzajúcim prieskumom inštitútu
election_diff Porovnanie s predchádzajúcimi voľbami
Odporúčané aktualizácie: Každých 12 hodín
Webhook udalosť 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 } ] } ] } }

Koncový bod: Najnovší prieskum podľa inštitútu
https://politpro.eu/api/v1/{countryCode}/polls/institutes
Najnovší prieskum od každého inštitútu, ktorý zverejnil výsledky prieskumov za posledných 365 dní. Rozhodujúci je posledný deň obdobia zberu dát.
diff Porovnanie s predchádzajúcim prieskumom inštitútu
election_diff Porovnanie s predchádzajúcimi voľbami
score Ak je k dispozícii: PolitPro Skóre (0-100) inštitútu pre presnosť na základe historických predvolebných prieskumov a straníckej zaujatosti.
Odporúčané aktualizácie: Každých 12 hodín
Webhook udalosť 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 } ] } ] } }

Ako funguje webhook?

Prostredníctvom webhooku automaticky informujeme váš server o nových dátach. Štruktúra každého oznámenia zodpovedá štruktúre príslušného koncového bodu, doplnená o dodatočné pole pre typ udalosti.

Nastavenie

URL vášho servera zadajte v nastaveniach vášho účtu PolitPro. Voliteľne si tam môžete vytvoriť aj tajný kľúč webhooku (Webhook Secret), pomocou ktorého môžete overiť pravosť našich dátových prenosov.

Doručenie a formát odpovede

Ak váš server neodpovie s „OK“, doručenie sa považuje za neúspešné. V takom prípade sa pokúsime o doručenie až päťkrát.

Overenie dát

Každé oznámenie obsahuje v hlavičke pole „X-Webhook-Signature“. Obsahuje HMAC-SHA256 podpis obsahu správy, vypočítaný pomocou vášho tajného kľúča webhooku (Webhook Secret) ako kľúča. Vypočítajte podpis na vašej strane rovnakým spôsobom (HMAC-SHA256 pre celé oznámenie) a porovnajte ho s odoslanou hodnotou, aby ste sa uistili, že dáta skutočne pochádzajú od nás a neboli počas prenosu zmenené.

Autentifikácia

Autentifikácia prebieha pomocou Bearer Tokenu v hlavičke: "Authorization: Bearer {token}". Token nájdete po registrácii v nastaveniach vášho účtu PolitPro.

Max. požiadaviek za minútu

API umožňuje maximálne 30 požiadaviek za minútu. Pri prekročení tohto limitu sa vráti chybový kód 429.

Kde nájdem svoj API kľúč?

Svoj API kľúč nájdete v nastaveniach vášho účtu PolitPro.