Dit is de PolitPro API

Voor wie is de API geschikt?

De API is bedoeld voor mediabedrijven, uitgeverijen, denktanks, data-aanbieders en ontwikkelaars die politieke peilingsgegevens en verkiezingstrends willen integreren in hun eigen producten, platforms of analyses.

Hoe mag ik de gegevens gebruiken?

De gegevens mogen redactioneel, in eigen producten en voor eigen klanten worden gebruikt. Het is niet toegestaan om een zelfstandig platform op te bouwen waarvan het kernproduct politieke peilinggegevens, verkiezingstrends of vergelijkbare concurrerende aanbiedingen van PolitPro zijn. Neem contact met ons op via het onderstaande contactformulier om te ontdekken hoe we je het beste kunnen ondersteunen.

Welke gegevens levert de API?

De API levert actuele verkiezingstrends, historische trendontwikkelingen en ruwe data van individuele peilingen voor meer dan 70 parlementen – uitgesplitst naar actualiteit of peilingsinstituut. De gegevens worden zo snel mogelijk na publicatie van nieuwe peilingen bijgewerkt. De actuele verkiezingstrend wordt met elke nieuwe peiling opnieuw berekend. Historische trendgegevens worden wekelijks als datapunt vastgelegd.

Welke parlementen zijn beschikbaar?

AD - Andorra
AL - Albanië
AM - Armenië
AT - Oostenrijk
AT-1 - Burgenland
AT-2 - Karinthië
AT-3 - Neder-Oostenrijk
AT-4 - Opper-Oostenrijk
AT-5 - Salzburg
AT-6 - Stiermarken
AT-7 - Tirol
AT-8 - Vorarlberg
AT-9 - Wenen
BE - België
BE-BR - Brussel
BE-VL - Vlaanderen
BE-WA - Wallonië
BG - Bulgarije
CH - Zwitserland
CY - Cyprus
CZ - Tsjechië
DE - Duitsland
DE-BB - Brandenburg
DE-BE - Berlijn
DE-BW - Baden-Württemberg
DE-BY - Beieren
DE-HB - Bremen
DE-HE - Hessen
DE-HH - Hamburg
DE-MV - Mecklenburg-Voor-Pommeren
DE-NI - Nedersaksen
DE-NW - Noordrijn-Westfalen
DE-RP - Rijnland-Palts
DE-SH - Sleeswijk-Holstein
DE-SL - Saarland
DE-SN - Saksen
DE-ST - Saksen-Anhalt
DE-TH - Thüringen
DK - Denemarken
EE - Estland
ES - Spanje
FI - Finland
FR - Frankrijk
GB - Groot-Brittannië
GE - Georgië
GR - Griekenland
HR - Kroatië
HU - Hongarije
IE - Ierland
IS - IJsland
IT - Italië
LT - Litouwen
LU - Luxemburg
LV - Letland
MD - Moldavië
ME - Montenegro
MK - Noord-Macedonië
MT - Malta
NL - Nederland
NO - Noorwegen
PL - Polen
PT - Portugal
RO - Roemenië
RU - Rusland
SE - Zweden
SI - Slovenië
SK - Slowakije
TR - Turkije
UA - Oekraïne
XK - Kosovo

Hoe betrouwbaar zijn de gegevens?

Alle gegevens ondergaan een grondige kwaliteitscontrole in meerdere fasen, uitgevoerd door algoritmes, kunstmatige intelligentie (AI) en handmatige verificatie. PolitPro wordt erkend als een van de meest betrouwbare bronnen voor Europese verkiezingstrends en wordt gebruikt door internationale media, onderzoeksinstellingen en politieke instanties. Alle gegevens onder voorbehoud.

Worden historische datapunten achteraf aangepast?

Historische gegevens kunnen te allen tijde en zonder voorafgaande kennisgeving worden aangepast. Correcties vinden plaats door bijvoorbeeld de uitbreiding van onze datasets met actuele en historische gegevens, wijzigingen in de wegingmethodiek of het oplossen van fouten. Aangezien we onze datasets voortdurend uitbreiden, raden we aan om historische gegevens regelmatig opnieuw op te vragen in plaats van ze als een statische dataset te behandelen.

Moet ik PolitPro als bron vermelden?

Ja, bij elke openbare weergave van de gegevens is een bronvermelding met een link naar PolitPro.eu verplicht, bijvoorbeeld: "Bron: PolitPro.eu".

Wat is de PolitPro verkiezingstrend?

De PolitPro verkiezingstrend aggregeert de peilingsresultaten van alle relevante instituten tot een gewogen gemiddelde. Actuele peilingen wegen zwaarder dan oudere, en ook de historische voorspellende waarde van de instituten wordt meegenomen. Het resultaat is een statistisch onderbouwde trendlijn die kortetermijnuitschieters afvlakt en de reële politieke dynamiek in de loop van de tijd zichtbaar maakt.

