Tai yra PolitPro API

Kam skirta API?

API skirta žiniasklaidos įmonėms, leidykloms, analitiniams centrams, duomenų teikėjams ir kūrėjams, norintiems integruoti politinių apklausų duomenis ir rinkimų tendencijas į savo produktus, platformas ar analizes.

Kaip galiu naudoti duomenis?

Duomenys gali būti naudojami redakciniams tikslams, nuosavuose produktuose ir savo klientams. Negalima kurti savarankiškos platformos, kurios pagrindinis produktas būtų politinių apklausų duomenys, rinkimų tendencijos ar panašūs konkuruojantys pasiūlymai su PolitPro. Susisiekite su mumis per žemiau esančią kontaktinę formą, kad sužinotumėte, kaip galime jums geriausiai padėti.

Kokius duomenis teikia API?

API teikia naujausias rinkimų tendencijas, istorinę tendencijų raidą ir neapdorotus atskirų rinkimų apklausų duomenis daugiau nei 70 parlamentų – suskirstytus pagal aktualumą arba apklausų institutą. Duomenys atnaujinami kuo greičiau po naujų apklausų paskelbimo. Dabartinė rinkimų tendencija perskaičiuojama su kiekviena nauja apklausa. Istoriniai tendencijų duomenys fiksuojami kartą per savaitę kaip duomenų taškas.

Kokie parlamentai yra pasiekiami?

AD - Andora
AL - Albanija
AM - Armėnija
AT - Austrija
AT-1 - Burgenlandas
AT-2 - Karintija
AT-3 - Žemutinė Austrija
AT-4 - Aukštutinė Austrija
AT-5 - Zalcburgas
AT-6 - Štirija
AT-7 - Tirolis
AT-8 - Vorarlbergas
AT-9 - Viena
BE - Belgija
BE-BR - Briuselis
BE-VL - Flandrija
BE-WA - Valonija
BG - Bulgarija
CH - Šveicarija
CY - Kipras
CZ - Čekija
DE - Vokietija
DE-BB - Brandenburgas
DE-BE - Berlynas
DE-BW - Badenas-Viurtembergas
DE-BY - Bavarija
DE-HB - Brėmenas
DE-HE - Hesenas
DE-HH - Hamburgas
DE-MV - Meklenburgas-Priešakinė Pomeranija
DE-NI - Žemutinė Saksonija
DE-NW - Šiaurės Reinas-Vestfalija
DE-RP - Reino kraštas-Pfalcas
DE-SH - Šlėzvigas-Holšteinas
DE-SL - Saro kraštas
DE-SN - Saksonija
DE-ST - Saksonija-Anhaltas
DE-TH - Tiuringija
DK - Danija
EE - Estija
ES - Ispanija
FI - Suomija
FR - Prancūzija
GB - Didžioji Britanija
GE - Sakartvelas
GR - Graikija
HR - Kroatija
HU - Vengrija
IE - Airija
IS - Islandija
IT - Italija
LT - Lietuva
LU - Liuksemburgas
LV - Latvija
MD - Moldova
ME - Juodkalnija
MK - Šiaurės Makedonija
MT - Malta
NL - Nyderlandai
NO - Norvegija
PL - Lenkija
PT - Portugalija
RO - Rumunija
RU - Rusija
SE - Švedija
SI - Slovėnija
SK - Slovakija
TR - Turkija
UA - Ukraina
XK - Kosovas

Kiek patikimi yra duomenys?

Visi duomenys praeina daugiapakopę kokybės kontrolę, apimančią algoritmus, dirbtinį intelektą (DI) ir rankinį patikrinimą. PolitPro yra pripažinta kaip vienas patikimiausių šaltinių Europos rinkimų tendencijų analizei – ja naudojasi tarptautinė žiniasklaida, tyrimų institucijos ir politinės institucijos. Visi duomenys pateikiami be garantijos.

Ar istoriniai duomenų taškai koreguojami vėliau?

Istoriniai duomenys gali būti koreguojami bet kuriuo metu ir be išankstinio pranešimo. Korekcijos atliekamos, pavyzdžiui, plečiant mūsų duomenų rinkinius naujausiais ir istoriniais duomenimis, keičiant svėrimo metodiką arba taisant klaidas. Kadangi nuolat plečiame savo duomenų rinkinius, rekomenduojame reguliariai iš naujo atsisiųsti istorinius duomenis, o ne traktuoti juos kaip statinį duomenų rinkinį.

Ar privalau nurodyti PolitPro kaip šaltinį?

Taip, kiekvieną kartą viešai pateikiant duomenis, būtina nurodyti šaltinį su nuoroda į PolitPro.eu, pvz., „Šaltinis: PolitPro.eu“.

Kas yra PolitPro rinkimų tendencija?

PolitPro rinkimų tendencija apjungia visų atitinkamų institutų apklausų rezultatus į svertinį vidurkį. Dabartinės apklausos sveriamos labiau nei senesnės, be to, atsižvelgiama į istorinį institutų prognozių tikslumą. Rezultatas – statistiškai patikima tendencijos linija, kuri išlygina trumpalaikius nukrypimus ir atskleidžia realią politinę dinamiką laikui bėgant.

