See on PolitPro API

Kellele API sobib?

API on mõeldud meediamajadele, kirjastustele, mõttekodadele, andmepakkujatele ja arendajatele, kes soovivad integreerida poliitilisi küsitlusandmeid ja valimistrende oma toodetesse, platvormidesse või analüüsidesse.

Kuidas tohin andmeid kasutada?

Andmeid tohib kasutada toimetuslikel eesmärkidel, oma toodetes ja oma klientidele. Ei ole lubatud luua iseseisvat platvormi, mille põhitooteks on poliitilised küsitlusandmed, valimistrendid või PolitProga võrreldavad konkureerivad pakkumised. Võta meiega ühendust alloleva kontaktivormi kaudu, et saada lisateavet selle kohta, kuidas saame sind kõige paremini toetada.

Milliseid andmeid API pakub?

API pakub värskeid valimistrende, ajaloolisi trendiarendusi ja üksikute valimisküsitluste toorandmeid enam kui 70 parlamendi jaoks – jaotatuna värskuse või küsitlusinstituudi järgi. Andmeid uuendatakse võimalikult kiiresti pärast uute küsitluste avaldamist. Praegune valimistrend arvutatakse iga uue küsitlusega uuesti. Ajaloolised trendiandmed kogutakse andmepunktina üks kord nädalas.

Millised parlamendid on saadaval?

AD - Andorra
AL - Albaania
AM - Armeenia
AT - Austria
AT-1 - Burgenland
AT-2 - Kärnten
AT-3 - Alam-Austria
AT-4 - Ülem-Austria
AT-5 - Salzburg
AT-6 - Steiermark
AT-7 - Tirool
AT-8 - Vorarlberg
AT-9 - Viin
BE - Belgia
BE-BR - Brüssel
BE-VL - Flandria
BE-WA - Valloonia
BG - Bulgaaria
CH - Šveits
CY - Küpros
CZ - Tšehhi
DE - Saksamaa
DE-BB - Brandenburg
DE-BE - Berliin
DE-BW - Baden-Württemberg
DE-BY - Baieri
DE-HB - Bremen
DE-HE - Hessen
DE-HH - Hamburg
DE-MV - Mecklenburg-Vorpommern
DE-NI - Alam-Saksi
DE-NW - Põhja-Rein-Vestfaal
DE-RP - Reinimaa-Pfalz
DE-SH - Schleswig-Holstein
DE-SL - Saarimaa
DE-SN - Saksimaa
DE-ST - Saksi-Anhalt
DE-TH - Tüüringi
DK - Taani
EE - Eesti
ES - Hispaania
FI - Soome
FR - Prantsusmaa
GB - Suurbritannia
GE - Gruusia
GR - Kreeka
HR - Horvaatia
HU - Ungari
IE - Iirimaa
IS - Island
IT - Itaalia
LT - Leedu
LU - Luksemburg
LV - Läti
MD - Moldova
ME - Montenegro
MK - Põhja-Makedoonia
MT - Malta
NL - Holland
NO - Norra
PL - Poola
PT - Portugal
RO - Rumeenia
RU - Venemaa
SE - Rootsi
SI - Sloveenia
SK - Slovakkia
TR - Türgi
UA - Ukraina
XK - Kosovo

Kui usaldusväärsed on andmed?

Kõik andmed läbivad mitmetasandilise kvaliteedikontrolli, mis hõlmab algoritme, tehisintellekti ja käsitsi kontrolli. PolitProd peetakse üheks usaldusväärseimaks allikaks Euroopa valimistrendide osas – seda kasutavad rahvusvahelised meediaväljaanded, uurimisasutused ja poliitilised institutsioonid. Kõik andmed on esitatud ilma garantiita.

Kas ajaloolisi andmepunkte kohandatakse tagasiulatuvalt?

Ajaloolisi andmeid võidakse kohandada igal ajal ja ette teatamata. Parandused tehakse näiteks meie andmekogude laiendamisega aktuaalsete ja ajalooliste andmetega, kaalumismetoodika muudatustega või vigade parandamisega. Kuna me laiendame oma andmekogusid pidevalt, soovitame ajaloolisi andmeid regulaarselt uuesti alla laadida, selle asemel et käsitleda neid staatilise andmekoguna.

Kas pean PolitPro-le viitama kui allikale?

Jah, andmete igal avalikul esitamisel on kohustuslik märkida allikas koos lingiga PolitPro.eu-le, näiteks "Allikas: PolitPro.eu".

Mis on PolitPro valimistrend?

PolitPro valimistrend koondab kõigi asjakohaste instituutide küsitlustulemused kaalutud keskmiseks. Ajakohaseid küsitlusi kaalutakse tugevamalt kui vanemaid, lisaks arvestatakse instituutide ajaloolist prognoositäpsust. Tulemuseks on statistiliselt usaldusväärne trendijoon, mis silub lühiajalisi kõrvalekaldeid ja muudab tegeliku poliitilise dünaamika ajas nähtavaks.

