Canlı katalog Veri sürümü 24 Ağustos 2026

apiturkiye.com

Türkiye adres verisi.
Tek, sade API.

İl, ilçe, mahalle, cadde/sokak ve dış kapı verisini arayın, doğrulayın ve tek biçime getirin. Standart HTTP, temiz JSON, tahmin edilebilir hatalar.

Ücretsiz başlayın Dokümantasyon

Core paket ücretsiz: günde 1.000, dakikada 60 istek.

İl · 34İstanbul

İlçe · 1421Kadıköy

MahalleCaferağa

Cadde / sokakModa Caddesi

Dış kapıNo: 12

81 il · 973 ilçe · 73.497 mahalle · 1,28 Mn cadde/sokak · 39,6 Mn dış kapı

01Adana02Adıyaman03Afyonkarahisar04Ağrı05Amasya06Ankara07Antalya08Artvin09Aydın10Balıkesir11Bilecik12Bingöl13Bitlis14Bolu15Burdur16Bursa17Çanakkale18Çankırı19Çorum20Denizli21Diyarbakır22Edirne23Elazığ24Erzincan25Erzurum26Eskişehir27Gaziantep28Giresun29Gümüşhane30Hakkari31Hatay32Isparta33Mersin34İstanbul35İzmir36Kars37Kastamonu38Kayseri39Kırklareli40Kırşehir41Kocaeli42Konya43Kütahya44Malatya45Manisa46Kahramanmaraş47Mardin48Muğla49Muş50Nevşehir51Niğde52Ordu53Rize54Sakarya55Samsun56Siirt57Sinop58Sivas59Tekirdağ60Tokat61Trabzon62Tunceli63Şanlıurfa64Uşak65Van66Yozgat67Zonguldak68Aksaray69Bayburt70Karaman71Kırıkkale72Batman73Şırnak74Bartın75Ardahan76Iğdır77Yalova78Karabük79Kilis80Osmaniye81Düzce

Adres akışı

Formdan veritabanına, dört adımda doğru adres

Kademeli il → ilçe → mahalle → sokak → kapı listeleriyle formlarınızı doldurun; her kayıt kod ve sabit kimlikle gelir.
GET /v1/provinces/{code}/districts
Kullanıcı yazarken Türkçe karakter farklarına ve küçük yazım hatalarına toleranslı öneriler gösterin.
GET /v1/autocomplete
Adres parçalarının aynı hiyerarşide gerçekten bağlı olduğunu tek istekte denetleyin; hatalı seviye ve öneriler dönsün.
POST /v1/addresses/validate
Aktif veri sürümünü, checksum'ı ve kayıt sayılarını izleyin; kayıtlarınızı sabit kimliklerle eşleştirin.
GET /v1/datasets/current

İl34 · İstanbul

İlçeKadıköy

MahalleCaferağa

SokakModa Caddesi

Dış kapı12

POST /v1/addresses/validatevalid: true

CAFERAĞA MAHALLESİ, MODA CADDESİ No:12, KADIKÖY/İSTANBUL

İSTANBULKADIKÖYCAFERAĞAMODA CADDESİNo: 12

ilçe: "Kadıkoy Merkez"failedAt: district

Öneri: KADIKÖY — aynı il içindeki en yakın adaylar döner.

apiturkiye-addresses-2026-08-24active

yayın: 24 Ağustos 2026
sha256: bbc07512…ca22c3

81il

973ilçe

73.497mahalle

19.621yerleşim

1,28 Mncadde/sokak

39,6 Mndış kapı

Adres altyapısı

İlden dış kapıya Türkiye adres verisi, tek kaynaktan

Dağınık kaynakları ve elle güncellenen listeleri geride bırakın.

Tam adres hiyerarşisi

İl, ilçe, mahalle, cadde/sokak ve dış kapı verisini birbirine bağlı sorgulayın.

01İl81
02İlçe973
03Mahalle73.497
04Cadde / sokak1,28 Mn
05Dış kapı39,6 Mn

Akıllı adres arama

İ/ı, Ş/ş gibi karakter farklarını, Cd. ve Mh. gibi kısaltmaları ve küçük yazım hatalarını anlayan öneriler.

uskdarÜSKÜDAR, İstanbul

bağdat cadessibagdat caddesi

Bağdat Cd.bagdat caddesi

