Tämä on PolitPro API

Kenelle API sopii?

API on suunnattu mediataloille, kustantajille, ajatushautomoille, datatoimittajille ja kehittäjille, jotka haluavat integroida poliittisia kyselytietoja ja vaalitrendejä omiin tuotteisiinsa, alustoihinsa tai analyyseihinsä.

Miten tietoja saa käyttää?

Tietoja saa käyttää toimituksellisesti, omissa tuotteissa ja omille asiakkaille. Sen sijaan ei ole sallittua rakentaa itsenäistä alustaa, jonka ydinpalvelu koostuu poliittisista mielipidemittauksista, vaalitrendeistä tai vastaavista PolitPron kilpailevista tarjouksista. Ota meihin yhteyttä alla olevalla yhteydenottolomakkeella saadaksesi lisätietoja siitä, miten voimme parhaiten tukea sinua.

Mitä tietoja API tarjoaa?

API tarjoaa ajankohtaiset vaalitrendit, historialliset trendikehitykset sekä yksittäisten vaaligallupien raakadatat yli 70 parlamentille – jaoteltuna ajantasaisuuden tai kyselyinstituutin mukaan. Tiedot päivitetään mahdollisimman pian uusien kyselyjen julkaisun jälkeen. Ajankohtainen vaalitrendi lasketaan uudelleen jokaisen uuden kyselyn myötä. Historialliset trenditiedot tallennetaan datapisteenä kerran viikossa.

Mitä parlamentteja on saatavilla?

AD - Andorra
AL - Albania
AM - Armenia
AT - Itävalta
AT-1 - Burgenland
AT-2 - Kärnten
AT-3 - Ala-Itävalta
AT-4 - Ylä-Itävalta
AT-5 - Salzburg
AT-6 - Steiermark
AT-7 - Tiroli
AT-8 - Vorarlberg
AT-9 - Wien
BE - Belgia
BE-BR - Bryssel
BE-VL - Flanderi
BE-WA - Vallonia
BG - Bulgaria
CH - Sveitsi
CY - Kypros
CZ - Tšekki
DE - Saksa
DE-BB - Brandenburg
DE-BE - Berliini
DE-BW - Baden-Württemberg
DE-BY - Baijeri
DE-HB - Bremen
DE-HE - Hessen
DE-HH - Hampuri
DE-MV - Mecklenburg-Etu-Pommeri
DE-NI - Ala-Saksi
DE-NW - Nordrhein-Westfalen
DE-RP - Rheinland-Pfalz
DE-SH - Schleswig-Holstein
DE-SL - Saarland
DE-SN - Saksi
DE-ST - Saksi-Anhalt
DE-TH - Thüringen
DK - Tanska
EE - Viro
ES - Espanja
FI - Suomi
FR - Ranska
GB - Iso-Britannia
GE - Georgia
GR - Kreikka
HR - Kroatia
HU - Unkari
IE - Irlanti
IS - Islanti
IT - Italia
LT - Liettua
LU - Luxemburg
LV - Latvia
MD - Moldova
ME - Montenegro
MK - Pohjois-Makedonia
MT - Malta
NL - Alankomaat
NO - Norja
PL - Puola
PT - Portugali
RO - Romania
RU - Venäjä
SE - Ruotsi
SI - Slovenia
SK - Slovakia
TR - Turkki
UA - Ukraina
XK - Kosovo

Kuinka luotettavia tiedot ovat?

Tietomme käyvät läpi tiukan, monivaiheisen laadunvalvonnan, jossa hyödynnetään algoritmeja, tekoälyä ja manuaalista tarkastusta. PolitProta pidetään yhtenä luotettavimmista eurooppalaisten vaalitrendien lähteistä – sitä hyödyntävät kansainväliset mediat, tutkimuslaitokset ja poliittiset instituutiot. Tiedot esitetään ilman vastuuta mahdollisista virheistä.

Muokataanko historiallisia datapisteitä jälkikäteen?

Historiallisia tietoja voidaan muokata milloin tahansa ja ilman ennakkoilmoitusta. Korjaukset voivat johtua esimerkiksi tietokantojemme laajentamisesta uusilla ja historiallisilla tiedoilla, painotusmenetelmien muutoksista tai virheiden korjaamisesta. Koska laajennamme tietokantojamme jatkuvasti, suosittelemme hakemaan historialliset tiedot säännöllisesti uudelleen sen sijaan, että niitä käsiteltäisiin staattisena tietokokonaisuutena.

Pitääkö PolitPro mainita lähteenä?

Kyllä, aina kun tietoja esitetään julkisesti, on mainittava lähde linkillä PolitPro.eu-sivustolle, esim. "Lähde: PolitPro.eu".

Mikä on PolitPro-vaalitrendi?

PolitPro-vaalitrendi yhdistää kaikkien relevanttien instituutioiden kyselytulokset painotetuksi keskiarvoksi. Ajankohtaiset kyselyt painotetaan vanhempia vahvemmin, ja lisäksi huomioidaan instituutioiden historiallinen ennustetarkkuus. Tuloksena on tilastollisesti luotettava trendiviiva, joka tasoittaa lyhytaikaisia poikkeamia ja tekee todellisen poliittisen dynamiikan näkyväksi ajan mittaan.

