Présentation de l'API PolitPro

À qui s'adresse l'API ?

L'API s'adresse aux groupes de médias, aux éditeurs, aux think tanks, aux fournisseurs de données et aux développeurs qui souhaitent intégrer des données de sondages politiques et des tendances électorales dans leurs propres produits, plateformes ou analyses.

Comment puis-je utiliser les données ?

Les données peuvent être utilisées à des fins éditoriales, dans vos propres produits et pour vos clients. Il n'est pas permis de créer une plateforme indépendante dont le produit principal serait des données de sondages politiques, des tendances électorales ou des offres concurrentes similaires à celles de PolitPro. Contactez-nous via le formulaire ci-dessous pour découvrir comment nous pouvons vous accompagner au mieux.

Quelles données l'API fournit-elle ?

L'API fournit les tendances électorales actuelles, l'évolution historique des tendances et les données brutes des sondages électoraux individuels pour plus de 70 parlements, ventilées par actualité ou par institut de sondage. Les données sont mises à jour le plus rapidement possible après la publication de nouveaux sondages. La tendance électorale actuelle est recalculée à chaque nouveau sondage. Les données historiques de tendance sont enregistrées une fois par semaine comme point de données.

Quels parlements sont disponibles ?

AD - Andorre
AL - Albanie
AM - Arménie
AT - Autriche
AT-1 - Burgenland
AT-2 - Carinthie
AT-3 - Basse-Autriche
AT-4 - Haute-Autriche
AT-5 - Salzbourg
AT-6 - Styrie
AT-7 - Tyrol
AT-8 - Vorarlberg
AT-9 - Vienne
BE - Belgique
BE-BR - Bruxelles
BE-VL - Flandre
BE-WA - Wallonie
BG - Bulgarie
CH - Suisse
CY - Chypre
CZ - Tchéquie
DE - Allemagne
DE-BB - Brandebourg
DE-BE - Berlin
DE-BW - Bade-Wurtemberg
DE-BY - Bavière
DE-HB - Brême
DE-HE - Hesse
DE-HH - Hambourg
DE-MV - Mecklembourg-Poméranie-Occidentale
DE-NI - Basse-Saxe
DE-NW - Rhénanie-du-Nord-Westphalie
DE-RP - Rhénanie-Palatinat
DE-SH - Schleswig-Holstein
DE-SL - Sarre
DE-SN - Saxe
DE-ST - Saxe-Anhalt
DE-TH - Thuringe
DK - Danemark
EE - Estonie
ES - Espagne
FI - Finlande
FR - France
GB - Royaume-Uni
GE - Géorgie
GR - Grèce
HR - Croatie
HU - Hongrie
IE - Irlande
IS - Islande
IT - Italie
LT - Lituanie
LU - Luxembourg
LV - Lettonie
MD - Moldavie
ME - Monténégro
MK - Macédoine du Nord
MT - Malte
NL - Pays-Bas
NO - Norvège
PL - Pologne
PT - Portugal
RO - Roumanie
RU - Russie
SE - Suède
SI - Slovénie
SK - Slovaquie
TR - Turquie
UA - Ukraine
XK - Kosovo

Quelle est la fiabilité des données ?

Toutes nos données sont soumises à un processus de vérification qualité rigoureux, combinant des algorithmes avancés, l'intelligence artificielle et un contrôle humain méticuleux. PolitPro est reconnue comme l'une des sources les plus fiables pour les tendances électorales européennes, plébiscitée par les médias internationaux, les instituts de recherche et les institutions politiques. Toutes les données sont fournies sans garantie.

Les points de données historiques sont-ils ajustés a posteriori ?

Les données historiques peuvent être ajustées à tout moment et sans préavis. Les corrections peuvent inclure l'enrichissement de nos bases de données avec des informations actuelles et passées, des modifications de la méthodologie de pondération ou des corrections d'erreurs. Étant donné que nous enrichissons constamment nos jeux de données, nous vous conseillons de récupérer régulièrement les données historiques plutôt que de les considérer comme un ensemble statique.

Dois-je citer PolitPro comme source ?

Oui, toute diffusion publique des données requiert une mention de la source avec un lien vers PolitPro.eu, par exemple : « Source : PolitPro.eu ».

Qu'est-ce que la tendance électorale PolitPro ?

La tendance électorale PolitPro agrège les résultats des sondages de tous les instituts pertinents pour en faire une moyenne pondérée. Les sondages actuels sont plus fortement pondérés que les plus anciens, et la fiabilité historique des prévisions des instituts est également prise en compte. Le résultat est une courbe de tendance statistiquement solide qui lisse les valeurs aberrantes à court terme et rend visible la dynamique politique réelle au fil du temps.