Sabit adres kimlikleri

Aynı kaynak kaydı yeni sürümde de aynı stableId ile gelir.

stableId
apt_v1_str_AYZOKpsoJMmzH_tqpFZhQg

Kontrollü veri yayını

Her sürüm kapsam ve ilişki kontrollerinden geçmeden devreye girmez.

sha256
bbc07512…ca22c3

Öngörülebilir limitler, açıklayıcı hatalar

Her anahtarın dakika limiti ve paket kotası vardır; aşımda ne olduğunu ve ne zaman yeniden deneyeceğinizi söyleyen yanıt döner. Reddedilen istekler kotadan düşmez.

429 rate_limit_exceeded429 quota_exceededX-Request-Id

Görünür kullanım

İstek geçmişi, anahtar kullanımı ve servis durumu panelinizde.

API yetenekleri

Adres arama ve adres doğrulama API yetenekleri

Yalnızca veri sunmuyoruz. Arama, doğrulama ve entegrasyon sırasında ihtiyaç duyacağınız yetenekler doğrudan API'de; hepsi canlı katalog ve gerçek Türkiye adres verisi üzerinde çalışır.

Arama

Fuzzy search

Eksik veya yaklaşık yazılmış adresleri benzerlik skorlarıyla doğru katalog kayıtlarına eşleştirir.

beylikdzu → BEYLİKDÜZÜ

Tolerans

Typo toleransı

Harf atlama, yanlış harf ve yaygın adres yazım hatalarında öneri üretmeye devam eder.

cadessi → caddesi

Türkçe

Türkçe normalizasyon

İ/ı, Ş/ş, Ç/ç gibi karakter farklarını ve Cd., Mh., Sk. gibi kısaltmaları arama biçimine dönüştürür.

atasehir → ATAŞEHİR

Bağlam

Bağlamsal arama

Sokak, mahalle, ilçe ve il parçalarını tek sorguda değerlendirerek aynı adlı yerleri ayırır.

Bağdat Cadessi Kadıköy İstanbul

Doğrulama

Adres doğrulama

Adres bileşenlerinin aynı hiyerarşide gerçekten bağlı olduğunu denetler; hatanın hangi seviyede olduğunu bildirir.

POST /v1/addresses/validate

Kapsam

Hiyerarşik filtreleme

Aramayı il, ilçe, mahalle veya sonuç türüyle sınırlandırarak daha kesin ve hızlı öneriler alın.

provinceCode=34&types=street

Dış kapı

Dış kapı listeleri

Seçilen cadde/sokağın dış kapılarını cursor ile sayfalayarak listeleyin; kapı numarasıyla daraltın.

/v1/streets/{code}/buildings

Sürüm

Katalog meta verisi

Aktif katalog sürümünü, kayıt sayılarını ve devreye alınma zamanını tek istekle alın; verinin güncelliğini izleyin.

GET /v1/meta

Canlı demoda deneyin

Canlı deneyin

Canlı adres API demosu

Bir cadde, mahalle veya ilçe adı yazın; öneriler gerçek katalogdan gelir. Yazım hatası yapmaktan çekinmeyin.

En az 3 karakter yazın.

GET /v1/autocomplete · demo— ms

Dakikada en fazla 20 demo isteği; sonuç adedi sınırlıdır. Tam API için ücretsiz anahtar alın.

39,6 Mndış kapı kaydı

1,28 Mncadde ve sokak

73.497mahalle

81 il · 973 ilçe · 19.621 yerleşim · son yayın 24 Ağustos 2026

Geliştiriciler için

İl, ilçe, mahalle API'sine birkaç satırda entegrasyon

Standart HTTP, temiz JSON ve tahmin edilebilir hata yanıtları. Yeni bir SDK öğrenmeniz gerekmez.

Türkçe karakter ve yazım hatalarına toleranslı öneriler; il, ilçe veya mahalleyle kapsamı daraltın.

GET /v1/autocomplete

İstek

curl --get "https://api.apiturkiye.com/v1/autocomplete" \
  --data-urlencode "q=Bağdat Cadessi" \
  --data-urlencode "provinceCode=34" \
  --data-urlencode "types=street" \
  --data-urlencode "limit=5" \
  -H "X-API-Key: $APITURKIYE_KEY"

Örnek yanıt

