Deeplomap Diplomatik Olay Veri Seti
Deeplomap, dünya genelindeki diplomatik ve jeopolitik gelişmeleri açık kaynaklardan derleyip yapılandırılmış olay kayıtlarına dönüştürür. Bu sayfa, veri setini araştırmalarında kullanmak isteyen akademisyenler ve analistler için erişim yollarını, alan tanımlarını ve atıf biçimini belgeler. Okuma API'si ücretsizdir; kayıt gerekmez.
Bu veri nedir?
Veri seti iki katmandan oluşur. Olaylar: haber kaynaklarından ve kamu OSINT kaynaklarından derlenen, tarih, ülke, tür ve etki skoru atanmış tekil kayıtlar. Hikayeler: aynı gerçek dünya gelişmesini anlatan olayların algoritmik olarak gruplandığı kümeler.
Platform tam makale metni saklamaz; her olay için başlık, kısa meta veri ve kaynak makale bağlantısı sunulur. Sınıflandırma ve skorlar kural tabanlıdır, özet metinleri AI üretimidir. Sürecin tamamı metodoloji sayfasında belgelenmiştir.
Kapsam not: kaynak havuzu Türkiye, MENA ve Karadeniz havzasında daha yoğundur; diğer bölgelerde kapsam görece sınırlı kalabilir. Veri canlıdır ve sürekli büyür; tekrarlanabilir analiz için sorgunuza from/to aralığı ekleyin ve erişim tarihini not edin.
Veri sözlüğü
Olay alanları /api/v1/events
| Alan | Tip | Açıklama |
|---|---|---|
| id | tamsayı | Olayın kalıcı kimliği. Sayfalama imleci (cursor) bu alan üzerinden ilerler. |
| occurredAt | ISO 8601 | Olayın gerçekleşme zamanı (kaynak yayın zamanı; yoksa sisteme giriş anı). |
| countryCode | ISO-2 / null | Olayın ilişkilendirildiği ülke kodu (örn. TR, US). Coğrafya çıkarılamadıysa null. |
| city | metin / null | Metinden çıkarılan şehir adı (varsa). |
| eventType | metin / null | Olay türü: DIPLOMATIC, POLITICAL, ECONOMIC, SECURITY, HUMANITARIAN, NATURAL_DISASTER. |
| impact | sayı 0-100 / null | Kural tabanlı etki skoru. Hesap yöntemi metodoloji sayfasında açıklanır. |
| title | metin | Orijinal dildeki haber başlığı. |
| language | ISO 639-1 / null | Başlığın orijinal dili (örn. en, tr). |
| titleTr | metin / null | Varsa Türkçe çeviri başlığı (orijinal zaten Türkçe ise null). |
| titleEn | metin / null | Varsa İngilizce çeviri başlığı (orijinal zaten İngilizce ise null). |
| sourceUrl | URL / null | Kaynak makalenin bağlantısı. Tam metin platformda saklanmaz; telif kaynağa aittir. |
| publisher | metin / null | Kaynak yayıncının adı (örn. Reuters, Anadolu Ajansı). |
| storyId | tamsayı / null | Olayın bağlı olduğu hikaye kümesinin kimliği (kümelenmemişse null). |
Hikaye alanları /api/v1/stories
| Alan | Tip | Açıklama |
|---|---|---|
| id | tamsayı | Hikaye kümesinin kalıcı kimliği. |
| title | metin | Küme başlığı. |
| summary | metin / null | AI üretimi hikaye özeti (üretilmediyse null). |
| countryCode | ISO-2 / null | Kümenin birincil ülkesi. |
| region | metin / null | Bölge etiketi (örn. mena, europe, global). |
| startedAt | ISO 8601 | Kümedeki en eski olayın zamanı. |
| lastEventAt | ISO 8601 | Kümedeki en yeni olayın zamanı. |
| importance | sayı 0-100 / null | Üye olayların etki skorlarından türetilen önem değeri. |
| isOngoing | boolean | 14 gün içinde yeni olay alan kümeler "devam ediyor" sayılır. |
| eventCount | tamsayı | Kümedeki olay sayısı. |
API hızlı başlangıç
İki okuma ucu vardır: GET /api/v1/events ve GET /api/v1/stories. Kimlik doğrulama gerekmez; anahtarla kota yükselir (aşağıya bakın).
Son olaylar (JSON):
curl "https://deeplomap.com/api/v1/events?limit=20"Filtreli sorgu: Haziran 2026'da Türkiye, etki skoru 60 ve üstü:
curl "https://deeplomap.com/api/v1/events?country=TR&from=2026-06-01&to=2026-06-30&minImpact=60"CSV ihracı (Excel/R/pandas uyumlu):
curl -o olaylar.csv "https://deeplomap.com/api/v1/events?country=TR&from=2026-06-01&to=2026-06-30&format=csv"Sayfalama: yanıttaki meta.nextCursor değerini bir sonraki isteğe verin (null gelene kadar):
curl "https://deeplomap.com/api/v1/events?limit=100&cursor=41250"API anahtarıyla yüksek kota:
curl -H "Authorization: Bearer dlm_live_XXXXXXXX..." \
"https://deeplomap.com/api/v1/events?limit=500"Yanıt zarfı: { "data": [...], "meta": { "limit", "count", "nextCursor" } }. Geçersiz parametrelerde 400 ve açıklayıcı Türkçe mesaj döner; kota aşımında 429 ve Retry-After başlığı. CSV yanıtlarında sonraki sayfa imleci X-Next-Cursor başlığındadır.
Parametre başvurusu
| Parametre | Geçerli uç | Açıklama |
|---|---|---|
| country | her ikisi | ISO-2 ülke kodu (örn. TR). Büyük/küçük harf fark etmez. |
| from / to | her ikisi | YYYY-MM-DD tarih aralığı. Olaylarda occurredAt, hikayelerde lastEventAt üzerine uygulanır; to günü kapsayıcıdır. |
| minImpact | her ikisi | 0-100 arası alt eşik. Olaylarda impact, hikayelerde importance alanına uygulanır. |
| q | her ikisi | Basit başlık araması (2-200 karakter, büyük/küçük harf duyarsız). |
| type | events | Olay türü filtresi (örn. DIPLOMATIC, SECURITY). |
| ongoing | stories | "true" yalnız devam eden, "false" yalnız kapanmış kümeler. |
| limit | her ikisi | Satır sayısı. Varsayılan 100; anahtarsız istekte en çok 100, anahtarlı istekte en çok 500. |
| cursor | her ikisi | Sayfalama imleci: önceki yanıtın meta.nextCursor değeri. Kayıtlar id azalan sırada döner. |
| format | her ikisi | "json" (varsayılan) ya da "csv" (UTF-8 BOM, Excel uyumlu). |
Kotalar ve API anahtarı
- Anahtarsız (anonim): IP başına dakikada 60 istek, istek başına en çok 100 satır. Küçük analizler ve deneme için yeterlidir.
- API anahtarıyla: anahtar başına dakikada 300 istek, istek başına en çok 500 satır. Toplu ihraç ve düzenli veri çekimi için önerilir.
Akademik kullanım için API anahtarı ücretsizdir. Anahtar almak için iletişim sayfasından "Akademik veri erişimi" konulu bir e-posta gönderin; kurumunuzu ve araştırma amacınızı kısaca belirtmeniz yeterlidir.
Atıf
Veri setini bir yayında kullanırsanız aşağıdaki biçimde atıf vermenizi rica ederiz (erişim tarihini kendi tarihinizle değiştirin):
Deeplomap (2026). Deeplomap Diplomatik Olay Veri Seti.
https://deeplomap.com (erişim tarihi: 6 Temmuz 2026).BibTeX:
@misc{deeplomap2026,
author = {{Deeplomap}},
title = {Deeplomap Diplomatik Olay Veri Seti},
year = {2026},
howpublished = {\url{https://deeplomap.com}},
note = {Erişim tarihi: 6 Temmuz 2026}
}Veri sürekli güncellendiği için yayınınızda kullandığınız from/to aralığını ve erişim tarihini belirtmeniz, sonuçların tekrarlanabilirliği açısından önemlidir.
Kullanım notları
- Olay kayıtları (başlık, meta veri, skorlar, kümeler) atıf şartıyla akademik ve editoryal kullanım için ücretsizdir.
- Kaynak makalelerin tam metinleri platformda yer almaz; makale içeriğinin telif hakkı ilgili yayıncıya aittir.
- Sınıflandırma ve skorlar otomatik üretilir ve hata payı içerir; kritik bulguları kaynak makaleden teyit edin. Bilinen sınırlamalar metodoloji sayfasında listelenir.
- Yoğun otomatik çekim planlıyorsanız anahtar alın ve istekler arasına makul bekleme koyun; kotalar herkes için adil erişimi korur.