Αυτό είναι το API του PolitPro

Σε ποιους απευθύνεται το API;

Το API απευθύνεται σε μέσα ενημέρωσης, εκδοτικούς οίκους, δεξαμενές σκέψης (think tanks), παρόχους δεδομένων και προγραμματιστές που επιθυμούν να ενσωματώσουν πολιτικά δεδομένα δημοσκοπήσεων και εκλογικές τάσεις σε δικά τους προϊόντα, πλατφόρμες ή αναλύσεις.

Πώς επιτρέπεται να χρησιμοποιήσω τα δεδομένα;

Τα δεδομένα μπορούν να χρησιμοποιηθούν για συντακτικούς σκοπούς, σε δικά σας προϊόντα και για τους δικούς σας πελάτες. Δεν επιτρέπεται η ανάπτυξη αυτόνομης πλατφόρμας που έχει ως κύριο προϊόν της δεδομένα πολιτικών δημοσκοπήσεων, εκλογικές τάσεις ή παρόμοιες υπηρεσίες που ανταγωνίζονται το 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 - Κόσοβο

Πόσο αξιόπιστα είναι τα δεδομένα;

Όλα τα δεδομένα υποβάλλονται σε έναν αυστηρό, πολυεπίπεδο έλεγχο ποιότητας, ο οποίος περιλαμβάνει αλγόριθμους, τεχνητή νοημοσύνη (AI) και ενδελεχή χειροκίνητη επαλήθευση. Το PolitPro αναγνωρίζεται ως μία από τις πλέον αξιόπιστες πηγές για τις ευρωπαϊκές εκλογικές τάσεις και εξελίξεις, εμπιστευόμενο από διεθνή μέσα ενημέρωσης, ερευνητικά ιδρύματα και πολιτικούς φορείς. Όλα τα δεδομένα παρέχονται χωρίς εγγύηση ως προς την ακρίβειά τους.

Προσαρμόζονται αναδρομικά τα ιστορικά σημεία δεδομένων;

Τα ιστορικά δεδομένα ενδέχεται να αναπροσαρμοστούν οποιαδήποτε στιγμή, χωρίς προηγούμενη ειδοποίηση. Οι διορθώσεις μπορεί να περιλαμβάνουν, για παράδειγμα, την επέκταση των συνόλων δεδομένων μας με νέα και ιστορικά στοιχεία, αλλαγές στη μεθοδολογία στάθμισης ή επιδιορθώσεις σφαλμάτων. Καθώς εμπλουτίζουμε συνεχώς τα δεδομένα μας, συνιστούμε να ανακτάτε τα ιστορικά δεδομένα τακτικά, αντί να τα αντιμετωπίζετε ως ένα στατικό σύνολο.

Πρέπει να αναφέρω το PolitPro ως πηγή;

Ναι, σε κάθε δημόσια παρουσίαση των δεδομένων απαιτείται αναφορά πηγής με σύνδεσμο προς το PolitPro.eu, π.χ. «Πηγή: PolitPro.eu».

Τι είναι η εκλογική τάση του PolitPro;

Η εκλογική τάση του PolitPro συγκεντρώνει τα αποτελέσματα των δημοσκοπήσεων όλων των σχετικών ινστιτούτων σε έναν σταθμισμένο μέσο όρο. Οι τρέχουσες δημοσκοπήσεις σταθμίζονται περισσότερο από τις παλαιότερες, ενώ λαμβάνεται υπόψη και η ιστορική ακρίβεια πρόβλεψης των ινστιτούτων. Το αποτέλεσμα είναι μια στατιστικά αξιόπιστη γραμμή τάσης, η οποία εξομαλύνει τις βραχυπρόθεσμες αποκλίσεις και καθιστά ορατή την πραγματική πολιτική δυναμική με την πάροδο του χρόνου.

Τι είναι το PolitPro;

Το PolitPro είναι η κορυφαία πλατφόρμα της Ευρώπης για εκλογικές τάσεις και δεδομένα πολιτικών δημοσκοπήσεων. Διεθνή μέσα ενημέρωσης, πολιτικοί θεσμοί, καθώς και πανεπιστήμια και ερευνητικά κέντρα χρησιμοποιούν ήδη τα δεδομένα μας στην καθημερινή τους εργασία. Το PolitPro είναι πολιτικά ανεξάρτητο και συνδυάζει δημόσια δεδομένα δημοσκοπήσεων και επιστημονικά σύνολα δεδομένων με τους δικούς του αλγόριθμους.

Υποβάλετε αίτημα τώρα, χωρίς δέσμευση

Όνομα
Εταιρεία
Email
Πώς σκοπεύετε να χρησιμοποιήσετε τα δεδομένα;
Σύντομη περιγραφή

Τελικά Σημεία & Τεχνικές Λεπτομέρειες

Τελικό Σημείο: Τρέχουσα εκλογική τάση

https://politpro.eu/api/v1/{countryCode}/trend
Η τρέχουσα εκλογική τάση του PolitPro για το Κοινοβούλιο υπολογίζει έναν σταθμισμένο μέσο όρο των τρεχουσών δημοσκοπήσεων πρόθεσης ψήφου.
diff Σύγκριση με το τελευταίο σημείο μέτρησης της προηγούμενης εβδομάδας
election_diff Σύγκριση με τις τελευταίες εκλογές
Προτεινόμενη συχνότητα ενημέρωσης: Κάθε 12 ώρες
Συμβάν 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 } ] } } }

