Ez a PolitPro API

Kinek alkalmas az API?

Az API médiavállalatoknak, kiadóknak, agytrösztöknek, adatszolgáltatóknak és fejlesztőknek szól, akik politikai felmérések adatait és választási trendeket szeretnének integrálni saját termékeikbe, platformjaikba vagy elemzéseikbe.

Hogyan használhatom fel az adatokat?

Az adatok felhasználhatók szerkesztőségi célokra, saját termékekben és saját ügyfelek számára. Nem engedélyezett azonban olyan önálló platform létrehozása, amelynek fő terméke politikai felmérések adatai, választási trendek vagy a PolitPro-val összehasonlítható versenytárs ajánlatok. Kérjük, vegye fel velünk a kapcsolatot az alábbi űrlapon keresztül, hogy megtudja, hogyan tudunk a legjobban segíteni Önnek.

Milyen adatokat szolgáltat az API?

Az API több mint 70 parlament számára biztosít aktuális választási trendeket, történelmi trendfejlődéseket, valamint egyedi választási felmérések nyers adatait – aktualitás vagy felméréskészítő intézet szerint lebontva. Az adatok a lehető leghamarabb frissülnek az új felmérések közzététele után. Az aktuális választási trend minden új felméréssel újra számolódik. A történelmi trendadatokat hetente egyszer rögzítjük adatpontként.

Mely parlamentek érhetők el?

AD - Andorra
AL - Albánia
AM - Örményország
AT - Ausztria
AT-1 - Burgenland
AT-2 - Karintia
AT-3 - Alsó-Ausztria
AT-4 - Felső-Ausztria
AT-5 - Salzburg
AT-6 - Stájerország
AT-7 - Tirol
AT-8 - Vorarlberg
AT-9 - Bécs
BE - Belgium
BE-BR - Brüsszel
BE-VL - Flandria
BE-WA - Vallónia
BG - Bulgária
CH - Svájc
CY - Ciprus
CZ - Csehország
DE - Németország
DE-BB - Brandenburg
DE-BE - Berlin
DE-BW - Baden-Württemberg
DE-BY - Bajorország
DE-HB - Bréma
DE-HE - Hessen
DE-HH - Hamburg
DE-MV - Mecklenburg-Elő-Pomeránia
DE-NI - Alsó-Szászország
DE-NW - Észak-Rajna-Vesztfália
DE-RP - Rajna-vidék-Pfalz
DE-SH - Schleswig-Holstein
DE-SL - Saar-vidék
DE-SN - Szászország
DE-ST - Szász-Anhalt
DE-TH - Türingia
DK - Dánia
EE - Észtország
ES - Spanyolország
FI - Finnország
FR - Franciaország
GB - Nagy-Britannia
GE - Grúzia
GR - Görögország
HR - Horvátország
HU - Magyarország
IE - Írország
IS - Izland
IT - Olaszország
LT - Litvánia
LU - Luxemburg
LV - Lettország
MD - Moldova
ME - Montenegró
MK - Észak-Macedónia
MT - Málta
NL - Hollandia
NO - Norvégia
PL - Lengyelország
PT - Portugália
RO - Románia
RU - Oroszország
SE - Svédország
SI - Szlovénia
SK - Szlovákia
TR - Törökország
UA - Ukrajna
XK - Koszovó

Mennyire megbízhatóak az adatok?

Adataink többlépcsős minőségellenőrzési folyamaton mennek keresztül, mely algoritmusok, mesterséges intelligencia és manuális felülvizsgálat együttes alkalmazásával történik. A PolitPro az európai választási trendek egyik legmegbízhatóbb forrásaként ismert, amelyet nemzetközi médiaorgánumok, kutatóintézetek és politikai intézmények is előszeretettel használnak. Minden adat tájékoztató jellegű.

A történelmi adatpontok utólag módosulnak?

A történelmi adatok bármikor, előzetes értesítés nélkül módosíthatók. A korrekciók oka lehet például adatbázisaink bővítése aktuális és korábbi adatokkal, a súlyozási módszertan változása vagy hibajavítások. Mivel adatbázisainkat folyamatosan bővítjük, javasoljuk, hogy a történelmi adatokat rendszeresen frissítse, ahelyett, hogy statikus adatként kezelné.

Meg kell jelölnöm a PolitPro-t forrásként?

Igen, az adatok minden nyilvános megjelenítésekor forrásmegjelölés szükséges a PolitPro.eu linkjével, például: „Forrás: PolitPro.eu”.

Mi az a PolitPro választási trend?

A PolitPro választási trendje az összes releváns intézet felmérésének eredményeit súlyozott átlagba aggregálja. Az aktuális felmérések nagyobb súlyt kapnak, mint a régebbiek, és az intézetek történelmi előrejelzési pontossága is figyelembe vételre kerül. Az eredmény egy statisztikailag megbízható trendvonal, amely kisimítja a rövid távú kilengéseket, és láthatóvá teszi a valós politikai dinamikát az idő múlásával.

