KURUMSAL APIREST + WebSocket·
VERİ480M+ VERİ NOKTASI·
ENDEKSİL · İLÇE · MAHALLE·
DNA38 BOYUT·
OLAY ETKİSİ KAYDI7M+ KAYIT·
KİMLİKX-TENANT-KEY·
SLA%99.99 UPTIME·
P95 GECİKME · İÇ ÖLÇÜM~84ms·
RATE LIMITTIER BAZLI·
STREAMCANLI ENDEKS · WS·
SÜRÜMv1 · v2·
KVKKTÜRKİYE'DE BARINMA·
KURUMSAL APIREST + WebSocket·
VERİ480M+ VERİ NOKTASI·
ENDEKSİL · İLÇE · MAHALLE·
DNA38 BOYUT·
OLAY ETKİSİ KAYDI7M+ KAYIT·
KİMLİKX-TENANT-KEY·
SLA%99.99 UPTIME·
P95 GECİKME · İÇ ÖLÇÜM~84ms·
RATE LIMITTIER BAZLI·
STREAMCANLI ENDEKS · WS·
SÜRÜMv1 · v2·
KVKKTÜRKİYE'DE BARINMA·
NADAS · KURUMSAL API· 2005'TEN BU YANA EMLAK ENDEKSİ · 2005
CANLI13:50:04TRT
NNADASANA SAYFA
◆ İSTEK → GEÇİT → ProX → YANIT
CANLI
▸ GET /endeks · 200 OK · 84ms
8 İSTEK · 200 OK ◆
KURUMSAL · VERİ ERİŞİMİ · REST + WEBSOCKET

Gayrimenkul verisi,
doğrudan kaynağından.

Banka, sigorta, fon, belediye ve proptech için NADAS veritabanına doğrudan API erişimi. Mahalle endeksi, 38 boyutlu DNA vektörü, olay etkisi kaydı, güven skoru ve determinist ProX karar analizi — hepsi REST + WebSocket üzerinden. Tenant anahtarıyla kimlik, tier bazlı rate limit, SLA %99.99. Veri kopyalanmaz; kaynağa bağlanılır ve lisanslanır.

480M+
KAYIT ERİŞİMİ
257 AY
TARİHSEL SERİ
38 BOYUT
MAHALLE DNA
99.99%
SLA UPTIME
84ms
P95 GECİKME · İÇ ÖLÇÜM
REST + WebSocketX-Tenant-KeySLA %99.99~84ms P95TLS 1.3KVKK · TÜRKİYE'DEv1 · v2 SÜRÜMTIER RATE LIMIT
AEndpoint Kataloğu· NE ERİŞİLİR · REST + WS
A.1

Endpoint kataloğu

REST + WEBSOCKET · JSON · TLS 1.3

Tüm uçlar HTTPS/TLS 1.3 üzerinden, JSON döner. Taban: https://www.emlakekspertizi.com. Sürümleme yol üzerinde (/api/v1, /api/v2).