Wat is PolitPro?

PolitPro is Europa's toonaangevende platform voor verkiezingstrends en politieke peilingsgegevens. Internationale media, politieke instellingen, universiteiten en onderzoeksinstellingen gebruiken onze data al in hun dagelijkse werk. PolitPro is politiek onafhankelijk en combineert openbare peilingsgegevens en wetenschappelijke datasets met eigen algoritmes.

Nu vrijblijvend aanvragen

Naam
Bedrijf
E-mail
Hoe moeten de gegevens worden gebruikt?
Korte beschrijving

Endpoints & technische details

Endpoint: Actuele verkiezingstrend
https://politpro.eu/api/v1/{countryCode}/trend
De actuele PolitPro verkiezingstrend van het parlement berekent een gewogen gemiddelde van de meest recente peilingen.
diff Vergelijking met het laatste meetpunt van de voorgaande week
election_diff Vergelijking met de laatste verkiezingen
Aanbevolen updates: elke 12 uur
Webhook-gebeurtenis 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 } ] } } }

Endpoint: Ontwikkeling van de verkiezingstrend
https://politpro.eu/api/v1/{countryCode}/trend/history/{startYear}/{endYear}
De historische ontwikkeling van de PolitPro verkiezingstrend voor de geselecteerde jaren. De verkiezingstrend wordt wekelijks als meetpunt opgeslagen. Historische gegevens zijn, afhankelijk van het parlement, beschikbaar vanaf 2019.
?format=poll Optionele URL-parameter. Toont de historische gegevens als afzonderlijke peilingen.
?format=party Optionele URL-parameter. Toont de historische gegevens als een verzameling waarden per partij.
Aanbevolen updates: één keer per week
Webhook-gebeurtenis 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 } ] } ] } }

Endpoint: Meest recente verkiezingspeilingen
https://politpro.eu/api/v1/{countryCode}/polls/latest
De vijf meest recente peilingen voor het parlement, gesorteerd op datum (meest recent eerst). De laatste dag van de onderzoeksperiode is bepalend.
diff Vergelijking met de vorige peiling van het instituut
election_diff Vergelijking met de vorige verkiezingen
Aanbevolen updates: elke 12 uur
Webhook-gebeurtenis 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 } ] } ] } }

Endpoint: Meest recente peiling per instituut
https://politpro.eu/api/v1/{countryCode}/polls/institutes
De meest recente peiling van elk instituut dat in de afgelopen 365 dagen peilingsresultaten heeft gepubliceerd. De laatste dag van de peilingsperiode is bepalend.
diff Vergelijking met de vorige peiling van het instituut
election_diff Vergelijking met de vorige verkiezingen
score Indien beschikbaar: PolitPro Score (0-100) van het instituut voor nauwkeurigheid, gebaseerd op historische verkiezingspeilingen en partijvoorkeur.
Aanbevolen updates: elke 12 uur
Webhook-gebeurtenis 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 } ] } ] } }

Hoe werkt de webhook?

Via de webhook informeren we jouw server automatisch over nieuwe gegevens. De structuur van elke melding komt overeen met die van het betreffende eindpunt, aangevuld met een extra veld voor het gebeurtenistype.

Instellen

Voer de URL van je server in bij de instellingen van je PolitPro-account. Optioneel kun je daar ook een Webhook Secret aanmaken, waarmee je de authenticiteit van onze gegevensoverdrachten kunt controleren.

Levering & Antwoordformaat

Als je server niet met "OK" antwoordt, wordt de levering als mislukt beschouwd. In dat geval proberen we de levering tot vijf keer opnieuw.

Verificatie van de gegevens

Elke melding bevat in de header het veld "X-Webhook-Signature". Dit veld bevat een HMAC-SHA256-handtekening van de berichtinhoud, berekend met jouw Webhook Secret als sleutel. Bereken de handtekening aan jouw zijde op dezelfde manier (HMAC-SHA256 over de gehele melding) en vergelijk deze met de overgedragen waarde, om er zeker van te zijn dat de gegevens daadwerkelijk van ons afkomstig zijn en onderweg niet zijn gewijzigd.

Authenticatie

Authenticatie vindt plaats via een Bearer Token in de header: "Authorization: Bearer {token}". U vindt het token na registratie in de instellingen van uw PolitPro account.

Max. verzoeken per minuut

De API staat maximaal 30 aanvragen per minuut toe. Bij overschrijding wordt foutcode 429 geretourneerd.

Waar vind ik mijn API-sleutel?

Je API-sleutel vind je in de instellingen van je PolitPro-account.