Mi az a PolitPro?

A PolitPro Európa vezető platformja a választási trendek és politikai felmérések adatainak terén. Nemzetközi médiaorgánumok, politikai intézmények, valamint egyetemek és kutatóintézetek már most is használják adatainkat mindennapi munkájuk során. A PolitPro politikailag független, és a nyilvános felmérések adatait, valamint tudományos adatkészleteket kombinálja saját algoritmusokkal.

Kérjen ajánlatot kötelezettség nélkül!

Név
Cég
E-mail
Hogyan kívánja felhasználni az adatokat?
Rövid leírás

Végpontok és technikai részletek

Végpont: Aktuális választási trend
https://politpro.eu/api/v1/{countryCode}/trend
A parlament aktuális PolitPro választási trendje a legfrissebb vasárnapi kérdések súlyozott átlagát számítja ki.
diff Összehasonlítás az előző hét utolsó mérési pontjával
election_diff Összehasonlítás az előző választással
Ajánlott frissítés: 12 óránként
Webhook esemény 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 } ] } } }

Végpont: A választási trend alakulása
https://politpro.eu/api/v1/{countryCode}/trend/history/{startYear}/{endYear}
A PolitPro választási trendjének történelmi alakulása a kiválasztott évekre vonatkozóan. A választási trendet hetente egyszer rögzítjük mérési pontként. A történelmi adatok parlamentenként eltérően, legkorábban 2019-től érhetők el.
?format=poll Opcionális URL-paraméter. A történelmi adatokat felmérésekként mutatja.
?format=party Opcionális URL-paraméter. A történelmi adatokat pártok szerinti értékgyűjteményként mutatja.
Ajánlott frissítés: Hetente egyszer
Webhook esemény 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 } ] } ] } }

Végpont: Legfrissebb választási felmérések
https://politpro.eu/api/v1/{countryCode}/polls/latest
A parlament öt legfrissebb választási felmérése, időrendben csökkenő sorrendben. A felmérés időszakának utolsó napja a mérvadó.
diff Összehasonlítás az intézet előző felmérésével
election_diff Összehasonlítás az előző választással
Ajánlott frissítés: 12 óránként
Webhook esemény 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 } ] } ] } }

Végpont: Legfrissebb felmérés intézet szerint
https://politpro.eu/api/v1/{countryCode}/polls/institutes
Az elmúlt 365 napban felméréseket publikáló intézetek legfrissebb kutatásai. A felmérés időszakának utolsó napja a mérvadó.
diff Összehasonlítás az intézet előző felmérésével
election_diff Összehasonlítás az előző választással
score Ha elérhető: Az intézet PolitPro pontszáma (0-100) a pontosságra vonatkozóan, történelmi választás előtti felmérések és pártpreferencia-eltolódások alapján.
Ajánlott frissítés: 12 óránként
Webhook esemény 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 } ] } ] } }

Hogyan működik a webhook?

A webhook segítségével automatikusan értesítjük a szerverét az új adatokról. Minden értesítés felépítése megegyezik az adott végpontéval, kiegészítve egy további mezővel az eseménytípushoz.

Beállítás

Adja meg szerverének URL-jét a PolitPro fiókja beállításaiban. Opcionálisan létrehozhat egy webhook titkot is, amellyel ellenőrizheti adatátvitelünk hitelességét.

Kézbesítés és válaszformátum

Ha a szervere nem válaszol „OK”-val, a kézbesítés sikertelennek minősül. Ebben az esetben akár ötször is megpróbáljuk újra a kézbesítést.

Adatok hitelesítése

Minden értesítés tartalmazza a fejlécben az „X-Webhook-Signature” mezőt. Ez tartalmazza az üzenet tartalmának HMAC-SHA256 aláírását, amelyet a webhook titka mint kulcs segítségével számítottunk ki. Számítsa ki az aláírást a saját oldalán ugyanígy (HMAC-SHA256 az egész értesítésen), és hasonlítsa össze az átadott értékkel, hogy megbizonyosodjon arról, az adatok valóban tőlünk származnak, és útközben nem módosultak.

Autentikáció

Az autentikáció Bearer Token segítségével történik a fejlécben: "Authorization: Bearer {token}". A tokent a regisztrációt követően találja meg PolitPro fiókja beállításaiban.

Max. kérések percenként

Az API percenként legfeljebb 30 kérést engedélyez. A korlát túllépése esetén 429-es hibakód kerül visszaadásra.

Hol találom az API-kulcsomat?

Az API-kulcsát a PolitPro fiókja beállításaiban találja.