О PolitPro API

Для кого подходит 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. При желании вы также можете создать секретный ключ вебхука (Webhook Secret), который позволит вам проверять подлинность передаваемых нами данных.

Доставка и формат ответа

Если ваш сервер не отвечает статусом "OK", доставка считается неуспешной. В этом случае мы повторим попытку отправки до пяти раз.

Верификация данных

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

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

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

Макс. запросов в минуту

API допускает не более 30 запросов в минуту. При превышении этого лимита будет возвращен код ошибки 429.

Где найти мой API-ключ?

API-ключ находится в настройках вашего аккаунта PolitPro.