PolitPro API Hakkında

API kimler için uygundur?

API, siyasi anket verilerini ve seçim trendlerini kendi ürünlerine, platformlarına veya analizlerine entegre etmek isteyen medya kuruluşları, yayıncılar, düşünce kuruluşları, veri sağlayıcıları ve geliştiricilere yöneliktir.

Verileri nasıl kullanabilirim?

Veriler; editoryal amaçlarla, kendi ürünlerinizde ve müşterileriniz için kullanılabilir. Ancak, temel ürünü siyasi anket verileri, seçim eğilimleri veya PolitPro'ya benzer rakip teklifler olan bağımsız bir platform oluşturulması yasaktır. Size en iyi şekilde nasıl destek olabileceğimizi öğrenmek için aşağıdaki iletişim formunu kullanarak bizimle iletişime geçin.

API hangi verileri sağlar?

API, 70'ten fazla parlamento için güncel seçim eğilimlerini, tarihsel eğilim gelişimlerini ve münferit seçim anketlerinin ham verilerini sunar – güncelliğe veya anket kuruluşuna göre ayrıştırılmış olarak. Veriler, yeni anketlerin yayınlanmasından sonra mümkün olan en kısa sürede güncellenir. Güncel seçim eğilimi, her yeni anketle yeniden hesaplanır. Tarihsel eğilim verileri haftada bir veri noktası olarak kaydedilir.

Hangi parlamentolar mevcut?

AD - Andorra
AL - Arnavutluk
AM - Ermenistan
AT - Avusturya
AT-1 - Burgenland
AT-2 - Karintiya
AT-3 - Aşağı Avusturya
AT-4 - Yukarı Avusturya
AT-5 - Salzburg
AT-6 - Stirya
AT-7 - Tirol
AT-8 - Vorarlberg
AT-9 - Viyana
BE - Belçika
BE-BR - Brüksel
BE-VL - Flaman Bölgesi
BE-WA - Valon Bölgesi
BG - Bulgaristan
CH - İsviçre
CY - Kıbrıs
CZ - Çekya
DE - Almanya
DE-BB - Brandenburg
DE-BE - Berlin
DE-BW - Baden-Württemberg
DE-BY - Bavyera
DE-HB - Bremen
DE-HE - Hessen
DE-HH - Hamburg
DE-MV - Mecklenburg-Vorpommern
DE-NI - Aşağı Saksonya
DE-NW - Kuzey Ren-Vestfalya
DE-RP - Rheinland-Pfalz
DE-SH - Schleswig-Holstein
DE-SL - Saarland
DE-SN - Saksonya
DE-ST - Saksonya-Anhalt
DE-TH - Türingiya
DK - Danimarka
EE - Estonya
ES - İspanya
FI - Finlandiya
FR - Fransa
GB - Birleşik Krallık
GE - Gürcistan
GR - Yunanistan
HR - Hırvatistan
HU - Macaristan
IE - İrlanda
IS - İzlanda
IT - İtalya
LT - Litvanya
LU - Lüksemburg
LV - Letonya
MD - Moldova
ME - Karadağ
MK - Kuzey Makedonya
MT - Malta
NL - Hollanda
NO - Norveç
PL - Polonya
PT - Portekiz
RO - Romanya
RU - Rusya
SE - İsveç
SI - Slovenya
SK - Slovakya
TR - Türkiye
UA - Ukrayna
XK - Kosova

Veriler ne kadar güvenilir?

Tüm veriler, algoritmalar, yapay zeka ve manuel denetimden oluşan çok aşamalı bir kalite kontrol sürecinden geçmektedir. PolitPro, uluslararası medya kuruluşları, araştırma kurumları ve siyasi kuruluşlar tarafından kullanılan, Avrupa seçim eğilimleri konusunda en güvenilir kaynaklardan biri olarak kabul edilmektedir. Verilerin doğruluğu garanti edilmez.

Tarihsel veri noktaları sonradan ayarlanır mı?

Geçmiş veriler, önceden haber verilmeksizin her an güncellenebilir. Düzeltmeler; güncel ve geçmiş verilerle veri setlerimizin genişletilmesi, ağırlıklandırma metodolojisindeki değişiklikler veya hata gidermeler gibi nedenlerle yapılabilir. Veri setlerimizi sürekli olarak genişlettiğimiz için, geçmiş verileri statik bir set olarak ele almak yerine düzenli olarak yeniden almanızı tavsiye ederiz.

PolitPro'yu kaynak olarak belirtmeli miyim?

Evet, verilerin her kamuya açık sunumunda PolitPro.eu'ya bağlantı içeren bir kaynak belirtilmesi zorunludur, örneğin "Kaynak: PolitPro.eu".

PolitPro Seçim Trendi Nedir?

PolitPro Seçim Trendi, tüm ilgili enstitülerin anket değerlerini ağırlıklı bir ortalamada toplar. Güncel anketler eskilere göre daha fazla ağırlıklandırılır ve enstitülerin tarihsel tahmin doğruluğu da hesaba katılır. Sonuç olarak, kısa vadeli sapmaları düzelten ve zaman içindeki gerçek siyasi dinamikleri görünür kılan, istatistiksel olarak sağlam bir trend çizgisi elde edilir.

