APIKAPI
GirişÜcretsiz anahtar al

Posta Kodları & Mahalleler API

freeYayında4 endpoint · ubeydeozdmr/turkiye-api veri seti · Statik veri; ETag ile 1 saat önbellek

İlçe bazında mahalle, köy ve belediye listeleri; posta kodundan yerleşim çözümleme. Sayfalı ve aramalı.

Ücretsiz anahtar alKonsolda deneDokümantasyon
curl "https://api.apikapi.com/v1/districts/1231/neighborhoods?per_page=20" \
  -H "X-API-Key: apk_…"
örnek yanıt · /v1/districts/{code}/neighborhoods
{
  "data": [
    {
      "id": 1614,
      "name": "100.Yıl",
      "slug": "100yil",
      "province_code": 6,
      "district_code": 1231,
      "municipality_id": 1155,
      "population": 5273,
      "postal_code": "06680",
      "postal_code_status": "official"
    }
  ],
  "count": 20,
  "total": 124
}
Endpoint
4yayında
Katman
Freeücretsiz
Tazelik
Statik veri
Free aylık limit
1.000istek / ay
Neler var

Bir uygulamanın posta kodları & mahalleler için ihtiyacı olanlar

  • 32.279 mahalle ve 18.183 köy, posta kodlarıyla
  • 1.377 belediye
  • 5 haneli posta kodundan mahalle/köy
  • q, page ve per_page ile sayfalı arama
GET/v1/districts/{code}/neighborhoodsİlçenin mahalleleriGET/v1/districts/{code}/villagesİlçenin köyleriGET/v1/districts/{code}/municipalitiesİlçenin belediyeleriGET/v1/postal-codes/{code}Posta kodundan yerleşim

Veri

Güncellendi 3 Eyl 2026
Kaynak
turkiye-api (mahalle/köy/belediye, posta kodları)
Veri dönemi
bilgi alınamadı
Son güncelleme
3 Eyl 2026
Güncelleme sıklığı
yılda bir
Beklenen sonraki güncelleme
bilgi alınamadı
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.

Posta kodları PTT servisinden derlenip mahalle/köy düzeyine indirgenmiştir; veri seti güncellendikçe (upstream commit) yenilenir.

Kaynakubeydeozdmr/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 postal kapsamına yetkilendir; kapsam dışı çağrılar 403 döner.

Referans

Endpoint referansı

GET

/v1/districts/{code}/neighborhoods

Konsolda dene

İlçenin mahalleleri

Parametreler

ParametreTipYerZorunluAçıklama
codeintegeryolEvetTÜİK ilçe kodu. · örn. 1231
qstringsorguHayırİsimde ara.
pageintegersorguHayırSayfa (varsayılan 1).
per_pageintegersorguHayırSayfa boyu (1–200, varsayılan 50).
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/neighborhoods?per_page=20" \
  -H "X-API-Key: apk_…"

Örnek yanıt

/v1/districts/1231/neighborhoods · 200
1{
2  "data": [
3    {
4      "id": 1614,
5      "name": "100.Yıl",
6      "slug": "100yil",
7      "province_code": 6,
8      "district_code": 1231,
9      "municipality_id": 1155,
10      "population": 5273,
11      "postal_code": "06680",
12      "postal_code_status": "official"
13    }
14  ],
15  "count": 20,
16  "total": 124
17}
GET

/v1/districts/{code}/villages

Konsolda dene

İlçenin köyleri

Parametreler

ParametreTipYerZorunluAçıklama
codeintegeryolEvetTÜİK ilçe kodu.
qstringsorguHayırİsimde ara.
pageintegersorguHayırSayfa.
per_pageintegersorguHayırSayfa boyu.
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/1872/villages" \
  -H "X-API-Key: apk_…"

Örnek yanıt

/v1/districts/1872/villages · 200
1{
2  "data": [
3    {
4      "id": 9876,
5      "name": "Çardakbağı",
6      "slug": "cardakbagi",
7      "province_code": 6,
8      "district_code": 1872,
9      "population": 312,
10      "postal_code": "06750",
11      "postal_code_status": "official"
12    }
13  ],
14  "count": 1,
15  "total": 1
16}
GET

/v1/districts/{code}/municipalities

Konsolda dene

İlçenin belediyeleri

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/municipalities" \
  -H "X-API-Key: apk_…"

Örnek yanıt

/v1/districts/1231/municipalities · 200
1{
2  "data": [
3    {
4      "id": 1155,
5      "name": "Çankaya",
6      "slug": "cankaya",
7      "province_code": 6,
8      "district_code": 1231,
9      "type": "district_center",
10      "population": 952198
11    }
12  ],
13  "count": 1
14}
GET

/v1/postal-codes/{code}

Konsolda dene

Posta kodundan yerleşim

Parametreler

ParametreTipYerZorunluAçıklama
codestringyolEvet5 haneli posta kodu. · örn. 06420
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/postal-codes/06420" \
  -H "X-API-Key: apk_…"

Örnek yanıt

/v1/postal-codes/06420 · 200
1{
2  "data": {
3    "postal_code": "06420",
4    "neighborhoods": [
5      {
6        "id": 1534,
7        "name": "Cumhuriyet",
8        "slug": "cumhuriyet",
9        "province_code": 6,
10        "district_code": 1231,
11        "municipality_id": 1155,
12        "population": 295,
13        "postal_code": "06420",
14        "postal_code_status": "official"
15      }
16    ],
17    "villages": []
18  }
19}