Це API PolitPro

Для кого призначений API?

API призначений для медіакомпаній, видавництв, аналітичних центрів, постачальників даних та розробників, які бажають інтегрувати дані політичних опитувань та виборчих трендів у власні продукти, платформи чи аналітичні матеріали.

Як я можу використовувати ці дані?

Дані можуть використовуватися в редакційних цілях, у власних продуктах та для власних клієнтів. Заборонено створювати незалежну платформу, основним продуктом якої є дані політичних опитувань, виборчі тенденції або інші конкурентні пропозиції, що дублюють функціонал PolitPro. Зв'яжіться з нами через форму зворотного зв'язку нижче, щоб дізнатися, як ми можемо найкраще вам допомогти.

Які дані надає API?

API надає актуальні виборчі тренди, історичну динаміку трендів, а також необроблені дані окремих виборчих опитувань для понад 70 парламентів – з розбивкою за актуальністю або за інститутом опитувань. Дані оновлюються якомога швидше після публікації нових опитувань. Актуальний виборчий тренд перераховується з кожним новим опитуванням. Історичні дані трендів фіксуються як точка даних раз на тиждень.

Які дані про парламенти доступні?

AD - Андорра
AL - Албанія
AM - Вірменія
AT - Австрія
AT-1 - Бургенланд
AT-2 - Каринтія
AT-3 - Нижня Австрія
AT-4 - Верхня Австрія
AT-5 - Зальцбург
AT-6 - Штирія
AT-7 - Тіроль
AT-8 - Форарльберг
AT-9 - Відень
BE - Бельгія
BE-BR - Брюссель
BE-VL - Фландрія
BE-WA - Валлонія
BG - Болгарія
CH - Швейцарія
CY - Кіпр
CZ - Чехія
DE - Німеччина
DE-BB - Бранденбург
DE-BE - Берлін
DE-BW - Баден-Вюртемберг
DE-BY - Баварія
DE-HB - Бремен
DE-HE - Гессен
DE-HH - Гамбург
DE-MV - Мекленбург-Передня Померанія
DE-NI - Нижня Саксонія
DE-NW - Північний Рейн-Вестфалія
DE-RP - Рейнланд-Пфальц
DE-SH - Шлезвіг-Гольштейн
DE-SL - Саарланд
DE-SN - Саксонія
DE-ST - Саксонія-Ангальт
DE-TH - Тюрингія
DK - Данія
EE - Естонія
ES - Іспанія
FI - Фінляндія
FR - Франція
GB - Велика Британія
GE - Грузія
GR - Греція
HR - Хорватія
HU - Угорщина
IE - Ірландія
IS - Ісландія
IT - Італія
LT - Литва
LU - Люксембург
LV - Латвія
MD - Молдова
ME - Чорногорія
MK - Північна Македонія
MT - Мальта
NL - Нідерланди
NO - Норвегія
PL - Польща
PT - Португалія
RO - Румунія
RU - Росія
SE - Швеція
SI - Словенія
SK - Словаччина
TR - Туреччина
UA - Україна
XK - Косово

Наскільки надійні ці дані?

Усі дані проходять багатоступеневу перевірку якості, що включає алгоритми, штучний інтелект та ручний контроль. PolitPro визнано одним із найнадійніших джерел європейських виборчих тенденцій, якому довіряють міжнародні медіа, дослідницькі інститути та політичні установи. Усі дані надаються без гарантій.

Чи коригуються історичні точки даних ретроспективно?

Історичні дані можуть бути змінені в будь-який час без попереднього повідомлення. Коригування можуть включати розширення наших наборів даних актуальною та історичною інформацією, зміни в методології зважування або виправлення помилок. Оскільки ми постійно розширюємо наші набори даних, рекомендуємо регулярно оновлювати історичні дані, а не розглядати їх як статичний набір.

Чи потрібно вказувати PolitPro як джерело?

Так, при будь-якому публічному представленні даних обов'язково вказувати джерело з посиланням на PolitPro.eu, наприклад, "Джерело: PolitPro.eu".

Що таке виборчий тренд PolitPro?

Виборчий тренд PolitPro агрегує дані опитувань усіх відповідних інститутів у зважене середнє значення. Актуальні опитування мають більшу вагу, ніж старіші, а також враховується історична точність прогнозів інститутів. Результатом є статистично надійна лінія тренду, яка згладжує короткострокові відхилення та відображає реальну політичну динаміку з часом.

