İl & İlçe API

freeYayında11 endpoint · TÜİK · ubeydeozdmr/turkiye-api veri seti · Statik veri; ETag ile 1 saat önbellek

TÜİK il ve ilçe kodları, plaka ve telefon alan kodları, nüfus, yüzölçümü, rakım, bölge ve NUTS sınıflaması, koordinat. Koordinattan en yakın il ve isim araması dahil.

curl "https://api.apikapi.com/v1/provinces?region=Akdeniz" \
  -H "X-API-Key: apk_…"
örnek yanıt · /v1/provinces
{
  "data": [
    {
      "code": 6,
      "name": "Ankara",
      "slug": "ankara",
      "population": 5910320,
      "area_km2": 25632,
      "altitude_m": 905,
      "phone_area_codes": [
        312
      ],
      "is_coastal": false,
      "is_metropolitan": true,
      "region_tr": "İç Anadolu",
      "region_en": "Central Anatolia",
      "nuts1": "TR5",
      "nuts2": "TR51",
      "nuts3": "TR510",
      "lat": 39.9207759,
      "lng": 32.8540497,
      "neighbors": [
        14,
        18,
        26,
        40,
        42,
        68,
        71
      ],
      "density": 230.3,
      "district_count": 25
    }
  ],
  "count": 81
}
Endpoint
11yayında
Katman
Freeücretsiz
Tazelik
Statik veri
Free aylık limit
2.000istek / ay
Neler var

Bir uygulamanın il & ilçe için ihtiyacı olanlar

  • 81 il ve 973 ilçe, TÜİK ve plaka kodlarıyla
  • Nüfus, yüzölçümü, rakım, bölge, NUTS1-3 ve koordinat alanları
  • Büyükşehir ve kıyı filtreleri
  • Koordinattan en yakın il (reverse geocoding)
  • İl + ilçe isim araması
  • İBBS (NUTS) bölgeleri: 12 düzey-1, 26 düzey-2
  • Komşu iller ve komşu ilçeler

Veri

Güncellendi 7 Eyl 2026
Veri dönemi
ADNKS 2025 · CL_IBBS 1.2
Son güncelleme
7 Eyl 2026
Güncelleme sıklığı
yılda bir (TÜİK ADNKS sonuçları açıklandığında, genellikle Şubat)
Beklenen sonraki güncelleme
Şubat 2027
Sürümler
Eylül 2026 · güncel

Her çekim bir sürüm bırakır: isteğe ?release=2026-09 eklersen listeyi ve sınırları o sürümdeki haliyle alırsın, parametresiz istek her zaman güncel sürümü döner.

İl/ilçe/İBBS kodları, komşuluklar, ilçe koordinatı ve yoğunluk TÜİK CİP'ten; ilin rakım, alan kodu, kıyı/büyükşehir gibi ek alanları turkiye-api'den gelir. Kod listesi sürümü CL_IBBS 1.2.

KaynakTÜİK · ubeydeozdmr/turkiye-api veri seti

Statik veri; ETag ile 1 saat önbellek.

KatmanFree ile başla

Tüm uçlar ücretsiz katmanda. Kota dolunca istekler 429 döner, veri kesilmez.

Fiyatlandırmayı gör →
Kimlik doğrulamaX-API-Key başlığı

Anahtarını konsolda geo kapsamına yetkilendir; kapsam dışı çağrılar 403 döner.

Referans

Endpoint referansı

GET

/v1/provinces

Konsolda dene

Tüm iller — 81 il; nüfus, yüzölçümü, rakım, bölge, NUTS, koordinat ve alan kodu ile.

Parametreler

ParametreTipYerZorunluAçıklama
regionstringsorguHayırBölge adı ile filtrele. · örn. Akdeniz
metropolitanbooleansorguHayırYalnızca büyükşehirler. · örn. true
coastalbooleansorguHayırYalnızca kıyı illeri. · örn. true
releasestringsorguHayırVeri sürümü; boşsa güncel sürüm döner. Bilinmeyen sürüm 404 verir. · örn. 2026-09

İstek

curl "https://api.apikapi.com/v1/provinces?region=Akdeniz" \
  -H "X-API-Key: apk_…"

Örnek yanıt

/v1/provinces · 200
1{
2 "data": [
3 {
4 "code": 6,
5 "name": "Ankara",
6 "slug": "ankara",
7 "population": 5910320,
8 "area_km2": 25632,
9 "altitude_m": 905,
10 "phone_area_codes": [
11 312
12 ],
13 "is_coastal": false,
14 "is_metropolitan": true,
15 "region_tr": "İç Anadolu",
16 "region_en": "Central Anatolia",
17 "nuts1": "TR5",
18 "nuts2": "TR51",
19 "nuts3": "TR510",
20 "lat": 39.9207759,
21 "lng": 32.8540497,
22 "neighbors": [
23 14,
24 18,
25 26,
26 40,
27 42,
28 68,
29 71
30 ],
31 "density": 230.3,
32 "district_count": 25
33 }
34 ],
35 "count": 81
36}
GET

/v1/provinces/{code}