Kas yra PolitPro?

PolitPro yra pirmaujanti Europos platforma, skirta rinkimų tendencijoms ir politinių apklausų duomenims. Tarptautinės žiniasklaidos priemonės, politinės institucijos, universitetai ir tyrimų centrai jau naudoja mūsų duomenis savo kasdieniame darbe. PolitPro yra politiškai nepriklausoma ir derina viešuosius apklausų duomenis bei mokslinius duomenų rinkinius su savo algoritmais.

Pateikti užklausą dabar be įsipareigojimų

Vardas
Įmonė
El. paštas
Kaip bus naudojami duomenys?
Trumpas aprašymas

Prieigos taškai ir techninės detalės

Prieigos taškas: Dabartinė rinkimų tendencija
https://politpro.eu/api/v1/{countryCode}/trend
Dabartinė PolitPro parlamento rinkimų tendencija apskaičiuojama kaip svertinis dabartinių „sekmadienio klausimų“ vidurkis.
diff Palyginimas su praėjusios savaitės paskutiniu matavimo tašku
election_diff Palyginimas su paskutiniais rinkimais
Rekomenduojami atnaujinimai: kas 12 valandų
Webhooko įvykis 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 } ] } } }

Prieigos taškas: Rinkimų tendencijos raida
https://politpro.eu/api/v1/{countryCode}/trend/history/{startYear}/{endYear}
Istorinė PolitPro rinkimų tendencijų raida pasirinktais metais. Rinkimų tendencija saugoma kaip matavimo taškas kartą per savaitę. Istoriniai duomenys, priklausomai nuo parlamento, prieinami ne anksčiau kaip nuo 2019 m.
?format=poll Neprivalomas URL parametras. Rodo istorinius duomenis kaip apklausas.
?format=party Neprivalomas URL parametras. Rodo istorinius duomenis kaip partijų verčių rinkinį.
Rekomenduojami atnaujinimai: kartą per savaitę
Webhooko įvykis 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 } ] } ] } }

Prieigos taškas: Naujausios rinkimų apklausos
https://politpro.eu/api/v1/{countryCode}/polls/latest
Penkios naujausios parlamento rinkimų apklausos, surūšiuotos mažėjančia tvarka pagal laiką. Svarbiausia yra paskutinė apklausos laikotarpio diena.
diff Palyginimas su ankstesne instituto apklausa
election_diff Palyginimas su ankstesniais rinkimais
Rekomenduojami atnaujinimai: kas 12 valandų
Webhooko įvykis 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 } ] } ] } }

Prieigos taškas: Naujausios apklausos pagal institutus
https://politpro.eu/api/v1/{countryCode}/polls/institutes
Naujausia kiekvieno instituto, per pastarąsias 365 dienas paskelbusio apklausų rezultatus, apklausa. Svarbiausia yra paskutinė apklausos laikotarpio diena.
diff Palyginimas su ankstesne instituto apklausa
election_diff Palyginimas su ankstesniais rinkimais
score Jei yra: PolitPro instituto tikslumo balas (0-100), apskaičiuotas remiantis istoriniais rinkimų apklausų duomenimis ir partijų šališkumu.
Rekomenduojami atnaujinimai: kas 12 valandų
Webhooko įvykis 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 } ] } ] } }

Kaip veikia webhookas?

Naudodami webhooką, automatiškai informuojame jūsų serverį apie naujus duomenis. Kiekvieno pranešimo struktūra atitinka atitinkamo galinio taško struktūrą, papildytą papildomu lauku, nurodančiu įvykio tipą.

Nustatymas

Įveskite savo serverio URL „PolitPro“ paskyros nustatymuose. Pasirinktinai, ten taip pat galite sukurti „Webhook Secret“ (slaptą raktą), kuris leis jums patikrinti mūsų duomenų perdavimo autentiškumą.

Pristatymas ir atsakymo formatas

Jei jūsų serveris neatsako „OK“, pristatymas laikomas nepavykusiu. Tokiu atveju bandysime pristatyti pranešimą dar iki penkių kartų.

Duomenų patvirtinimas

Kiekviename pranešime antraštėje yra laukas „X-Webhook-Signature“. Jame yra HMAC-SHA256 pranešimo turinio parašas, apskaičiuotas naudojant jūsų „Webhook Secret“ (slaptą raktą) kaip šifravimo raktą. Apskaičiuokite parašą savo pusėje tokiu pačiu būdu (HMAC-SHA256 visam pranešimui) ir palyginkite jį su gauta verte, kad įsitikintumėte, jog duomenys tikrai yra iš mūsų ir nebuvo pakeisti perdavimo metu.

Autentifikavimas

Autentifikavimas atliekamas naudojant „Bearer Token“ antraštėje: „Authorization: Bearer {token}“. Tokeną rasite užsiregistravę savo PolitPro paskyros nustatymuose.

Maks. užklausų per minutę

API leidžia ne daugiau kaip 30 užklausų per minutę. Viršijus limitą, grąžinamas klaidos kodas 429.

Kur rasti mano API raktą?

Savo API raktą rasite PolitPro paskyros nustatymuose.