Що таке PolitPro?

PolitPro – це провідна європейська платформа для аналізу виборчих трендів та даних політичних опитувань. Міжнародні ЗМІ, політичні інституції, а також університети та дослідницькі установи вже використовують наші дані у своїй щоденній роботі. PolitPro є політично незалежною платформою, яка поєднує публічні дані опитувань та наукові набори даних із власними алгоритмами.

Зробити запит без зобов'язань

Ім'я
Компанія
Електронна пошта
Як планується використовувати дані?
Короткий опис

Кінцеві точки та технічні деталі

Кінцева точка: Актуальний виборчий тренд
https://politpro.eu/api/v1/{countryCode}/trend
Поточний виборчий тренд PolitPro для парламенту розраховує зважене середнє значення актуальних опитувань щодо "недільного питання".
diff Порівняння з останнім виміром попереднього тижня
election_diff Порівняння з останніми виборами
Рекомендована частота оновлень: кожні 12 годин
Подія вебхука 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 } ] } } }

Кінцева точка: Динаміка виборчого тренду
https://politpro.eu/api/v1/{countryCode}/trend/history/{startYear}/{endYear}
Історична динаміка виборчого тренду PolitPro за обрані роки. Виборчий тренд зберігається як точка виміру раз на тиждень. Історичні дані доступні щонайраніше з 2019 року, залежно від парламенту.
?format=poll Необов'язковий URL-параметр. Відображає історичні дані як опитування.
?format=party Необов'язковий URL-параметр. Відображає історичні дані як сукупність значень за партіями.
Рекомендована частота оновлень: раз на тиждень
Подія вебхука 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 } ] } ] } }

Кінцева точка: Найновіші виборчі опитування
https://politpro.eu/api/v1/{countryCode}/polls/latest
П'ять найновіших парламентських виборчих опитувань, відсортованих у зворотному хронологічному порядку. Визначальним є останній день періоду опитування.
diff Порівняння з попереднім опитуванням інституту
election_diff Порівняння з попередніми виборами
Рекомендована частота оновлень: кожні 12 годин
Подія вебхука 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 } ] } ] } }

Кінцева точка: Найновіше опитування за інститутом
https://politpro.eu/api/v1/{countryCode}/polls/institutes
Найновіше опитування кожного інституту, який публікував дані опитувань протягом останніх 365 днів. Вирішальним є останній день періоду проведення опитування.
diff Порівняння з попереднім опитуванням інституту
election_diff Порівняння з попередніми виборами
score Якщо доступно: Рейтинг PolitPro (0-100) інституту щодо точності, розрахований на основі історичних передвиборчих опитувань та упередженості до партій.
Рекомендована частота оновлень: кожні 12 годин
Подія вебхука 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 } ] } ] } }

Як працює вебхук?

За допомогою вебхука ми автоматично інформуємо ваш сервер про нові дані. Структура кожного сповіщення відповідає структурі відповідної кінцевої точки, доповнена додатковим полем для типу події.

Налаштування

Вкажіть URL-адресу вашого сервера в налаштуваннях вашого облікового запису PolitPro. За бажанням, ви також можете створити секретний ключ вебхука, за допомогою якого можна перевірити справжність наших передач даних.

Доставка та формат відповіді

Якщо ваш сервер не відповідає "OK", доставка вважається невдалою. У такому випадку ми повторимо спробу доставки до п'яти разів.

Перевірка даних

Кожне сповіщення містить у заголовку поле "X-Webhook-Signature". Воно містить HMAC-SHA256 підпис вмісту повідомлення, розрахований з використанням вашого секретного ключа вебхука. Розрахуйте підпис на вашому боці таким же чином (HMAC-SHA256 для всього сповіщення) та порівняйте його з переданим значенням, щоб переконатися, що дані дійсно походять від нас і не були змінені під час передачі.

Аутентифікація

Аутентифікація здійснюється за допомогою Bearer Token у заголовку: "Authorization: Bearer {token}". Токен можна знайти після реєстрації в налаштуваннях вашого облікового запису PolitPro.

Макс. запитів на хвилину

API дозволяє максимум 30 запитів на хвилину. У разі перевищення цього ліміту буде повернуто код помилки 429.

Де я можу знайти свій API-ключ?

Ваш API-ключ ви знайдете в налаштуваннях вашого облікового запису PolitPro.