Qu'est-ce que PolitPro ?

PolitPro est la plateforme européenne de référence pour les tendances électorales et les données de sondages politiques. Les médias internationaux, les institutions politiques, ainsi que les universités et les centres de recherche utilisent déjà nos données dans leur travail quotidien. PolitPro est politiquement indépendant et combine les données de sondages publics et les ensembles de données scientifiques avec ses propres algorithmes.

Faire une demande sans engagement

Nom
Entreprise
E-mail
Comment comptez-vous utiliser les données ?
Votre message

Points d'accès et détails techniques

Point d'accès : Tendance électorale actuelle
https://politpro.eu/api/v1/{countryCode}/trend
La tendance électorale PolitPro actuelle du Parlement calcule une moyenne pondérée des sondages d'intention de vote récents.
diff Comparaison avec le dernier point de mesure de la semaine précédente
election_diff Comparaison avec la dernière élection
Mises à jour recommandées : Toutes les 12 heures
Événement 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 } ] } } }

Point d'accès : Évolution de la tendance électorale
https://politpro.eu/api/v1/{countryCode}/trend/history/{startYear}/{endYear}
Évolution historique de la tendance électorale PolitPro pour les années sélectionnées. La tendance électorale est enregistrée une fois par semaine comme point de données. Les données historiques sont disponibles à partir de 2019 au plus tôt, selon le parlement concerné.
?format=poll Paramètre URL optionnel. Affiche les données historiques sous forme de sondages individuels.
?format=party Paramètre URL optionnel. Affiche les données historiques agrégées par parti.
Mises à jour recommandées : Une fois par semaine
Événement 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 } ] } ] } }

Point d'accès : Derniers sondages électoraux
https://politpro.eu/api/v1/{countryCode}/polls/latest
Les cinq derniers sondages électoraux parlementaires, classés par ordre chronologique décroissant. La date de référence est le dernier jour de la période d'enquête.
diff Comparaison avec le précédent sondage de l'institut
election_diff Comparaison avec la précédente élection
Mises à jour recommandées : Toutes les 12 heures
Événement 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 } ] } ] } }

Point d'accès : Dernier sondage par institut
https://politpro.eu/api/v1/{countryCode}/polls/institutes
Le sondage le plus récent de chaque institut ayant publié des résultats au cours des 365 derniers jours. La date de référence est le dernier jour de la période d'enquête.
diff Comparaison avec le précédent sondage de l'institut
election_diff Comparaison avec la précédente élection
score Si disponible : Score PolitPro (0-100) de l'institut, évaluant sa précision sur la base des sondages pré-électoraux historiques et de son biais partisan.
Mises à jour recommandées : Toutes les 12 heures
Événement 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 } ] } ] } }

Comment fonctionne le Webhook ?

Grâce au webhook, nous informons automatiquement votre serveur des nouvelles données. La structure de chaque notification est conforme à celle du point de terminaison concerné, complétée par un champ additionnel pour le type d'événement.

Configuration

Enregistrez l'URL de votre serveur dans les paramètres de votre compte PolitPro. Vous avez également la possibilité d'y créer un secret de webhook, afin de vérifier l'authenticité de nos transferts de données.

Livraison et format de réponse

Si votre serveur ne répond pas par "OK", la livraison est considérée comme ayant échoué. Dans ce cas, nous retenterons l'envoi jusqu'à cinq fois.

Vérification des données

Chaque notification inclut dans son en-tête le champ "X-Webhook-Signature". Ce champ contient une signature HMAC-SHA256 du contenu du message, calculée en utilisant votre secret de webhook comme clé. Pour vérifier l'authenticité et l'intégrité des données, calculez la signature de votre côté de la même manière (HMAC-SHA256 sur l'intégralité de la notification) et comparez-la à la valeur transmise. Cela garantit que les données proviennent bien de nos services et n'ont pas été modifiées durant le transit.

Authentification

L'authentification s'effectue via un jeton Bearer dans l'en-tête : "Authorization: Bearer {token}". Vous trouverez le jeton dans les paramètres de votre compte PolitPro après votre inscription.

Max. requêtes par minute

L'API autorise un maximum de 30 requêtes par minute. En cas de dépassement de cette limite, le code d'erreur 429 sera renvoyé.

Où trouver ma clé API ?

Votre clé API se trouve dans les paramètres de votre compte PolitPro.