Türkiye'nin En Kapsamlı Adres API'si

İl, İlçe, Mahalle ve Yol verilerine anında erişin. RESTful API ile kolay entegrasyon.

Hemen Başla Demo'yu Dene

Canlı Demo

API'mizi test edin. Demo sınırsızdır ancak rate limiting uygulanır.

API Response:

Bir seçim yapın...

Fiyatlandırma

Aylık Yıllık %15 İndirim

Ücretsiz

₺0 /ay
  • ✓ 100 istek/gün
  • ✓ Tüm endpoint'lere erişim
  • ✓ Temel destek
  • ✓ API anahtarı
Popüler

Pro

₺199 /ay
  • ✓ 50.000 istek/ay
  • ✓ Tüm endpoint'lere erişim
  • ✓ Öncelikli destek
  • ✓ API anahtarı
  • ✓ Webhook desteği
  • ✓ Detaylı analitik

API Dokümantasyonu

Başlangıç

API'yi kullanmak için bir API anahtarına ihtiyacınız var. Ücretsiz veya ücretli paketi seçerek API anahtarınızı alabilirsiniz.

Base URL: https://turkiye-adres-api.vercel.app/api/proxy

Authentication

Her istekte API anahtarınızı header'da göndermeniz gerekir:

Headers:
  X-API-Key: sk_xxxxxxxxxxxxxxxx

Endpoints

GET /api/proxy?table=iller

Tüm illeri listeler

curl "https://turkiye-adres-api.vercel.app/api/proxy?table=iller" \
  -H "X-API-Key: sk_xxxxxxxxxxxxxxxx"

# Response:
{
  "success": true
  "data": [
    { "id": 1, "adi": "Adana" },
    { "id": 6, "adi": "Ankara" },
    { "id": 34, "adi": "İstanbul" }
  ],
  "plan": "free"
}

GET /api/proxy?table=ilceler&params={"il_id":34}

Belirtilen ile ait ilçeleri listeler

curl "https://turkiye-adres-api.vercel.app/api/proxy?table=ilceler&params=%7B%22il_id%22%3A34%7D" \
  -H "X-API-Key: sk_xxxxxxxxxxxxxxxx"

# Response:
{
  "success": true,
  "data": [
    { "id": 1, "adi": "Kadıköy", "il_id": 34 },
    { "id": 2, "adi": "Beşiktaş", "il_id": 34 }
  ],
  "plan": "free"
}

GET /api/proxy?table=mahalleler&params={"ilce_id":1}

Belirtilen ilçeye ait mahalleleri listeler

curl "https://turkiye-adres-api.vercel.app/api/proxy?table=mahalleler&params=%7B%22ilce_id%22%3A1%7D" \
  -H "X-API-Key: sk_xxxxxxxxxxxxxxxx"

# Response:
{
  "success": true,
  "data": [
    { "id": 1, "adi": "Caferağa", "ilce_id": 1, "il_id": 34 }
  ],
  "plan": "free"
}

GET /api/proxy?table=yollar&params={"mahalle_id":1}

Belirtilen mahalleye ait yolları listeler

curl "https://turkiye-adres-api.vercel.app/api/proxy?table=yollar&params=%7B%22mahalle_id%22%3A1%7D" \
  -H "X-API-Key: sk_xxxxxxxxxxxxxxxx"

# Response:
{
  "success": true,
  "data": [
    { "id": 1, "adi": "Moda Caddesi", "mahalle_id": 1, "ilce_id": 1, "il_id": 34 }
  ],
  "plan": "free"
}

Rate Limiting

API istekleriniz paketinize göre sınırlandırılır:

  • Ücretsiz: 100 istek/gün
  • Pro: 50.000 istek/ay

Rate limit aşıldığında HTTP 429 hatası alırsınız.

Hata Kodları

200 - Başarılı
400 - Geçersiz istek
401 - Geçersiz API anahtarı
429 - Rate limit aşıldı
500 - Sunucu hatası
WhatsApp ile iletişime geç