METOTUÇ (ENDPOINT)GRUPAÇIKLAMA
GET/api/v1/tenant/endeksEndeks · Zaman Serisiİl/ilçe/mahalle · ₺/m² · skor · delta · trend
GET/api/v2/timeseries/monthlyEndeks · Zaman SerisiAylık zaman serisi · 257 ay tarihsel zincir
GET/api/v2/timeseries/latestEndeks · Zaman SerisiSon dönem endeks değerleri
GET/api/v2/index/compositeEndeks · Zaman SerisiKompozit endeks · çok kategorili
GET/api/v2/dna/region/{id}DNA · Bölge38 boyutlu mahalle DNA vektörü
GET/api/v2/dna/similar/{id}DNA · BölgeBenzer mahalleler · DNA yakınlığı
GET/api/v2/regions/searchDNA · BölgeBölge arama · il/ilçe/mahalle
GET/api/v2/regions/{id}DNA · BölgeBölge detay · koordinat · demografi
GET/api/v2/events/markersOlay · Isı HaritasıOlay markırları · 7M+ kayıt
GET/api/v2/events/by-region/{id}Olay · Isı HaritasıBölgeye göre olay markırları
GET/api/v2/heatmap/{level}/{cat}Olay · Isı HaritasıIsı haritası verisi · seviye/kategori
POST/api/v1/tenant/prox/analyzeProX · RaporProX karar analizi · determinist
POST/api/v2/reports/generateProX · RaporMarkalı PDF rapor üretimi (async)
GET/api/v2/categoriesReferans38 varlık kategorisi referansı
GET/api/v1/tenant/locations/illerReferansİl referans listesi (81)
GET/api/v1/tenant/locations/ilcelerReferansİlçe referans listesi (973)
GET/api/v1/tenant/locations/mahallelerReferansMahalle referansı · 50.000+
WS/api/v1/tenant/streamStream · YönetimCanlı endeks akışı · WebSocket
GET/admin/auditStream · YönetimKullanım denetim (audit) logları
BKimlik & Güvenlik· TENANT KEY · RATE LIMIT · TLS
B.1

Kimlik doğrulama & güvenlik

TENANT KEY · RATE LIMIT · TLS 1.3

Anahtar sunucu tarafında saklanmalıdır — tarayıcıya gömülü bir anahtar herkese görünür. Kurumsal entegrasyonda anahtarı yalnız kendi arka ucunuzdan çağırın; NADAS tarafında Origin/IP kısıtı ve rotasyon uygulanır.

KİMLİK
Tenant anahtarıyla doğrulama

Her istek X-Tenant-Id ve X-Tenant-Key başlıklarıyla imzalanır. Anahtar kuruma özeldir; sunucu tarafında Origin/Referer allowlist, IP kısıtı ve kapsam (scope) ile sınırlandırılır.

  • X-Tenant-Id · X-Tenant-Key başlıkları
  • Kapsam: salt-okunur / tam erişim
  • Origin/Referer + IP allowlist
  • Anahtar rotasyonu · anında iptal
RATE LIMIT
Tier bazlı hız sınırı

İstek hızı üyelik tier'ına göre sınırlıdır; 429 yanıtı ve X-RateLimit-* başlıklarıyla kalan kota bildirilir. Toplu (batch) ve akış (stream) uçları ayrı kotalarda yönetilir.

  • Dakika/saniye başına istek kotası
  • 429 + Retry-After · X-RateLimit-*
  • Batch ve stream ayrı kota
  • Kurumsal anlaşmada özel limit
§TAŞIMA
Şifreli taşıma & CORS

Tüm trafik TLS 1.3 ile şifrelenir; düz-metin uç yoktur. CORS Origin allowlist ile yönetilir. Yanıtlar imzalı; hata gövdeleri iç ayrıntı sızdırmaz.

  • TLS 1.3 · yalnız HTTPS
  • CORS · Origin allowlist
  • Standart hata kodları · sızıntı yok
  • İstek/yanıt denetim izi (audit)
bash · curl
# Endeks sorgusu — il/ilçe/kategori
curl https://www.emlakekspertizi.com/api/v1/tenant/endeks?il=İstanbul&ilce=Kadıköy \\
-H "X-Tenant-Id: kurumunuz" \\
-H "X-Tenant-Key: ••••••••••••"
# → 200 OK
{ "success": true, "data": { "m2": 101048, "score": 78,
"delta": 2.4, "trend": "up", "veri_adedi": 12840 } }
CSLA · Performans · Yönetişim· %99.99 · LİSANS · KVKK
C.1

SLA & performans

%99.99 · ~84ms · STREAM · SÜRÜMLÜ
UPTIME
SLA %99.99

Kurumsal anlaşmada aylık %99.99 erişilebilirlik taahhüdü (iç sistem ölçümü, belirtilen dönem) ve 1 saat yanıt hedefi. Durum sayfası ve olay bildirimi kurumsal hesaba açıktır.

GECİKME
P95 ~84ms