PolitPro Nedir?

PolitPro, Avrupa'nın önde gelen seçim trendleri ve siyasi anket verileri platformudur. Uluslararası medya kuruluşları, siyasi kurumlar, üniversiteler ve araştırma merkezleri verilerimizi günlük çalışmalarında zaten kullanmaktadır. PolitPro siyasi olarak bağımsızdır ve kamuya açık anket verilerini, bilimsel veri setlerini kendi algoritmalarıyla birleştirir.

Şimdi Ücretsiz Teklif İsteyin

Ad Soyad
Şirket
E-posta
Veriler nasıl kullanılacak?
Kısa Açıklama

API Uç Noktaları ve Teknik Detaylar

API Uç Noktası: Güncel Seçim Trendi
https://politpro.eu/api/v1/{countryCode}/trend
Parlamentonun güncel PolitPro Seçim Trendi, mevcut anketlerin ağırlıklı ortalamasını hesaplar.
diff Bir önceki haftanın son ölçüm noktasına kıyasla değişim
election_diff Son seçime kıyasla değişim
Önerilen Güncelleme: Her 12 Saatte Bir
Webhook Olayı 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 } ] } } }

API Uç Noktası: Seçim Trendinin Gelişimi
https://politpro.eu/api/v1/{countryCode}/trend/history/{startYear}/{endYear}
Seçilen yıllara ait PolitPro Seçim Eğiliminin tarihsel gelişimi. Seçim eğilimi haftada bir ölçüm noktası olarak kaydedilir. Tarihsel veriler, parlamentoya bağlı olarak en erken 2019'dan itibaren mevcuttur.
?format=poll İsteğe bağlı URL parametresi. Tarihsel verileri anketler olarak gösterir.
?format=party İsteğe bağlı URL parametresi. Tarihsel verileri partilere göre değer koleksiyonu olarak gösterir.
Önerilen Güncelleme: Haftada Bir
Webhook Olayı 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 } ] } ] } }

API Uç Noktası: En Güncel Seçim Anketleri
https://politpro.eu/api/v1/{countryCode}/polls/latest
Parlamentoya ait en son beş seçim anketi, zaman sırasına göre azalan şekilde sıralanmıştır. Anket döneminin son günü esas alınır.
diff Enstitünün bir önceki anketine kıyasla değişim
election_diff Önceki seçime kıyasla değişim
Önerilen Güncelleme: Her 12 Saatte Bir
Webhook Olayı 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 } ] } ] } }

API Uç Noktası: Enstitüye Göre En Güncel Anket
https://politpro.eu/api/v1/{countryCode}/polls/institutes
Son 365 gün içinde anket verisi yayınlamış her enstitünün en güncel anketi. Anket döneminin son günü esas alınır.
diff Enstitünün bir önceki anketine kıyasla değişim
election_diff Önceki seçime kıyasla değişim
score Varsa: Enstitünün geçmiş seçim öncesi anketleri ve parti yanlılığına dayalı doğruluk oranı için PolitPro Skoru (0-100).
Önerilen Güncelleme: Her 12 Saatte Bir
Webhook Olayı 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 Nasıl Çalışır?

Webhook aracılığıyla sunucunuza yeni verileri otomatik olarak bildiriyoruz. Her bildirimin yapısı, ilgili uç noktanın yapısına uygun olup, olay türü için ek bir alanla zenginleştirilmiştir.

Kurulum

Sunucunuzun URL'sini PolitPro hesabınızın ayarlarından tanımlayın. İsteğe bağlı olarak, veri transferlerimizin gerçekliğini doğrulamak için bir Webhook Gizli Anahtarı oluşturabilirsiniz.

Teslimat ve Yanıt Formatı

Sunucunuz 'OK' yanıtı vermezse, teslimat başarısız sayılır. Bu durumda, teslimatı beş defaya kadar tekrar deneyeceğiz.

Veri Doğrulama

Her bildirim, başlıkta 'X-Webhook-Signature' alanını içerir. Bu alan, Webhook Gizli Anahtarınız anahtar olarak kullanılarak hesaplanan mesaj içeriğinin bir HMAC-SHA256 imzasını barındırır. Verilerin gerçekten bizden geldiğinden ve aktarım sırasında değiştirilmediğinden emin olmak için, imzayı kendi tarafınızda aynı şekilde (tüm bildirim üzerinde HMAC-SHA256) hesaplayın ve iletilen değerle karşılaştırın.

Kimlik Doğrulama

Kimlik doğrulama, başlıkta (header) bir Bearer Token kullanılarak yapılır: "Authorization: Bearer {token}". Token'ı, kaydolduktan sonra PolitPro hesabınızın ayarlarında bulabilirsiniz.

Dakikada Maks. İstek Sayısı

API, dakikada maksimum 30 isteğe izin verir. Bu sınır aşıldığında 429 hata kodu döndürülür.

API anahtarımı nerede bulabilirim?

API anahtarınızı PolitPro hesabınızın ayarlarında bulabilirsiniz.