{
  "data": [{
    "type": "street",
    "stableId": "apt_v1_str_...",
    "name": "Bağdat Caddesi",
    "label": "Bağdat Caddesi, Caddebostan, Kadıköy, İstanbul",
    "matchType": "fuzzy",
    "score": 0.913,
    "district": { "code": "1421", "name": "Kadıköy" }
  }],
  "meta": { "query": "bagdat caddesi", "limit": 5 }
}

POST /v1/addresses/validate

İstek

curl "https://api.apiturkiye.com/v1/addresses/validate" \
  -H "X-API-Key: $APITURKIYE_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "province": "İstanbul",
    "district": "Kadıköy",
    "neighborhood": "Caferağa Mahallesi",
    "street": "Moda Caddesi",
    "doorNumber": "12"
  }'

Örnek yanıt

{
  "data": {
    "valid": true,
    "failedAt": null,
    "normalizedAddress": "CAFERAĞA MAHALLESİ, MODA CADDESİ No:12, KADIKÖY/İSTANBUL",
    "components": {
      "district": { "code": "1421", "name": "KADIKÖY" },
      "door": { "stableId": "apt_v1_dor_...", "doorNumber": "12" }
    }
  },
  "meta": { "datasetVersion": "ae0a3bb4-1e32-4788-93c0-1490447bedf1" }
}

GET /v1/districts/1421/neighborhoods

İstek

curl "https://api.apiturkiye.com/v1/districts/1421/neighborhoods" \
  -H "X-API-Key: $APITURKIYE_KEY"

Örnek yanıt

{
  "data": [
    {
      "stableId": "apt_v1_ngh_...",
      "code": "40528",
      "name": "19 MAYIS"
    },
    {
      "stableId": "apt_v1_ngh_...",
      "code": "40509",
      "name": "ACIBADEM"
    }
  ]
}

GET /v1/datasets/current

İstek

curl "https://api.apiturkiye.com/v1/datasets/current" \
  -H "X-API-Key: $APITURKIYE_KEY"

Örnek yanıt

{
  "data": {
    "datasetVersion": "ae0a3bb4-1e32-4788-93c0-1490447bedf1",
    "name": "apiturkiye-addresses-2026-08-24",
    "status": "active",
    "checksum": { "algorithm": "sha256", "value": "bbc07512…ca22c3" },
    "counts": {
      "provinces": 81, "districts": 973, "neighborhoods": 73497,
      "streets": 1278089, "buildings": 39617559
    },
    "publishedAt": "2026-08-24T10:49:19.452Z"
  }
}

Sözleşme

Her uçta aynı kurallar

Her /v1 isteğinde anahtarınızı X-API-Key başlığında gönderin. Anahtarı tarayıcı koduna, Git deposuna veya loglara yazmayın.

Kimlik doğrulama

İstek başlığı

GET /v1/provinces HTTP/1.1
Host: api.apiturkiye.com
X-API-Key: apt_live_...
Accept: application/json

# Anahtar yalnız sunucuda saklanır;
# tarayıcı koduna veya Git deposuna yazılmaz.

Sayfalama

GET /v1/neighborhoods/{code}/streets?limit=50

{
  "data": [ ... 50 kayıt ... ],
  "meta": { "nextCursor": "<sonraki-sayfa>" }
}

GET /v1/neighborhoods/{code}/streets?limit=50&cursor=<sonraki-sayfa>

{ "data": [ ... ], "meta": { "nextCursor": null } }

400 Bad Request

{
  "error": {
    "code": "invalid_request",
    "message": "Geçersiz istek: `q` en az 3 karakter olmalı.",
    "details": [{
      "location": "sorgu parametresi",
      "field": "q",
      "problem": "en az 3 karakter olmalı"
    }]
  }
}

429 Too Many Requests

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Dakikalık istek sınırına ulaştınız.",
    "limit": 60,
    "retryAfterSeconds": 12
  }
}

# Reddedilen istekler kotadan düşmez.

Fiyatlar

Adres API fiyatları: ücretsiz başlayın, ihtiyaç büyüdükçe geçin

Core

Başlangıç

ÜcretsizSüresiz

1.000 istek / günDakikada 60 istek

İl, ilçe ve mahalle verilerinin tamamı
Cadde/sokak ve dış kapı verilerinin tamamı
Fuzzy search, typo toleransı ve anahtar yönetimi

