PolitPro

Pro vývojáře a redakce API pro politické průzkumy, volební trendy a volební modely

Toto je API PolitPro

Pro koho je API vhodné?

API je určeno pro mediální domy, vydavatelství, think tanky, poskytovatele dat a vývojáře, kteří chtějí integrovat politické průzkumy a volební trendy do vlastních produktů, platforem nebo analýz.

Jak mohu data používat?

Data mohou být použita redakčně, ve vlastních produktech a pro vlastní zákazníky. Není povoleno vytvářet samostatnou platformu, jejímž hlavním produktem jsou politické průzkumy, volební trendy nebo srovnatelné konkurenční nabídky k PolitPro. Kontaktujte nás prostřednictvím kontaktního formuláře níže, abyste se dozvěděli více o tom, jak vás můžeme nejlépe podpořit.

Jaká data API poskytuje?

API poskytuje aktuální Volební trendy, historický vývoj trendů a nezpracovaná data jednotlivých volebních průzkumů pro více než 70 parlamentů – rozděleno podle aktuálnosti nebo výzkumné agentury. Data jsou aktualizována co nejdříve po zveřejnění nových průzkumů. Aktuální Volební trend je přepočítáván s každým novým průzkumem. Historická data trendů jsou zaznamenávána jednou týdně jako datový bod.

Které parlamenty jsou k dispozici?

API podporuje následující kódy zemí:
AD – Andorra
AL – Albánie
AM – Arménie
AT – Rakousko
AT-1 – Burgenland
AT-2 – Korutany
AT-3 – Dolní Rakousy
AT-4 – Horní Rakousy
AT-5 – Salcbursko
AT-6 – Štýrsko
AT-7 – Tyrolsko
AT-8 – Vorarlbersko
AT-9 – Vídeň
BE – Belgie
BE-BR – Brusel
BE-VL – Vlámsko
BE-WA – Valonsko
BG – Bulharsko
CH – Švýcarsko
CY – Kypr
CZ – Česko
DE – Německo
DE-BB – Braniborsko
DE-BE – Berlín
DE-BW – Bádensko-Württembersko
DE-BY – Bavorsko
DE-HB – Brémy
DE-HE – Hesensko
DE-HH – Hamburk
DE-MV – Mecklenburgo-Přední Pomořansko
DE-NI – Dolní Sasko
DE-NW – Severní Porýní-Vestfálsko
DE-RP – Porýní-Falc
DE-SH – Šlesvicko-Holštýnsko
DE-SL – Sársko
DE-SN – Sasko
DE-ST – Sasko-Anhaltsko
DE-TH – Durynsko
DK – Dánsko
EE – Estonsko
ES – Španělsko
FI – Finsko
FR – Francie
GB – Velká Británie
GE – Gruzie
GR – Řecko
HR – Chorvatsko
HU – Maďarsko
IE – Irsko
IS – Island
IT – Itálie
LT – Litva
LU – Lucembursko
LV – Lotyšsko
MD – Moldavsko
ME – Černá Hora
MK – Severní Makedonie
MT – Malta
NL – Nizozemsko
NO – Norsko
PL – Polsko
PT – Portugalsko
RO – Rumunsko
RU – Rusko
SE – Švédsko
SI – Slovinsko
SK – Slovensko
TR – Turecko
UA – Ukrajina
XK – Kosovo

Jak spolehlivá jsou data?

Všechna data procházejí vícestupňovou kontrolou kvality skládající se z algoritmů, AI a manuální kontroly. PolitPro je považováno za jeden z nejspolehlivějších zdrojů evropských Volebních trendů – využívaný mezinárodními médii, výzkumnými institucemi a politickými institucemi. Všechna data bez záruky.

Jsou historické datové body dodatečně upravovány?

Historická data mohou být kdykoli a bez předchozího upozornění upravena. Opravy probíhají např. rozšířením našich datových sad o aktuální a historická data, změnami metodiky vážení nebo opravami chyb. Jelikož naše datové sady neustále rozšiřujeme, doporučujeme historická data pravidelně znovu načítat, namísto aby byla považována za statickou datovou sadu.

Musím uvádět PolitPro jako zdroj?

