Ücretsiz üye ol

İl, İlçe, Mahalle API

81 il, 973 ilçe ve 45.000'den fazla mahalle/köy; adlar, plaka kodları ve koordinatlarla.

Ücretsiz pakette var JSON · Türkçe5 uç Kaynak: Wikidata

/v1/konumlar/iller tüm illeri plaka koduyla, /v1/konumlar/iller/{il}/ilceler ilçeleri koordinatlarıyla döndürür; adres formlarındaki il → ilçe açılır listesi için tek istek yeter. /v1/konumlar/bul bir koordinatın en yakın il ve ilçesini bulur.

Mahalle ve köyler /v1/konumlar/mahalleler ve /v1/konumlar/yerler/ara uçlarında. Mahalle/köy verisi Wikidata'dan (CC0) derlenir ve kapsamı resmî listeden azdır; adres doğrulama için posta kodu verisiyle birlikte kullanılmalıdır.

Hızlı başlangıç

Anahtarınızı X-API-Key başlığında gönderin (ücretsiz anahtar al). Anahtarı tarayıcı koduna koymayın; sunucunuzdan çağırıp sonucu önbelleğe alın.

<?php
$ch = curl_init('https://api.veriapi.pro/v1/konumlar/iller/duzce/ilceler');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => ['X-API-Key: va_ANAHTARINIZ'],
]);
$yanit = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($yanit['veri']);
const yanit = await fetch("https://api.veriapi.pro/v1/konumlar/iller/duzce/ilceler", {
  headers: { "X-API-Key": "va_ANAHTARINIZ" },
});
const { veri, kaynak } = await yanit.json();
console.log(veri);
import requests

r = requests.get("https://api.veriapi.pro/v1/konumlar/iller/duzce/ilceler",
                 headers={"X-API-Key": "va_ANAHTARINIZ"}, timeout=10)
print(r.json()["veri"])
curl -H "X-API-Key: va_ANAHTARINIZ" \
  "https://api.veriapi.pro/v1/konumlar/iller/duzce/ilceler"

Örnek yanıt

GET https://api.veriapi.pro/v1/konumlar/iller/duzce/ilceler — gerçek veriyle; listeler kısaltıldı.

{
  "veri": {
    "il": {
      "id": 1044,
      "tur": "il",
      "ad": "Düzce",
      "il": "Düzce",
      "plaka": 81,
      "slug": "duzce",
      "enlem": 40.84167,
      "boylam": 31.15833
    },
    "ilceler": [
      {
        "id": 1045,
        "tur": "ilce",
        "ad": "Akçakoca",
        "il": "Düzce",
        "plaka": 81,
        "slug": "duzce-akcakoca",
        "enlem": 41.08897,
        "boylam": 31.12497
      },
      {
        "id": 1052,
        "tur": "ilce",
        "ad": "Çilimli",
        "il": "Düzce",
        "plaka": 81,
        "slug": "duzce-cilimli",
        "enlem": 40.89306,
        "boylam": 31.04667
      },
      {
        "id": 1046,
        "tur": "ilce",
        "ad": "Cumayeri",
        "il": "Düzce",
        "plaka": 81,
        "slug": "duzce-cumayeri",
        "enlem": 40.87361,
        "boylam": 30.95083
      },
      "… 5 öğe daha"
    ]
  },
  "kaynak": [
    {
      "kod": "wikidata",
      "ad": "Wikidata",
      "lisans": "CC0 1.0",
      "atif": "Koordinatlar: Wikidata (CC0)",
      "url": "https://www.wikidata.org/"
    }
  ],
  "guncelleme": null,
  "bayat": false
}

Uçlar ve parametreler

GET /v1/konumlar/iller ücretsiz pakette 1 birim

81 il ve 973 ilçe, koordinatlarıyla

GET /v1/konumlar/iller/{il}/ilceler ücretsiz pakette 1 birim

İlin ilçeleri

ParametreTürAçıklama
il* metin
GET /v1/konumlar/bul ücretsiz pakette 1 birim

Konum çöz (slug, il/ilçe ya da en yakın koordinat)

ParametreTürAçıklama
konum metin Konum slug'ı (ör. duzce-akcakoca)
il metin İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)
ilce metin İlçe adı (il ile birlikte)
enlem sayı Enlem (en yakın konum)
boylam sayı Boylam
GET /v1/konumlar/mahalleler ücretli paket 1 birim

İl/ilçe → mahalle ve köyler (kısayol)

ParametreTürAçıklama
il* metin
ilce* metin
tur metin
GET /v1/konumlar/yerler/ara ücretli paket 1 birim

Mahalle / köy ara

ParametreTürAçıklama
q* metin
il metin
tur metin
limit tam sayı varsayılan: 20

Konum alan uçlarda konum (slug), il + ilce (ad, slug ya da plaka) ya da enlem + boylam kullanılabilir. Tüm parametreler: OpenAPI belgesi.

Nerelerde kullanılır?

  • ✓E-ticaret ve kayıt formlarında il/ilçe seçimi
  • ✓Koordinattan ilçe bulma
  • ✓Yerel rehber ve harita uygulamaları

Kaynak ve lisans

  • Wikidata · CC0 1.0 · kaynak
    Atıf: Koordinatlar: Wikidata (CC0)

Her yanıtın kaynak alanı bu bilgiyi taşır; veriyi gösterdiğiniz yerde atıf metnini yazın.

Sık sorulan sorular

İl ilçe API'si ücretsiz mi?

İl ve ilçe uçları ücretsiz pakette açıktır; mahalle/köy uçları Başlangıç ve üstü paketlerdedir.

İlçe sayısı güncel mi?

Evet, 973 ilçe (resmî sayı) bulunur.

Koordinatlar nereden?

İl ve ilçe merkez koordinatları Wikidata'dan (CC0) alınır.

Bu sayfa şu aramalar için de: il ilçe json · türkiye il ilçe listesi api · mahalle listesi api · köy listesi api · plaka kodu api