PolitPro

Til udviklere og redaktioner API til meningsmålinger og valgtrends

Dette er PolitPro API'en

Hvem er API'en egnet til?

API'en henvender sig til mediehuse, forlag, tænketanke, dataleverandører og udviklere, der ønsker at integrere politiske meningsmålingsdata og Valgtrends i egne produkter, platforme eller analyser.

Hvordan må jeg bruge dataene?

Dataene må bruges redaktionelt, i egne produkter og til egne kunder. Det er ikke tilladt at opbygge en selvstændig platform, hvis kerneprodukt er politiske meningsmålingsdata, Valgtrends eller lignende konkurrerende tilbud til PolitPro. Kontakt os via kontaktformularen nedenfor for at få mere at vide om, hvordan vi bedst kan hjælpe dig.

Hvilke data leverer API'en?

API'en leverer aktuelle Valgtrends, historiske trendudviklinger samt rådata fra individuelle valgmeningsmålinger for mere end 70 parlamenter – opdelt efter aktualitet eller meningsmålingsinstitut. Data opdateres så hurtigt som muligt efter offentliggørelse af nye meningsmålinger. Den aktuelle Valgtrend genberegnes med hver ny meningsmåling. Historiske trenddata registreres én gang ugentligt som et datapunkt.

Hvilke parlamenter er tilgængelige?

API'en understøtter følgende landekoder:
AD – Andorra
AL – Albanien
AM – Armenien
AT – Østrig
AT-1 – Burgenland
AT-2 – Kärnten
AT-3 – Niederösterreich
AT-4 – Oberösterreich
AT-5 – Salzburg
AT-6 – Steiermark
AT-7 – Tyrol
AT-8 – Vorarlberg
AT-9 – Wien
BE – Belgien
BE-BR – Bruxelles
BE-VL – Flandern
BE-WA – Vallonien
BG – Bulgarien
CH – Schweiz
CY – Cypern
CZ – Tjekkiet
DE – Tyskland
DE-BB – Brandenburg
DE-BE – Berlin
DE-BW – Baden-Württemberg
DE-BY – Bayern
DE-HB – Bremen
DE-HE – Hessen
DE-HH – Hamborg
DE-MV – Mecklenburg-Vorpommern
DE-NI – Niedersachsen
DE-NW – Nordrhein-Westfalen
DE-RP – Rheinland-Pfalz
DE-SH – Slesvig-Holsten
DE-SL – Saarland
DE-SN – Sachsen
DE-ST – Sachsen-Anhalt
DE-TH – Thüringen
DK – Danmark
EE – Estland
ES – Spanien
FI – Finland
FR – Frankrig
GB – Storbritannien
GE – Georgien
GR – Grækenland
HR – Kroatien
HU – Ungarn
IE – Irland
IS – Island
IT – Italien
LT – Litauen
LU – Luxembourg
LV – Letland
MD – Moldova
ME – Montenegro
MK – Nordmakedonien
MT – Malta
NL – Holland
NO – Norge
PL – Polen
PT – Portugal
RO – Rumænien
RU – Rusland
SE – Sverige
SI – Slovenien
SK – Slovakiet
TR – Tyrkiet
UA – Ukraine
XK – Kosovo

Hvor pålidelige er dataene?

Alle data gennemgår en flertrins kvalitetskontrol bestående af algoritmer, AI og manuel kontrol. PolitPro betragtes som en af de mest pålidelige kilder til europæiske Valgtrends – brugt af internationale medier, forskningsinstitutioner og politiske institutioner. Alle data uden garanti.

Justeres historiske datapunkter efterfølgende?

Historiske data kan til enhver tid og uden forudgående varsel justeres. Korrektioner foretages f.eks. ved udvidelse af vores datasæt med aktuelle og historiske data, ændringer i vægtningsmetoden eller fejlrettelser. Da vi løbende udvider vores datasæt, anbefaler vi at hente historiske data regelmæssigt i stedet for at behandle dem som et statisk datasæt.

Skal jeg angive PolitPro som kilde?

Ja, ved enhver offentlig visning af data er en kildeangivelse med link til PolitPro.eu påkrævet, f.eks. "Kilde: PolitPro.eu".

Hvad er PolitPro Valgtrend?