Ano, při každém veřejném zobrazení dat je vyžadováno uvedení zdroje s odkazem na PolitPro.eu, např. „Zdroj: PolitPro.eu“.

Co je volební trend PolitPro?

Volební trend PolitPro agreguje výsledky průzkumů všech relevantních institutů do váženého průměru. Aktuální průzkumy jsou váženy silněji než starší a zohledňuje se také historická přesnost prognóz institutů. Výsledkem je statisticky spolehlivá trendová linie, která vyhlazuje krátkodobé odchylky a vizualizuje skutečnou politickou dynamiku v čase.

Co je PolitPro?

PolitPro je přední evropská platforma pro Volební trendy a data z politických průzkumů. Mezinárodní média, politické instituce, univerzity a výzkumné instituce již naše data využívají ve své každodenní práci. PolitPro je politicky nezávislé a kombinuje veřejná data z průzkumů a vědecké datové sady s vlastními algoritmy.

Nezávazně poptat nyní

Endpointy API

Koncový bod: Aktuální Volební trend

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

Aktuální Volební trend PolitPro parlamentu vypočítává vážený průměr aktuálních volebních modelů.

diff
Srovnání s posledním měřicím bodem z předchozího týdne
election_diff
Srovnání s posledními volbami
Doporučené aktualizace: Každých 12 hodin Webhook událost: 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

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

Historický vývoj Volebního trendu PolitPro pro vybrané roky. Volební trend je ukládán jednou týdně jako měřicí bod. Historická data jsou k dispozici nejdříve od roku 2019, v závislosti na parlamentu.

?format=poll
Volitelný URL parametr. Zobrazuje historická data jako průzkumy
?format=party
Volitelný URL parametr. Zobrazuje historická data jako sbírku hodnot podle strany
Doporučené aktualizace: Jednou týdně Webhook událost: 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: Nejnovější volební průzkumy

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

Pět nejnovějších volebních průzkumů parlamentu, seřazených časově sestupně. Rozhodující je poslední den období průzkumu.

diff
Srovnání s předchozím průzkumem agentury
election_diff
Srovnání s předchozími volbami
Doporučené aktualizace: Každých 12 hodin Webhook událost: 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: Nejnovější průzkum podle agentury

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

Nejnovější průzkum každé agentury, která zveřejnila výsledky průzkumů za posledních 365 dní. Rozhodující je poslední den období průzkumu.

diff
Srovnání s předchozím průzkumem agentury
election_diff
Srovnání s předchozími volbami
score
Pokud je k dispozici: PolitPro skóre (0-100) agentury pro přesnost na základě historických předvolebních průzkumů a stranické zaujatosti.
Doporučené aktualizace: Každých 12 hodin Webhook událost: 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: získávejte nová data automaticky

Jak funguje webhook?

Prostřednictvím webhooku automaticky informujeme váš server o nových datech. Struktura každého oznámení odpovídá struktuře příslušného koncového bodu, doplněná o další pole pro typ události.

Nastavení

Uložte URL adresu svého serveru v nastavení svého účtu PolitPro. Volitelně zde můžete také vytvořit Webhook Secret, pomocí kterého můžete ověřit pravost našich datových přenosů.

Doručení a formát odpovědi

Pokud váš server neodpoví "OK", doručení se považuje za neúspěšné. V takovém případě se pokusíme o doručení až pětkrát znovu.

Ověření dat

Každé oznámení obsahuje v hlavičce pole "X-Webhook-Signature". Obsahuje HMAC-SHA256 podpis obsahu zprávy, vypočítaný s vaším Webhook Secret jako klíčem. Vypočítejte podpis na své straně stejným způsobem (HMAC-SHA256 přes celé oznámení) a porovnejte jej s odeslanou hodnotou, abyste se ujistili, že data skutečně pocházejí od nás a nebyla během přenosu změněna.

Autentizace a limity

Autentizace

Autentizace probíhá pomocí Bearer tokenu v hlavičce: "Authorization: Bearer {token}". Token naleznete po registraci v nastavení svého účtu PolitPro.

Max. požadavků za minutu

API umožňuje maximálně 30 požadavků za minutu. Při překročení bude vrácen chybový kód 429.

Kde najdu svůj API klíč?

Svůj API klíč naleznete v nastavení svého účtu PolitPro.