Konsolda dene

İl detayı — Plaka / TÜİK il koduyla tek il.

Parametreler

ParametreTipYerZorunluAçıklama
codeintegeryolEvetPlaka kodu (1–81). · örn. 6
releasestringsorguHayırVeri sürümü; boşsa güncel sürüm döner. Bilinmeyen sürüm 404 verir. · örn. 2026-09

İstek

curl "https://api.apikapi.com/v1/provinces/6" \
  -H "X-API-Key: apk_…"

Örnek yanıt

/v1/provinces/6 · 200
1{
2 "data": {
3 "code": 6,
4 "name": "Ankara",
5 "slug": "ankara",
6 "population": 5910320,
7 "area_km2": 25632,
8 "altitude_m": 905,
9 "phone_area_codes": [
10 312
11 ],
12 "is_coastal": false,
13 "is_metropolitan": true,
14 "region_tr": "İç Anadolu",
15 "region_en": "Central Anatolia",
16 "nuts1": "TR5",
17 "nuts2": "TR51",
18 "nuts3": "TR510",
19 "lat": 39.9207759,
20 "lng": 32.8540497,
21 "neighbors": [
22 14,
23 18,
24 26,
25 40,
26 42,
27 68,
28 71
29 ],
30 "density": 230.3,
31 "district_count": 25
32 }
33}
GET

/v1/provinces/{code}/districts

Konsolda dene

İlin ilçeleri

Parametreler

ParametreTipYerZorunluAçıklama
codeintegeryolEvetPlaka kodu. · örn. 6
releasestringsorguHayırVeri sürümü; boşsa güncel sürüm döner. Bilinmeyen sürüm 404 verir. · örn. 2026-09

İstek

curl "https://api.apikapi.com/v1/provinces/6/districts" \
  -H "X-API-Key: apk_…"

Örnek yanıt

/v1/provinces/6/districts · 200
1{
2 "data": [
3 {
4 "code": 1872,
5 "province_code": 6,
6 "name": "Akyurt",
7 "slug": "akyurt",
8 "population": 46956,
9 "area_km2": 369,
10 "lat": 40.11074,
11 "lng": 33.14798,
12 "is_central": false,
13 "neighbors": [
14 1130,
15 1260
16 ],
17 "density": 127.9
18 },
19 {
20 "code": 1231,
21 "province_code": 6,
22 "name": "Çankaya",
23 "slug": "cankaya",
24 "population": 952198,
25 "area_km2": 483,
26 "lat": 39.81167,
27 "lng": 32.89236,
28 "is_central": false,
29 "neighbors": [
30 1130,
31 1167
32 ],
33 "density": 1965.7
34 }
35 ],
36 "count": 25
37}
GET

/v1/districts/{code}

Konsolda dene

İlçe detayı

Parametreler

ParametreTipYerZorunluAçıklama
codeintegeryolEvetTÜİK ilçe kodu. · örn. 1231
releasestringsorguHayırVeri sürümü; boşsa güncel sürüm döner. Bilinmeyen sürüm 404 verir. · örn. 2026-09

İstek

curl "https://api.apikapi.com/v1/districts/1231" \
  -H "X-API-Key: apk_…"

Örnek yanıt

/v1/districts/1231 · 200
1{
2 "data": {
3 "code": 1231,
4 "province_code": 6,
5 "name": "Çankaya",
6 "slug": "cankaya",
7 "population": 952198,
8 "area_km2": 483,
9 "lat": 39.81167,
10 "lng": 32.89236,
11 "is_central": false,
12 "neighbors": [
13 1130,
14 1167,
15 1302
16 ],
17 "density": 1965.7
18 }
19}
GET

/v1/provinces/nearest

Konsolda dene

Koordinata en yakın il

Parametreler

ParametreTipYerZorunluAçıklama
latnumbersorguEvetEnlem (-90…90). · örn. 39.92
lngnumbersorguEvetBoylam (-180…180). · örn. 32.85
releasestringsorguHayırVeri sürümü; boşsa güncel sürüm döner. Bilinmeyen sürüm 404 verir. · örn. 2026-09

İstek

curl "https://api.apikapi.com/v1/provinces/nearest?lat=39.92&lng=32.85" \
  -H "X-API-Key: apk_…"

Örnek yanıt

/v1/provinces/nearest · 200
1{
2 "data": {
3 "distance_km": 0.356,
4 "province": {
5 "code": 6,
6 "name": "Ankara",
7 "slug": "ankara",
8 "population": 5910320,
9 "region_tr": "İç Anadolu",
10 "nuts2": "TR51",
11 "lat": 39.9207759,
12 "lng": 32.8540497,
13 "district_count": 25
14 }
15 }
16}
GET

/v1/regions

Konsolda dene

İBBS bölgeleri — Düzey-1 (12) ve düzey-2 (26) İBBS/NUTS bölgeleri; koordinat, yüzölçümü ve nüfusla.

Parametreler