Endeks ve referans uçlarında tipik p95 gecikme ~84ms. Ağır analiz (ProX/rapor) uçları asenkron çalışır; iş kimliğiyle sonuç çekilir.

STREAM
Canlı akış · WebSocket

Endeks güncellemeleri /stream WebSocket ucundan anlık iletilir; polling yerine push. Yeniden bağlanma ve son-durum senkronizasyonu desteklenir.

SÜRÜM
Sürümlü & geriye uyumlu

Uçlar /api/v1 ve /api/v2 altında sürümlenir; kırıcı değişiklik yeni sürümle gelir, eski sürüm duyurulu geçiş süresince yaşar.

⌬ SLA, rate limit ve gecikme hedefleri kurumsal sözleşmeyle sabitlenir; tier'a göre değişir. Sayısal değerler tipik işletim aralığıdır, garanti kapsamı sözleşmede tanımlanır.
C.2

Veri yönetişimi & lisans

LİSANSLANIR · KVKK · TAZELİK · DENETİM
LİSANS
Veri lisanslanır, devredilmez

API erişimi veri mülkiyetini devretmez. Kapsam (il/ilçe/kategori), kullanım hakları ve yeniden dağıtım koşulları sözleşmeyle tanımlanır.

§KVKK
KVKK & Türkiye'de barınma

Veri Türkiye'de barınır; kişisel veri içermeyen toplu/anonim endeks verisi sunulur. İşleme ve saklama koşulları sözleşmede net.

TAZELİK
Güncellik & köken

Endeks aylık, akış anlık günceldir; her yanıt köken ve tazelik meta verisi taşır. Determinist ProX — aynı girdi, aynı çıktı, halüsinasyon yok.

KULLANIM
Adil kullanım & denetim

Kota aşımı, olağan dışı desen ve kötüye kullanım denetlenir. Tüm çağrılar audit loglanır; kurumsal hesap kendi kullanımını görebilir.

DHızlı Başlangıç· KOD ÖRNEKLERİ
D.1

Hızlı başlangıç

ANAHTAR · BAŞLIK · ÇAĞRI · SDK YOK

Anahtarınızı alın, başlıkları ekleyin, çağırın. REST için standart HTTP istemcisi; canlı akış için WebSocket yeterlidir. SDK gerekmez.

javascript · fetch
// 38 boyutlu mahalle DNA'sı
const r = await fetch(
"https://www.emlakekspertizi.com/api/v2/dna/region/34_kadikoy_caferaga", {
headers: {
"X-Tenant-Id": "kurumunuz",
"X-Tenant-Key": process.env.NADAS_KEY
}
});
const dna = await r.json(); // { vector: [...38], ... }
javascript · WebSocket (canlı endeks)
const ws = new WebSocket(
"wss://www.emlakekspertizi.com/api/v1/tenant/stream?token=•••");
ws.onmessage = (e) => {
const upd = JSON.parse(e.data);
// { il, ilce, mahalle, m2, delta, ts }
render(upd);
};
⌬ Kurumsal API erişimi ProX Corporate üyeliğinde ve kurumsal anlaşmada açılır. Anahtar talebi ve tier seçimi için [email protected].
◆ VERİ KAYNAĞI · NADAS ALTYAPISIAPI · v1 · v2
emlakekspertizi.com

emlakekspertizi.com

API'nin arkasındaki motor, emlakekspertizi.com'u besleyen aynı ProX karar motorudır — 480M+ veri noktası, 257 aylık zincir, 38 boyutlu DNA. Kurumsal API erişimi ve veri lisansı için:

API ANAHTARI TALEP ET →KURUMSAL GÖRÜŞME →
SECTION · SSS

Sıkça Sorulan Sorular

28 SORU · AI ARAMA & GOOGLE İÇİN YAPILANDIRILMIŞ

Her cevap kendi başına okunacak şekilde yazıldı; bir yapay zekâ asistanı yalnız o paragrafı alıntıladığında da anlam kaybı olmaz. Aramak için yazın veya kategori seçin.

