Това е 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. По желание можете да създадете и уебхук секретен ключ, с който да проверявате автентичността на нашите трансфери на данни.

Доставка и формат на отговора

Ако вашият сървър не отговори с „ОК“, доставката се счита за неуспешна. В такъв случай ще опитаме да доставим съобщението до пет пъти.

Проверка на данните

Всяко известие съдържа полето „X-Webhook-Signature“ в хедъра. То представлява HMAC-SHA256 подпис на съдържанието на съобщението, изчислен с вашия уебхук секретен ключ. Изчислете подписа от ваша страна по същия начин (HMAC-SHA256 върху цялото известие) и го сравнете с предадената стойност, за да се уверите, че данните наистина произхождат от нас и не са били променяни по време на преноса.

Автентикация

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

Макс. заявки в минута

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

Къде мога да намеря своя API ключ?

Вашият API ключ ще намерите в настройките на Вашия PolitPro акаунт.