Mikä on PolitPro?

PolitPro on Euroopan johtava alusta vaalitrendeille ja poliittisille kyselytiedolle. Kansainväliset mediat, poliittiset instituutiot sekä yliopistot ja tutkimuslaitokset hyödyntävät tietojamme jo päivittäisessä työssään. PolitPro on poliittisesti riippumaton ja yhdistää julkiset kyselytiedot ja tieteelliset aineistot omiin algoritmeihinsa.

Lähetä sitoumukseton kysely

Nimi
Yritys
Sähköposti
Miten tietoja on tarkoitus käyttää?
Lyhyt kuvaus

Rajapinnat ja tekniset tiedot

Rajapinta: Ajankohtainen vaalitrendi
https://politpro.eu/api/v1/{countryCode}/trend
Parlamentin nykyinen PolitPro-vaalitrendi laskee painotetun keskiarvon ajankohtaisista sunnuntaikyselyistä.
diff Vertailu edellisen viikon viimeiseen mittauspisteeseen
election_diff Vertailu edellisiin vaaleihin
Suositeltu päivitysväli: 12 tunnin välein
Webhook-tapahtuma 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 } ] } } }

Rajapinta: Vaalitrendin kehitys
https://politpro.eu/api/v1/{countryCode}/trend/history/{startYear}/{endYear}
Valittujen vuosien PolitPron vaalitrendin historiallinen kehitys. Vaalitrendi tallennetaan mittauspisteenä kerran viikossa. Historialliset tiedot ovat saatavilla aikaisintaan vuodesta 2019 alkaen parlamentista riippuen.
?format=poll Valinnainen URL-parametri. Näyttää historialliset tiedot kyselyinä.
?format=party Valinnainen URL-parametri. Näyttää historialliset tiedot arvojoukkona puolueittain.
Suositeltu päivitysväli: Kerran viikossa
Webhook-tapahtuma 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 } ] } ] } }

Rajapinta: Uusimmat vaalikyselyt
https://politpro.eu/api/v1/{countryCode}/polls/latest
Viisi uusinta parlamentin vaaligallupia, aikajärjestyksessä laskevasti. Ratkaiseva on kyselyajanjakson viimeinen päivä.
diff Vertailu instituutin edelliseen kyselyyn
election_diff Vertailu edellisiin vaaleihin
Suositeltu päivitysväli: 12 tunnin välein
Webhook-tapahtuma 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 } ] } ] } }

Rajapinta: Uusin kysely instituutin mukaan
https://politpro.eu/api/v1/{countryCode}/polls/institutes
Jokaisen instituutin uusin kysely, joka on julkaissut kyselytuloksia viimeisten 365 päivän aikana. Ratkaiseva on kyselyajanjakson viimeinen päivä.
diff Vertailu instituutin edelliseen kyselyyn
election_diff Vertailu edellisiin vaaleihin
score Mikäli saatavilla: Instituutin PolitPro-pisteet (0-100) tarkkuudesta, perustuen historiallisiin vaaliennusteisiin ja puolueiden puolueellisuuteen.
Suositeltu päivitysväli: 12 tunnin välein
Webhook-tapahtuma 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 } ] } ] } }

Miten webhook toimii?

Webhookin avulla palvelimesi saa automaattisesti tiedon uusista tiedoista. Jokaisen ilmoituksen rakenne vastaa kyseisen päätepisteen rakennetta, johon on lisätty erillinen kenttä tapahtuman tyypille.

Määritys

Lisää palvelimesi URL-osoite PolitPro-tilisi asetuksiin. Halutessasi voit luoda myös Webhook Secret -avaimen, jolla voit varmistaa tietonsiirtojemme aitouden.

Toimitus ja vastausmuoto

Jos palvelimesi ei vastaa 'OK', toimitus katsotaan epäonnistuneeksi. Tällöin yritämme toimitusta uudelleen jopa viisi kertaa.

Tietojen todentaminen

Jokainen ilmoitus sisältää otsikkokentässä 'X-Webhook-Signature'. Se sisältää HMAC-SHA256-allekirjoituksen viestin sisällöstä, joka on laskettu käyttäen Webhook Secret -avaintasi. Laske allekirjoitus omalla puolellasi samalla tavalla (HMAC-SHA256 koko ilmoituksesta) ja vertaa sitä lähetettyyn arvoon varmistaaksesi, että tiedot ovat peräisin meiltä eivätkä ole muuttuneet matkan varrella.

Todennus

Todennus tapahtuu Bearer-tunnuksella otsikossa: "Authorization: Bearer {token}". Tunnuksen löydät rekisteröitymisen jälkeen PolitPro-tilisi asetuksista.

Max. pyynnöt minuutissa

API sallii enintään 30 pyyntöä minuutissa. Ylityksen tapahtuessa palautetaan virhekoodi 429.

Mistä löydän API-avaimeni?

API-avaimesi löytyy PolitPro-tilisi asetuksista.