28 soru
API KAPSAMI

Kurumsal API, 480 milyondan fazla veri noktalık gayrimenkul verisine REST + WebSocket erişim sunar. Endeks, 38 boyutlu mahalle DNA'sı, olay etkisi kaydı, güven skoru ve ProX karar analizi uçlarını kapsar; tenant anahtarı ile kimlik doğrulaması ve %99.99 SLA ile çalışır.

Endpoint kataloğu; il/ilçe/mahalle bazında ₺/m², skor, delta ve trend endeksi (257 aylık zaman serisi), 38 boyutlu mahalle DNA'sı, 7M+ olay etkisi kaydı, güven skoru sorgusu ve ProX karar analizi/PDF üretimini içerir. Yanıtlar JSON, taşıma TLS 1.3'tür.

Banka, sigorta, fon, belediye ve proptech firmaları kurumsal API kullanır. Teminat değerleme, risk skorlaması, portföy izleme, imar/rayiç takibi ve scoring motoru gibi senaryolarda NADAS veritabanına doğrudan bağlanırlar.

REST uçları tekil sorgu ve toplu erişim içindir. Endeks güncellemeleri ise /stream WebSocket ucundan anlık iletilir; polling yerine push kullanılır, yeniden bağlanma ve son-durum senkronizasyonu desteklenir.

KİMLİK, GÜVENLİK, SLA

Her istek X-Tenant-Id ve X-Tenant-Key başlıklarıyla imzalanır. Anahtar kuruma özeldir ve sunucu tarafında Origin/Referer allowlist, IP kısıtı ve kapsam (scope) ile sınırlandırılır; böylece anahtar sızsa bile yetkisiz kullanım engellenir.

İstek hızı üyelik tier'ına göre sınırlıdır. Sınır aşıldığında 429 yanıtı ve X-RateLimit-* başlıklarıyla kalan kota bildirilir. Toplu (batch) ve akış (stream) uçları ayrı kotalarda yönetilir.

Tüm trafik TLS 1.3 ile şifrelenir; düz-metin uç yoktur. CORS Origin allowlist ile yönetilir, yanıtlar imzalıdır ve hata gövdeleri iç ayrıntı sızdırmaz. Tüm çağrılar audit loglanır.

Kurumsal anlaşmada aylık %99.99 erişilebilirlik taahhüdü (iç sistem ölçümü, belirtilen dönem) ve 1 saat yanıt hedefi vardır; durum sayfası ve olay bildirimi kurumsal hesaba açıktır. Endeks ve referans uçlarında tipik p95 gecikme ~84ms'tir; ağır analiz (ProX/rapor) uçları asenkron çalışır ve iş kimliğiyle sonuç çekilir.

SÜRÜM, LİSANS, BAŞLANGIÇ

Evet. Uçlar /api/v1 ve /api/v2 altında sürümlenir. Kırıcı değişiklik yeni sürümle gelir; eski sürüm, duyurulu bir geçiş süresince yaşamaya devam eder, böylece entegrasyonunuz aniden bozulmaz.

Hayır. API erişimi veri mülkiyetini devretmez. Kapsam (il/ilçe/kategori), kullanım hakları ve yeniden dağıtım koşulları sözleşmeyle tanımlanır; veri kopyalanmaz, sorguyla erişilir.

Evet. Veri Türkiye'de barınır ve kişisel veri içermeyen toplu/anonim endeks verisi sunulur. Endeks aylık, akış anlık günceldir; her yanıt köken ve tazelik meta verisi taşır ve çıktılar deterministik ProX motorundan gelir (aynı girdi, aynı çıktı, halüsinasyon yok).

Kurumsal API erişimi ProX Corporate üyeliğinde ve kurumsal anlaşmada açılır. Ayrı bir SDK gerekmez; standart HTTP çağrılarıyla (curl dâhil) kullanılır. Anahtar talebi ve tier seçimi için [email protected] adresinden başvurabilirsiniz.

EK SORULAR