Τελικό Σημείο: Εξέλιξη της εκλογικής τάσης

https://politpro.eu/api/v1/{countryCode}/trend/history/{startYear}/{endYear}
Ιστορική εξέλιξη της εκλογικής τάσης του PolitPro για τα επιλεγμένα έτη. Η εκλογική τάση αποθηκεύεται μία φορά την εβδομάδα ως σημείο μέτρησης. Τα ιστορικά δεδομένα είναι διαθέσιμα το νωρίτερο από το 2019, ανάλογα με το κοινοβούλιο.
?format=poll Προαιρετική παράμετρος URL. Εμφανίζει τα ιστορικά δεδομένα ως δημοσκοπήσεις.
?format=party Προαιρετική παράμετρος URL. Εμφανίζει τα ιστορικά δεδομένα ως συλλογή τιμών ανά κόμμα.
Προτεινόμενη συχνότητα ενημέρωσης: Μία φορά την εβδομάδα
Συμβάν 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 } ] } ] } }

Τελικό Σημείο: Πιο πρόσφατες εκλογικές δημοσκοπήσεις

https://politpro.eu/api/v1/{countryCode}/polls/latest
Οι πέντε πιο πρόσφατες δημοσκοπήσεις για τις βουλευτικές εκλογές, ταξινομημένες χρονολογικά σε φθίνουσα σειρά. Ως καθοριστική ημερομηνία λαμβάνεται η τελευταία ημέρα της περιόδου διεξαγωγής της έρευνας.
diff Σύγκριση με την προηγούμενη δημοσκόπηση του ινστιτούτου
election_diff Σύγκριση με τις προηγούμενες εκλογές
Προτεινόμενη συχνότητα ενημέρωσης: Κάθε 12 ώρες
Συμβάν 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 } ] } ] } }

Τελικό Σημείο: Πιο πρόσφατη δημοσκόπηση ανά ινστιτούτο

https://politpro.eu/api/v1/{countryCode}/polls/institutes
Η πιο πρόσφατη δημοσκόπηση από κάθε ινστιτούτο που έχει δημοσιεύσει αποτελέσματα δημοσκοπήσεων τους τελευταίους 365 ημέρες. Ως ημερομηνία αναφοράς λαμβάνεται η τελευταία ημέρα της περιόδου διεξαγωγής της έρευνας.
diff Σύγκριση με την προηγούμενη δημοσκόπηση του ινστιτούτου
election_diff Σύγκριση με τις προηγούμενες εκλογές
score Εφόσον υπάρχει: Βαθμολογία PolitPro (0-100) του ινστιτούτου για την ακρίβεια, βασισμένη σε ιστορικές προεκλογικές δημοσκοπήσεις και την κομματική μεροληψία.
Προτεινόμενη συχνότητα ενημέρωσης: Κάθε 12 ώρες
Συμβάν 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 } ] } ] } }

Πώς λειτουργεί το Webhook;

Μέσω του Webhook, ο διακομιστής σου ενημερώνεται αυτόματα για νέα δεδομένα. Η δομή κάθε ειδοποίησης ακολουθεί αυτή του αντίστοιχου τελικού σημείου (endpoint), με την προσθήκη ενός επιπλέον πεδίου για τον τύπο του συμβάντος.

Ρύθμιση

Καταχώρισε τη διεύθυνση URL του διακομιστή σου στις ρυθμίσεις του λογαριασμού σου στο PolitPro. Προαιρετικά, μπορείς να δημιουργήσεις ένα Webhook Secret για να επαληθεύεις την αυθεντικότητα των μεταδόσεων δεδομένων μας.

Παράδοση & Μορφή Απάντησης

Εάν ο διακομιστής σου δεν απαντήσει με "OK", η παράδοση θεωρείται αποτυχημένη. Σε αυτή την περίπτωση, θα επιχειρήσουμε την παράδοση έως και πέντε φορές.

Επαλήθευση των Δεδομένων

Κάθε ειδοποίηση περιέχει στην κεφαλίδα το πεδίο "X-Webhook-Signature". Αυτό περιέχει μια υπογραφή HMAC-SHA256 του περιεχομένου του μηνύματος, υπολογισμένη χρησιμοποιώντας το Webhook Secret σου ως κλειδί. Υπολόγισε την υπογραφή από την πλευρά σου με τον ίδιο τρόπο (HMAC-SHA256 για ολόκληρη την ειδοποίηση) και σύγκρινέ την με την τιμή που έχει σταλεί, για να διασφαλίσεις ότι τα δεδομένα προέρχονται πράγματι από εμάς και δεν έχουν αλλοιωθεί κατά τη μεταφορά.

Πιστοποίηση

Η πιστοποίηση γίνεται μέσω Bearer Token στην κεφαλίδα (header): "Authorization: Bearer {token}". Το token θα το βρείτε μετά την εγγραφή σας στις ρυθμίσεις του λογαριασμού σας στο PolitPro.

Μέγ. Αιτήματα ανά λεπτό

Το API επιτρέπει έως και 30 αιτήματα ανά λεπτό. Σε περίπτωση υπέρβασης, επιστρέφεται ο κωδικός σφάλματος 429.

Πού μπορώ να βρω το API-Key μου;

Το API-Key σας θα το βρείτε στις ρυθμίσεις του λογαριασμού σας στο PolitPro.