Mis on PolitPro?

PolitPro on Euroopa juhtiv platvorm valimistrendide ja poliitiliste küsitlusandmete jaoks. Rahvusvahelised meediaväljaanded, poliitilised institutsioonid, ülikoolid ja uurimisasutused kasutavad meie andmeid juba oma igapäevatöös. PolitPro on poliitiliselt sõltumatu ning ühendab avalikud küsitlusandmed ja teaduslikud andmekogumid oma algoritmidega.

Esita siduvuseta päring kohe

Nimi
Ettevõte
E-post
Kuidas andmeid kasutada soovitakse?
Lühikirjeldus

Andmepunktid ja tehnilised detailid

Andmepunkt: Praegune valimistrend
https://politpro.eu/api/v1/{countryCode}/trend
Parlamendi praegune PolitPro valimistrend arvutab praeguste pühapäevaküsitluste kaalutud keskmise.
diff Võrdlus eelmise nädala viimase mõõtepunktiga
election_diff Võrdlus viimaste valimistega
Soovitatavad uuendused: iga 12 tunni järel
Veebikonksu sündmus 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 } ] } } }

Andmepunkt: Valimistrendi areng
https://politpro.eu/api/v1/{countryCode}/trend/history/{startYear}/{endYear}
Valitud aastate PolitPro valimistrendi ajalooline areng. Valimistrend salvestatakse mõõtepunktina üks kord nädalas. Ajaloolised andmed on saadaval alates 2019. aastast, olenevalt parlamendist.
?format=poll Valikuline URL-parameeter. Kuvab ajaloolised andmed küsitlustena.
?format=party Valikuline URL-parameeter. Kuvab ajaloolised andmed erakondade kaupa väärtuste kogumina.
Soovitatavad uuendused: üks kord nädalas
Veebikonksu sündmus 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 } ] } ] } }

Andmepunkt: Uusimad valimisküsitlused
https://politpro.eu/api/v1/{countryCode}/polls/latest
Parlamendi viis uusimat valimisküsitlust, sorteeritud ajaliselt kahanevas järjekorras. Arvesse võetakse küsitlusperioodi viimast päeva.
diff Võrdlus instituudi eelmise küsitlusega
election_diff Võrdlus eelmiste valimistega
Soovitatavad uuendused: iga 12 tunni järel
Veebikonksu sündmus 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 } ] } ] } }

Andmepunkt: Uusim küsitlus instituudi kaupa
https://politpro.eu/api/v1/{countryCode}/polls/institutes
Iga instituudi uusim küsitlus, mis on viimase 365 päeva jooksul avaldanud küsitlustulemusi. Arvesse võetakse küsitlusperioodi viimane päev.
diff Võrdlus instituudi eelmise küsitlusega
election_diff Võrdlus eelmiste valimistega
score Kui saadaval: Instituudi PolitPro skoor (0-100), mis näitab täpsust ajalooliste valimiseelsete küsitluste ja parteilise kallutatuse põhjal.
Soovitatavad uuendused: iga 12 tunni järel
Veebikonksu sündmus 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 } ] } ] } }

Kuidas veebikonks töötab?

Veebikonksu abil teavitame sinu serverit automaatselt uutest andmetest. Iga teavituse ülesehitus vastab vastava lõpp-punkti omale, millele on lisatud täiendav väli sündmuse tüübi jaoks.

Seadistamine

Sisesta oma serveri URL oma PolitPro konto seadetesse. Soovi korral saad seal luua ka veebikonksu salajase võtme (Webhook Secret), millega saad kontrollida meie andmeedastuste autentsust.

Edastus ja vastuse formaat

Kui sinu server ei vasta "OK", loetakse edastus ebaõnnestunuks. Sellisel juhul proovime edastust uuesti kuni viis korda.

Andmete kontrollimine

Iga teavitus sisaldab päises välja "X-Webhook-Signature". See sisaldab sõnumi sisu HMAC-SHA256 allkirja, mis on arvutatud sinu veebikonksu salajase võtmega. Arvuta allkiri oma poolel samamoodi (HMAC-SHA256 üle kogu teavituse) ja võrdle seda edastatud väärtusega, et veenduda, et andmed pärinevad tõepoolest meilt ja neid pole teel muudetud.

Autentimine

Autentimine toimub Bearer Tokeni abil päises: "Authorization: Bearer {token}". Tokeni leiate pärast registreerimist oma PolitPro konto seadetest.

Maks. päringuid minutis

API lubab maksimaalselt 30 päringut minutis. Piirangu ületamisel tagastatakse veakood 429.

Kust leian oma API-võtme?

Oma API-võtme leiad oma PolitPro konto seadetest.