To jest API PolitPro

Dla kogo jest przeznaczone API?

API jest przeznaczone dla domów mediowych, wydawnictw, think tanków, dostawców danych i deweloperów, którzy chcą zintegrować polityczne dane sondażowe i trendy wyborcze z własnymi produktami, platformami lub analizami.

Jak mogę wykorzystywać dane?

Dane mogą być wykorzystywane redakcyjnie, w ramach własnych produktów oraz dla własnych klientów. Niedozwolone jest tworzenie samodzielnej platformy, której głównym produktem byłyby dane z sondaży politycznych, trendy wyborcze lub inne konkurencyjne rozwiązania dla PolitPro. Skontaktuj się z nami poprzez poniższy formularz kontaktowy, aby dowiedzieć się, jak możemy Cię najlepiej wesprzeć.

Jakie dane dostarcza API?

API dostarcza aktualne trendy wyborcze, historyczne dane trendów oraz surowe dane z pojedynczych sondaży dla ponad 70 parlamentów – z podziałem według aktualności lub instytutu badawczego. Dane są aktualizowane tak szybko, jak to możliwe po publikacji nowych sondaży. Aktualny trend wyborczy jest przeliczany z każdym nowym sondażem. Historyczne dane trendów są rejestrowane raz w tygodniu jako punkt danych.

Jakie parlamenty są dostępne?

AD - Andora
AL - Albania
AM - Armenia
AT - Austria
AT-1 - Burgenland
AT-2 - Karyntia
AT-3 - Dolna Austria
AT-4 - Górna Austria
AT-5 - Salzburg
AT-6 - Styria
AT-7 - Tyrol
AT-8 - Vorarlberg
AT-9 - Wiedeń
BE - Belgia
BE-BR - Bruksela
BE-VL - Flandria
BE-WA - Walonia
BG - Bułgaria
CH - Szwajcaria
CY - Cypr
CZ - Czechy
DE - Niemcy
DE-BB - Brandenburgia
DE-BE - Berlin
DE-BW - Badenia-Wirtembergia
DE-BY - Bawaria
DE-HB - Brema
DE-HE - Hesja
DE-HH - Hamburg
DE-MV - Mecklenburgia-Pomorze Przednie
DE-NI - Dolna Saksonia
DE-NW - Nadrenia Północna-Westfalia
DE-RP - Nadrenia-Palatynat
DE-SH - Szlezwik-Holsztyn
DE-SL - Saara
DE-SN - Saksonia
DE-ST - Saksonia-Anhalt
DE-TH - Turyngia
DK - Dania
EE - Estonia
ES - Hiszpania
FI - Finlandia
FR - Francja
GB - Wielka Brytania
GE - Gruzja
GR - Grecja
HR - Chorwacja
HU - Węgry
IE - Irlandia
IS - Islandia
IT - Włochy
LT - Litwa
LU - Luksemburg
LV - Łotwa
MD - Mołdawia
ME - Czarnogóra
MK - Macedonia Północna
MT - Malta
NL - Holandia
NO - Norwegia
PL - Polska
PT - Portugalia
RO - Rumunia
RU - Rosja
SE - Szwecja
SI - Słowenia
SK - Słowacja
TR - Turcja
UA - Ukraina
XK - Kosowo

Jak wiarygodne są dane?

Wszystkie dane przechodzą wieloetapową kontrolę jakości, obejmującą algorytmy, sztuczną inteligencję (AI) i weryfikację ręczną. PolitPro jest uznawane za jedno z najbardziej wiarygodnych źródeł europejskich trendów wyborczych, wykorzystywane przez międzynarodowe media, instytucje badawcze i polityczne. Dane prezentowane są bez gwarancji.

Czy historyczne punkty danych są korygowane wstecznie?

Dane historyczne mogą być aktualizowane w dowolnym momencie i bez wcześniejszego powiadomienia. Korekty wynikają np. z rozszerzania naszych zbiorów danych o aktualne i historyczne informacje, zmian w metodologii ważenia lub usuwania błędów. Ponieważ nasze bazy danych są stale rozbudowywane, zalecamy regularne ponowne pobieranie danych historycznych, zamiast traktowania ich jako statycznego zestawu.

Czy muszę podawać PolitPro jako źródło?

Tak, przy każdym publicznym przedstawieniu danych wymagane jest podanie źródła wraz z linkiem do PolitPro.eu, np. „Źródło: PolitPro.eu”.

Czym jest trend wyborczy PolitPro?

Trend wyborczy PolitPro agreguje wyniki sondaży wszystkich istotnych instytutów, tworząc ważoną średnią. Aktualne sondaże są ważone silniej niż starsze, a dodatkowo uwzględniana jest historyczna dokładność prognoz instytutów. Rezultatem jest statystycznie wiarygodna linia trendu, która wygładza krótkoterminowe odchylenia i uwidacznia rzeczywistą dynamikę polityczną w czasie.