Ücretsiz başlayın

Pro

En çok tercih edilen

500 TL/ ay · canlı uygulamalar

200.000 istek / ayDakikada 300 istek

Core'daki tam adres kataloğu ve akıllı arama
Adres doğrulama ve standartlaştırma
Veri seti metadata ve sürüm geçmişi

Pro'ya başlayın

Ultra

Veri operasyonları

5.000 TL/ ay

2.500.000 istek / ayDakikada 1.000 istek

Pro'daki tüm API ve veri seti yetenekleri
Toplu veri seti snapshot erişimi
Yüksek hacim için 1.000 istek/dakika

Ultra'ya başlayın

Enterprise

Size özel

Kurumsalİhtiyacınıza göre

Özel planBirlikte belirleyelim

Ultra'daki tüm platform yetenekleri
Kuruma özel kota ve hız yapılandırması
Doğrudan teknik iletişim ve planlama

Enterprise başvurusu

Kotalar ve dakika limitleri anahtar bazında uygulanır; paket kullanım limitleri belirtilen dönem sonunda yenilenir. Ayrıntılar: API kullanım koşulları

Sık sorulanlar

Adres API'si: neyi sunuyoruz, neyi sunmuyoruz

Posta kodu, koordinat veya harita verisi sunuyor musunuz?

Hayır. API Türkiye il, ilçe, mahalle, cadde/sokak ve dış kapı verisi sunar. Posta kodu, koordinat, konumdan adres bulma, iç kapı numarası ve serbest metinden adres ayrıştırma sunulmaz.

Ücretsiz Core paketiyle neler yapabilirim?

Günde 1.000, dakikada 60 istekle il, ilçe, mahalle, cadde/sokak ve dış kapı kataloğunun tamamına ve akıllı aramaya erişirsiniz. Adres doğrulama Pro ve üzeri paketlerdedir.

Kotam dolarsa ne olur?

API 429 quota_exceeded döner ve kotanın ne zaman yenileneceğini bildirir; reddedilen istekler kotanızdan düşmez. Günlük kota her gün 03:00'te (TSİ) yenilenir.

stableId resmî adres kodu mu?

Hayır. stableId, aynı kaynak kaydını yeni veri sürümlerinde de aynı kimlikle eşleştirebilmeniz için API Türkiye'nin verdiği kimliktir; resmî adres kodu veya tescil numarası değildir.

Doğrulama sonucu teslimat garantisi midir?

Hayır. Doğrulama, adres bileşenlerinin aktif katalogda birbirine bağlı olduğunu denetler; teslimat veya ikamet garantisi değildir.

Adres verisini bugün entegre edin.

Ücretsiz Core paketiyle anahtarınızı oluşturun; ihtiyacınız büyüdükçe Pro, Ultra veya Enterprise'a geçin.

01Hesabınızı oluşturun
02Paket erişiminizi talep edin
03API anahtarınızla sorgulayın

Ücretsiz başlayın Dokümantasyonu inceleyin

Türkiye adres verisi.Tek, sade API.

Formdan veritabanına, dört adımda doğru adres

İlden dış kapıya Türkiye adres verisi, tek kaynaktan

Tam adres hiyerarşisi

Akıllı adres arama

Sabit adres kimlikleri

Kontrollü veri yayını

Öngörülebilir limitler, açıklayıcı hatalar

Görünür kullanım

Adres arama ve adres doğrulama API yetenekleri

Fuzzy search

Typo toleransı

Türkçe normalizasyon

Bağlamsal arama

Adres doğrulama

Hiyerarşik filtreleme

Dış kapı listeleri

Katalog meta verisi

Canlı adres API demosu

İl, ilçe, mahalle API'sine birkaç satırda entegrasyon

Her uçta aynı kurallar

X-API-Key ile kimlik doğrulama

Cursor ile sayfalama

Açıklayıcı hata yanıtları

Hız sınırı ve kota

Adres API fiyatları: ücretsiz başlayın, ihtiyaç büyüdükçe geçin

Core

Pro

Ultra

Enterprise

Adres API'si: neyi sunuyoruz, neyi sunmuyoruz

Adres verisini bugün entegre edin.

Türkiye adres verisi.
Tek, sade API.