İçeriğe geç
emlakfiyati.com
İl, ilçe ya da sayfa ara…
Giriş yap Ücretsiz değerle

Geliştirici

Değerlemeyi kendi yazılımınıza bağlayın.

API erişimi şu anda kapalı. Aşağıda nasıl çalıştığını okuyabilirsiniz.

API erişimi şu an kapalı

  • Kapalıyken yeni anahtar oluşturulamaz ve mevcut anahtarlar istek kabul etmez.
  • Erişim açıldığında koşullar bu sayfada yayımlanır.

Uçlar

Dört uç, tek anahtar.

  • POST /api/v2/genel/acik-api/degerleme

    Değerleme

    Mahalle kimliği, ada ve parsel (konutta brüt m²) ile değerleme. 1 değerleme hakkı kullanır; sonuç üretilemezse hak iade edilir. Idempotency-Key başlığı zorunludur.

  • GET /api/v2/genel/acik-api/rapor/{rapor_id}

    Rapor özeti

    Güven sınıfı (guven_sinifi), olası aralık (deger_aralik_metni) ve tek değer (deger_tl). Düşük ya da belirlenmemiş güvende deger_tl null döner ve deger_gizli true olur. Hak kullanmaz.

  • POST /api/v2/genel/acik-api/rapor/{rapor_id}/pdf

    PDF rapor

    Tam rapor ya da sunum özeti; Türkçe (varsayılan) ya da İngilizce baskı. Aynı raporun ilk PDF'i 1 PDF hakkı kullanır, tekrarı ücretsizdir.

  • GET /api/v2/genel/acik-api/kullanim

    Kullanım

    Kalan değerleme ve PDF hakkı, anahtarın dakikalık sınırı.

Kimlik ve sınırlar

Anahtar sizde, kota paketinizde.

  • API anahtarı Business paketinde ve kurumsal hesaplarda hesap sahibi tarafından Hesap ayarları › API erişimi sayfasında oluşturulur.
  • Herkese açık deneme ya da test anahtarı yoktur; her istek hesabınızın paket havuzundan düşer.
  • Anahtar yalnız oluşturulduğu anda bir kez gösterilir. Sistemde yalnız özeti saklanır; kaybederseniz iptal edip yenisini oluşturursunuz.
  • Her anahtarın dakikalık istek sınırı vardır (varsayılan 30). Aşımda 429 yanıtı ve Retry-After başlığı döner.
  • Değerleme yanıtında her güven düzeyinde güven sınıfı, tek değer (fiyat_yayin.guven_sunumu.deger_yuvarlak_tl, deger_metni) ve olası aralık (aralik_metni) birlikte döner. Rapor özeti ucunda deger_tl düşük ya da belirlenmemiş güvende null döner (deger_gizli true); tek değeri değerleme yanıtından ya da PDF rapordan alın. Hak iade edilen yanıtta (ucretlendirilir false) tek değer yoktur. Değerler piyasada istenen fiyatlara dayanan otomatik tahmindir, ekspertiz değildir.
  • Yanıtlarda kaynak kaydı, bağlantısı ve satıcı bilgisi bulunmaz.

Örnek istek

İlk değerleme.

Aynı Idempotency-Key ile yinelenen istek ilk yanıtı döner; ikinci kez hak düşmez.

curl -X POST https://emlakfiyati.com/api/v2/genel/acik-api/degerleme \
  -H "Authorization: Bearer ek_live_…" \
  -H "Idempotency-Key: siparis-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{"mahalle_id": 12345, "ada": "101", "parsel": "7", "tip": "konut",
       "konut": {"konut_tipi": "daire", "brut_m2": 120, "oda_sayi": 4}}'

Değer kutusu

Sitenize “Evim ne eder?” kutusu.

Hesap ayarları › Değer kutusu sayfasında sitenizin alan adını ve renginizi kaydedin, tek satırlık kodu sayfanıza ekleyin. Kutu yalnız kayıtlı alan adlarında açılır ve yalnız yuvarlak aralık gösterir.

<script src="https://emlakfiyati.com/api/v2/genel/widget/<kutu-kodunuz>/yukle.js" async></script>

Sık sorulanlar

Başlamadan önce.

API kullanımı nasıl ücretlendirilir?
Ayrı bir API ücreti yoktur. Her değerleme ve bir raporun ilk PDF'i, paketinizdeki değerleme ve PDF havuzundan bir hak kullanır. Havuz dolarsa hesabınızdan ek hak alabilirsiniz.
İngilizce rapor nasıl alınır?
PDF isteğinde "dil": "en" gönderin. Başlıklar, etiketler, birimler ve yasal ibare İngilizcedir; değerler Türkçe raporla aynıdır. Resmî kaynaklardan gelen serbest notlar Türkçe kalabilir.
Değer kutusu ziyaretçiye ne gösterir?
Seçilen mahalledeki piyasa fiyatlarından hesaplanan yuvarlak değer aralığını ve tam rapor için emlakfiyati.com bağlantısını gösterir. Tek bir rakam, emsal listesi ya da ziyaretçi bilgisi göstermez; ziyaretçi bilgisi saklanmaz.
Değer kutusu hangi sitelerde çalışır?
Yalnız ayarlarınızda kaydettiğiniz alan adlarında. Başka bir site kutuyu gömmeye çalışırsa tarayıcı çerçeveyi açmaz.
Değer kutusu hakkımdan düşer mi?
Evet. Kutunun verdiği sonuçlar değerleme havuzunuzdan düşer; değer üretilemediğinde hak düşmez. Günlük en çok sonuç sayısını ayarlardan siz belirlersiniz.

Sonraki adım: Sistem durumu · Yöntem ve doğruluk · Toplu değerleme örneği · Kurumsal