API
API, suç ve asayiş olaylarının il, ilçe ve mahalle düzeyindeki kayıtlarını ve özetlerini JSON biçiminde verir. Erişim, kurumsal lisansla verilen anahtarla sağlanır.
Kapsam
Sitede yayımlanan cinayet ve silahlı saldırı göstergelerinin yanında aşağıdaki türlerdeki olaylar da konum düzeyinde endekslenir. Türlerin kanundaki tanımları diğer suçlar sayfasındadır. Silahlı saldırılar tür fark etmeksizin silahli alanıyla işaretlenir.
API olay kayıtlarını ve sayıları verir. Nüfusa oran ve endeks yalnız cinayet ve silahlı saldırı için hesaplanır; diğer türlerde basına yansıyan olaylar, resmî kayıtların illere göre düzensiz dağılan küçük bir bölümüdür. Uyuşturucu ve kaçakçılık kayıtlarının çoğu kolluk operasyonudur.
Konum ve gizlilik
- Her kaydın konum_duzeyi alanı il, ilçe ya da mahalledir. İlçesi doğrulanamayan olaylar yalnız il sorgularında döner.
- Mahalle ve köy adları TÜİK Adrese Dayalı Nüfus Kayıt Sistemi listesiyle eşleştirilir. Nüfusu 1.000’in altındaki yerleşimlerde konum ilçe düzeyinde verilir.
- Cinsel suçlarda konum en çok ilçe düzeyindedir.
- Tarih ay çözünürlüğündedir. Kayıtlarda ad, yaş, cinsiyet, adres, sokak ve kaynak bağlantısı bulunmaz.
- Kodlar Türkçe karakterler sadeleştirilerek küçük harfle yazılır: Kadıköy için kadikoy. Kodların listesi /api/v1/konumlar uç noktasındadır.
Kimlik doğrulama
Her istek, lisansla verilen anahtarı taşımalıdır. Anahtar bir kez gösterilir; sunucuda yalnız özeti saklanır. Günlük istek limiti pakete göre belirlenir ve her yanıtın başlığında bildirilir.
Authorization: Bearer se_•••••••••••••••• X-Istek-Limiti: 5000 X-Istek-Kalan: 4987
Uç noktalar
GET /api/v1/olaylar
Bir konumdaki olay kayıtlarını aya göre sıralı ve sayfalı olarak verir.
- il
- İl kodu, zorunlu. Örnek: istanbul
- ilce
- İlçe kodu. Örnek: kadikoy
- mahalle
- Mahalle kodu; ilce ile birlikte
- tur
- Bir ya da virgülle ayrılmış birden fazla tür kodu
- yil
- Olay yılı; varsayılan en son yıl
- ay_bas, ay_bit
- Ay aralığı, 1–12
- silahli
- 1: yalnız silahlı saldırılar
- konum_duzeyi
- il, ilce ya da mahalle
- limit, sayfa
- Sayfa başına en çok 500 kayıt
GET /api/v1/olaylar?il=izmir&ilce=bornova&tur=hirsizlik,gasp&ay_bas=1&ay_bit=6
Authorization: Bearer se_••••••••••••••••
200 OK
X-Istek-Limiti: 5000
X-Istek-Kalan: 4987
{
"yil": 2025,
"sorgu": { "il": "izmir", "ilce": "bornova", "tur": ["hirsizlik", "gasp"], "ay_bas": 1, "ay_bit": 6 },
"sayfa": 1, "limit": 100, "toplam": 1,
"veri": [
{
"id": "ornek00000000001", "yil": 2025, "ay": 3,
"il": "izmir", "il_ad": "İzmir", "ilce": "bornova", "ilce_ad": "Bornova",
"mahalle": "kazimdirik", "mahalle_ad": "Kazımdirik", "mahalle_tip": "mahalle", "konum_duzeyi": "mahalle",
"tur": "hirsizlik", "yontem": null, "sonuc": null, "silahli": 0, "kaynak_sayisi": 2
}
]
}GET /api/v1/ozet
Bir konum için türe ve aya göre olay sayılarını verir. komsu=1 parametresiyle komşu ilçeler de hesaba katılır.
- il
- İl kodu, zorunlu
- ilce
- İlçe kodu
- mahalle
- Mahalle kodu
- komsu
- 1: ilçeyle ortak sınırı olan ilçeleri de kat
- yil
- Olay yılı
GET /api/v1/ozet?il=izmir&ilce=bornova&komsu=1
{
"yil": 2025,
"konum": {
"il": "izmir", "ilce": "bornova", "mahalle": null,
"komsular": ["izmir/bayrakli", "izmir/buca", "izmir/karsiyaka", "izmir/kemalpasa",
"izmir/konak", "izmir/menemen", "manisa/yunusemre"]
},
"toplam": <sayı>,
"silahli": <sayı>,
"konum_duzeyi": { "ilce": <sayı>, "mahalle": <sayı> },
"turler": {
"hirsizlik": { "n": <sayı>, "silahli": <sayı>, "aylik": [<12 ay>] },
"kasten_yaralama": { … }
}
}GET /api/v1/konumlar
İlleri, bir ilin ilçelerini ya da bir ilçede olay kaydı bulunan mahalleleri kodları ve olay sayılarıyla verir.
- il
- Verilirse ilin ilçeleri; verilmezse iller
- ilce
- Verilirse ilçenin olay kaydı bulunan mahalleleri
- yil
- Olay yılı
GET /api/v1/turler
Tür kodlarını, adlarını, ilgili kanun maddelerini ve her tür için verilen en ayrıntılı konum düzeyini verir.
Alanlar
- id
- Kaydın kalıcı kimliği
- yil, ay
- Olay yılı ve ayı
- il, il_ad
- İl kodu ve adı
- ilce, ilce_ad
- İlçe kodu ve adı; ilçe doğrulanamadıysa null
- mahalle, mahalle_ad
- Resmî mahalle ya da köy kodu ve adı; yoksa null
- mahalle_tip
- mahalle ya da koy
- konum_duzeyi
- il, ilce ya da mahalle
- tur
- Tür kodu; bkz. kapsam
- yontem
- atesli_silah, kesici_alet, darp, diger ya da null
- sonuc
- olum, yaralanma, girisim ya da null
- silahli
- 1: ateşli silah ya da kesici aletle yapılan, ölüm ya da yaralanmayla biten saldırı
- kaynak_sayisi
- Olayı anlatan tekilleştirilmiş haber sayısı
Hatalar
- 400
- Eksik ya da geçersiz parametre
- 401
- Anahtar yok ya da geçersiz
- 403
- Anahtarın kapsamı dışında bir il
- 404
- Bilinmeyen uç nokta
- 429
- Günlük istek limiti doldu
{ "hata": "il parametresi gerekli." }Erişim
Anahtar, erişim talebinin değerlendirilmesinden sonra yıllık kurumsal lisansla verilir. Sorgu limiti, kapsanan iller ve ürün içi gösterim hakkı sözleşmede tanımlanır. Talep değerlendirilirken deneme anahtarı verilebilir.
Dosya teslimi ve paket teklifi için kurumsal teklif formunu kullanın.