PolitPro Valgtrend aggregerer meningsmålingsresultaterne fra alle relevante institutter til et vægtet gennemsnit. Aktuelle meningsmålinger vægtes højere end ældre, og institutternes historiske prognosenøjagtighed indgår også. Resultatet er en statistisk pålidelig trendlinje, der udjævner kortsigtede udsving og synliggør den reelle politiske dynamik over tid.

Hvad er PolitPro?

PolitPro er Europas førende platform for Valgtrends og politiske meningsmålingsdata. Internationale medier, politiske institutioner samt universiteter og forskningsinstitutioner bruger allerede vores data i deres daglige arbejde. PolitPro er politisk uafhængig og kombinerer offentlige meningsmålingsdata og videnskabelige datasæt med egne algoritmer.

Anmod uforpligtende nu

API'ets endpoints

Endepunkt: Aktuel Valgtrend

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

Den aktuelle PolitPro Valgtrend for parlamentet beregner en vægtet gennemsnitsværdi af aktuelle meningsmålinger.

diff
Sammenligning med sidste målepunkt fra den foregående uge
election_diff
Sammenligning med det seneste valg
Anbefalede opdateringer: Hver 12. time Webhook-begivenhed: 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
                }
            ]
        }
    }
}

Endepunkt: Udvikling af Valgtrenden

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

Historisk udvikling af PolitPro Valgtrend for de valgte år. Valgtrenden gemmes én gang om ugen som et målepunkt. Historiske data er tilgængelige fra tidligst 2019, afhængigt af parlamentet.

?format=poll
Valgfri URL-parameter. Viser historiske data som meningsmålinger
?format=party
Valgfri URL-parameter. Viser historiske data som en samling af værdier efter parti
Anbefalede opdateringer: Én gang om ugen Webhook-begivenhed: 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
                    }
                ]
            }
        ]
    }
}

Endepunkt: Seneste valgmeningsmålinger

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

De fem seneste valgmeningsmålinger for parlamentet, sorteret faldende efter tid. Den sidste dag i spørgeperioden er afgørende.

diff
Sammenligning med instituttets tidligere meningsmåling
election_diff
Sammenligning med det tidligere valg
Anbefalede opdateringer: Hver 12. time Webhook-begivenhed: 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
                    }
                ]
            }
        ]
    }
}

Endepunkt: Seneste meningsmåling efter institut

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

Den seneste meningsmåling fra hvert institut, der har offentliggjort meningsmålingsresultater inden for de seneste 365 dage. Den sidste dag i spørgeperioden er afgørende.

diff
Sammenligning med instituttets tidligere meningsmåling
election_diff
Sammenligning med det tidligere valg
score
Hvis tilgængelig: PolitPro Score (0-100) for instituttets nøjagtighed baseret på historiske meningsmålinger før valg og partiskhed.
Anbefalede opdateringer: Hver 12. time Webhook-begivenhed: 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: Få nye data automatisk

Hvordan fungerer Webhook'en?

Via Webhook informerer vi automatisk din server om nye data. Strukturen for hver notifikation svarer til det respektive endepunkt, suppleret med et ekstra felt for eventtypen.

Opsætning

Indtast URL'en til din server i indstillingerne for din PolitPro-konto. Du kan eventuelt også oprette et Webhook Secret der, som du kan bruge til at verificere ægtheden af vores dataoverførsler.

Levering & Svarformat

Hvis din server ikke svarer med "OK", betragtes leveringen som mislykket. I dette tilfælde forsøger vi at levere igen op til fem gange.

Verifikation af data

Hver notifikation indeholder feltet "X-Webhook-Signature" i headeren. Det indeholder en HMAC-SHA256-signatur af meddelelsens indhold, beregnet med dit Webhook Secret som nøgle. Beregn signaturen på din side på samme måde (HMAC-SHA256 over hele notifikationen) og sammenlign den med den overførte værdi for at sikre, at dataene faktisk stammer fra os og ikke er blevet ændret undervejs.

Autentificering og grænser

Autentificering

Autentificering sker via Bearer Token i headeren: "Authorization: Bearer {token}". Tokenet finder du efter registrering i indstillingerne for din PolitPro-konto.

Maks. anmodninger pr. minut

API'en tillader maksimalt 30 anmodninger pr. minut. Ved overskridelse returneres fejlkode 429.

Hvor finder jeg min API-nøgle?

Din API-nøgle finder du i indstillingerne for din PolitPro-konto.