ParametreTipYerZorunluAçıklama
levelintegersorguHayırYalnızca bir düzey: 1 ya da 2; boşsa 38 bölgenin tümü. · örn. 1
releasestringsorguHayırVeri sürümü; boşsa güncel sürüm döner. Bilinmeyen sürüm 404 verir. · örn. 2026-09

İstek

curl "https://api.apikapi.com/v1/regions" \
  -H "X-API-Key: apk_…"

Örnek yanıt

/v1/regions · 200
1{
2 "data": [
3 {
4 "code": "TR1",
5 "name": "İstanbul",
6 "level": 1,
7 "parent_code": null,
8 "lat": 41.15052,
9 "lng": 28.81037,
10 "area_km2": 5454.8,
11 "population": 15754053
12 },
13 {
14 "code": "TR51",
15 "name": "Ankara",
16 "level": 2,
17 "parent_code": "TR5",
18 "lat": 39.6,
19 "lng": 32.7,
20 "area_km2": 25632,
21 "population": 5910320
22 }
23 ],
24 "count": 38
25}
GET

/v1/regions/{code}

Konsolda dene

Bölge detayı

Parametreler

ParametreTipYerZorunluAçıklama
codestringyolEvetİBBS kodu (TR1…TR9, TRA…TRC; düzey-2 için TR10, TR51…). · örn. TR5
releasestringsorguHayırVeri sürümü; boşsa güncel sürüm döner. Bilinmeyen sürüm 404 verir. · örn. 2026-09

İstek

curl "https://api.apikapi.com/v1/regions/TR5" \
  -H "X-API-Key: apk_…"

Örnek yanıt

/v1/regions/TR5 · 200
1{
2 "data": {
3 "code": "TR5",
4 "name": "Batı Anadolu",
5 "level": 1,
6 "parent_code": null,
7 "lat": 38.52131,
8 "lng": 32.66896,
9 "area_km2": 75157.6,
10 "population": 8516084
11 }
12}
GET

/v1/regions/{code}/provinces

Konsolda dene

Bölgenin illeri

Parametreler

ParametreTipYerZorunluAçıklama
codestringyolEvetİBBS kodu. · örn. TR5
releasestringsorguHayırVeri sürümü; boşsa güncel sürüm döner. Bilinmeyen sürüm 404 verir. · örn. 2026-09

İstek

curl "https://api.apikapi.com/v1/regions/TR5/provinces" \
  -H "X-API-Key: apk_…"

Örnek yanıt

/v1/regions/TR5/provinces · 200
1{
2 "data": [
3 {
4 "code": 6,
5 "name": "Ankara",
6 "slug": "ankara",
7 "population": 5910320,
8 "nuts1": "TR5",
9 "nuts2": "TR51",
10 "district_count": 25
11 },
12 {
13 "code": 42,
14 "name": "Konya",
15 "slug": "konya",
16 "population": 2343409,
17 "nuts1": "TR5",
18 "nuts2": "TR52",
19 "district_count": 31
20 }
21 ],
22 "count": 3
23}
GET

/v1/provinces/{code}/neighbors

Konsolda dene

Komşu iller

Parametreler

ParametreTipYerZorunluAçıklama
codeintegeryolEvetPlaka kodu. · örn. 6
releasestringsorguHayırVeri sürümü; boşsa güncel sürüm döner. Bilinmeyen sürüm 404 verir. · örn. 2026-09

İstek

curl "https://api.apikapi.com/v1/provinces/6/neighbors" \
  -H "X-API-Key: apk_…"

Örnek yanıt

/v1/provinces/6/neighbors · 200
1{
2 "data": [
3 {
4 "code": 14,
5 "name": "Bolu",
6 "slug": "bolu",
7 "population": 327173,
8 "region_tr": "Karadeniz",
9 "neighbors": [
10 6,
11 11,
12 67,
13 81
14 ],
15 "density": 39.4,
16 "district_count": 9
17 },
18 {
19 "code": 18,
20 "name": "Çankırı",
21 "slug": "cankiri",
22 "population": 200549
23 }
24 ],
25 "count": 7
26}
GET

/v1/districts/{code}/neighbors

Konsolda dene

Komşu ilçeler

Parametreler

ParametreTipYerZorunluAçıklama
codeintegeryolEvetTÜİK ilçe kodu. · örn. 1231
releasestringsorguHayırVeri sürümü; boşsa güncel sürüm döner. Bilinmeyen sürüm 404 verir. · örn. 2026-09

İstek

curl "https://api.apikapi.com/v1/districts/1231/neighbors" \
  -H "X-API-Key: apk_…"

Örnek yanıt

/v1/districts/1231/neighbors · 200
1{
2 "data": [
3 {
4 "code": 1130,
5 "province_code": 6,
6 "name": "Altındağ",
7 "slug": "altindag",
8 "population": 418072,
9 "area_km2": 123,
10 "lat": 39.99704,
11 "lng": 32.9853,
12 "is_central": false,
13 "density": 3399
14 },
15 {
16 "code": 1302,
17 "province_code": 6,
18 "name": "Elmadağ",
19 "slug": "elmadag",
20 "population": 45644
21 }
22 ],
23 "count": 7
24}