Hayır. Ayrı bir SDK gerekmez; API standart HTTP çağrılarıyla, curl dâhil herhangi bir istemciyle kullanılır. Dokümantasyonda hazır kod örnekleri sunulur.

Evet. Toplu ve akış uçları ayrı kotalarda yönetilir. Akış (WebSocket /stream) anlık push sağlar; toplu uçlar ise büyük hacimli sorgular için tasarlanmıştır.

Anahtar tek başına yetmez: sunucu tarafında Origin/Referer allowlist, IP kısıtı ve kapsam (scope) uygulanır. İzin verilmeyen bir origin veya IP'den gelen istek reddedilir; tüm çağrılar audit loglanır.

Endeks aylık, akış ise anlık günceldir. /stream ucundan güncellemeler push ile iletilir ve her yanıt köken ile tazelik meta verisi taşır.

Evet. ProX karar analizi ve PDF üretimi API uçları arasındadır. Bu ağır analiz uçları asenkron çalışır; isteği gönderir, dönen iş kimliğiyle sonucu çekersiniz.

Kota aşımında 429 yanıtı ve kalan kotayı bildiren X-RateLimit-* başlıkları döner. Hata gövdeleri iç ayrıntı sızdırmaz; yanıtlar imzalıdır ve tüm trafik TLS 1.3 ile şifrelidir.

Sayısal SLA ve kota değerleri tier'a göre değişir ve kurumsal sözleşmeyle sabitlenir. Sayfadaki değerler tipik işletim aralığıdır; garanti kapsamı ve fiyat sözleşmede tanımlanır.

Bankalar teminat değerleme ve mahalle bazlı risk skorlaması, sigortacılar bölgesel risk profili, fonlar portföy izleme, belediyeler imar/rayiç takibi ve proptech firmaları scoring motoru için NADAS API'sine bağlanır.

EK SORULAR III

Herhangi bir dille. API standart REST/JSON ve WebSocket olduğundan Python, Node.js, Java, C#, PHP veya curl gibi her HTTP istemcisiyle çalışır; ayrı bir SDK gerekmez ve dokümantasyonda hazır örnekler bulunur.

Evet. Endeks güncellemeleri /stream WebSocket ucundan anlık push edilir; polling'e gerek kalmaz, yeniden bağlanma ve son-durum senkronizasyonu desteklenir.

API, 81 il, 973 ilçe ve 50.000'den fazla mahalleyi kapsar; sorgular il, ilçe, mahalle ve gerektiğinde cadde/sokak düzeyine iner.

Kurumsal API erişimi ProX Corporate üyeliğinde ve kurumsal anlaşmayla açılır. Anahtar talebi, tier seçimi ve Origin/IP allowlist tanımı için [email protected] üzerinden başvurulur.

Kota aşımında 429 döner ve X-RateLimit-* başlıklarıyla kalan kota bildirilir; istemci, belirtilen süre sonra üstel geri çekilme (exponential backoff) ile yeniden denemelidir. 5xx durumlarında da backoff önerilir.

Hayır. Endeks ve referans uçları düşük gecikmelidir (tipik p95 ~84 ms). ProX karar analizi ve PDF gibi ağır işler asenkron çalışır: isteği gönderir, iş kimliğiyle sonucu ayrıca çekersiniz; bu, hızlı uçları yavaşlatmaz.

Her yanıt köken ve tazelik meta verisi taşır. Endeks aylık, olay/akış anlık günceldir; böylece kullandığınız verinin hangi tarihe ait olduğunu programatik olarak doğrulayabilirsiniz.

Çünkü NADAS API'si 480M+ veri noktası, 257 aylık kesintisiz zincir ve %96 medyan güven skoruna dayanan gerçek bir veritabanını; TLS 1.3, tenant + Origin/IP güvenliği, %99.99 SLA ve deterministik (halüsinasyonsuz) çıktı ile birleştirir. Sonuçlar tekrar edilebilir ve denetlenebilir olduğu için banka ve kamu süreçlerine uygundur.