Czym jest PolitPro?

PolitPro to wiodąca europejska platforma dla trendów wyborczych i danych z sondaży politycznych. Międzynarodowe media, instytucje polityczne, a także uniwersytety i ośrodki badawcze już wykorzystują nasze dane w swojej codziennej pracy. PolitPro jest politycznie niezależne i łączy publiczne dane sondażowe oraz naukowe z własnymi algorytmami.

Wyślij zapytanie bez zobowiązań

Imię i nazwisko
Firma
E-mail
Jak dane mają być wykorzystywane?
Krótki opis

Endpointy i szczegóły techniczne

Endpoint: Aktualny trend wyborczy
https://politpro.eu/api/v1/{countryCode}/trend
Aktualny trend wyborczy PolitPro dla parlamentu oblicza ważoną średnią wartość bieżących sondaży typu "gdyby wybory odbyły się w niedzielę".
diff Porównanie do ostatniego punktu pomiarowego z poprzedniego tygodnia
election_diff Porównanie do ostatnich wyborów
Zalecana częstotliwość aktualizacji: co 12 godzin
Zdarzenie Webhook 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: Ewolucja trendu wyborczego
https://politpro.eu/api/v1/{countryCode}/trend/history/{startYear}/{endYear}
Historyczny rozwój trendu wyborczego PolitPro dla wybranych lat. Trend wyborczy jest zapisywany raz w tygodniu jako punkt pomiarowy. Dane historyczne są dostępne najwcześniej od 2019 roku, w zależności od parlamentu.
?format=poll Opcjonalny parametr URL. Wyświetla dane historyczne w formie sondaży.
?format=party Opcjonalny parametr URL. Wyświetla dane historyczne jako zbiór wartości dla poszczególnych partii.
Zalecana częstotliwość aktualizacji: raz w tygodniu
Zdarzenie Webhook 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: Najnowsze sondaże wyborcze
https://politpro.eu/api/v1/{countryCode}/polls/latest
Pięć najnowszych sondaży parlamentarnych, posortowanych malejąco według daty. Kluczowy jest ostatni dzień okresu badania.
diff Porównanie do poprzedniego sondażu instytutu
election_diff Porównanie do poprzednich wyborów
Zalecana częstotliwość aktualizacji: co 12 godzin
Zdarzenie Webhook 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: Najnowszy sondaż według instytutu
https://politpro.eu/api/v1/{countryCode}/polls/institutes
Najnowszy sondaż każdego instytutu, który opublikował wyniki w ciągu ostatnich 365 dni. Kluczowy jest ostatni dzień okresu badania.
diff Porównanie do poprzedniego sondażu instytutu
election_diff Porównanie do poprzednich wyborów
score Jeśli dostępny: PolitPro Score (0-100) instytutu, oceniający jego dokładność na podstawie historycznych sondaży przedwyborczych i stronniczości partyjnej.
Zalecana częstotliwość aktualizacji: co 12 godzin
Zdarzenie Webhook 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 } ] } ] } }

Jak działa webhook?

Dzięki webhookowi automatycznie powiadamiamy Twój serwer o nowych danych. Struktura każdego powiadomienia odpowiada strukturze danego punktu końcowego, uzupełniona o dodatkowe pole określające typ zdarzenia.

Konfiguracja

Wprowadź adres URL swojego serwera w ustawieniach konta PolitPro. Opcjonalnie możesz tam również utworzyć tajny klucz webhooka (Webhook Secret), który pozwoli Ci zweryfikować autentyczność przesyłanych przez nas danych.

Dostarczanie i format odpowiedzi

Jeśli Twój serwer nie odpowie komunikatem „OK”, dostarczenie zostanie uznane za nieudane. W takiej sytuacji ponowimy próbę dostarczenia do pięciu razy.

Weryfikacja danych

Każde powiadomienie zawiera w nagłówku pole „X-Webhook-Signature”. Znajduje się w nim sygnatura HMAC-SHA256 zawartości wiadomości, obliczona przy użyciu Twojego tajnego klucza webhooka (Webhook Secret) jako klucza. Oblicz sygnaturę po swojej stronie w ten sam sposób (HMAC-SHA256 dla całego powiadomienia) i porównaj ją z przesłaną wartością, aby upewnić się, że dane pochodzą od nas i nie zostały zmienione w trakcie transmisji.

Uwierzytelnianie

Uwierzytelnianie odbywa się za pomocą tokena Bearer w nagłówku: "Authorization: Bearer {token}". Token znajdziesz po rejestracji w ustawieniach swojego konta PolitPro.

Maks. liczba zapytań na minutę

API dopuszcza maksymalnie 30 zapytań na minutę. W przypadku przekroczenia limitu zwracany jest kod błędu 429.

Gdzie znajdę swój klucz API?

Swój klucz API znajdziesz w ustawieniach konta PolitPro.