Cadastrum Public API

Programmatic erişim — Kurumsal Pro tier'ı için. Token oluştur →

Kimlik doğrulama

GET /v1/api/health HTTP/1.1
Host: api.cadastrum.com.tr
X-API-Key: cdrm_a1b2c3d4e5f6...

Token formatı: cdrm_ prefix + 32 hex karakter. Token sadece oluşturulurken bir kez gösterilir; tekrar görmek mümkün değil — kaybedersen yeni token üret. Rate limit: 60 req/dakika (varsayılan).

Endpoint'ler

GET /v1/api/health

Sağlık kontrolü.

{"ok": true, "ts": 1736089200000}

GET /v1/api/fiyat/mahalle/:il/:ilce/:mahalle

Mahalle bazlı fiyat istatistiği (TL/m² medyan, q1, q3, ortalama, ilan adedi).

curl -H "X-API-Key: cdrm_..." \
  "https://cadastrum-api.cadastrum-tr.workers.dev/v1/api/fiyat/mahalle/istanbul/beykoz/akbaba?kategori=arsa"

GET /v1/api/emsal/spatial

Koord bazlı spatial emsal sorgu — 5 km yarıçap içindeki ilanlar.

curl -H "X-API-Key: cdrm_..." \
  "https://cadastrum-api.cadastrum-tr.workers.dev/v1/api/emsal/spatial?lat=41.08&lng=29.05&radius_km=3&kategori=arsa"

GET /v1/api/risk/deprem?il=istanbul

İl bazlı deprem risk metadata.

Hata kodları

HTTP	Anlam
401	Token yok veya geçersiz
404	Veri bulunamadı
429	Rate limit aşıldı
500	Sunucu hatası

OpenAPI Spec

Tam spec: openapi.yaml. Swagger UI, Postman, Scalar gibi araçlarla doğrudan import edebilirsin.

Örnekler (curl)

# İstanbul Beykoz Akbaba arsa medyan fiyatı
curl -H "X-API-Key: $TOKEN" \
  https://cadastrum-api.cadastrum-tr.workers.dev/v1/api/fiyat/mahalle/istanbul/beykoz/akbaba

# Bodrum çevresinde 10 km içinde arsa emsalleri
curl -H "X-API-Key: $TOKEN" \
  "https://cadastrum-api.cadastrum-tr.workers.dev/v1/api/emsal/spatial?lat=37.04&lng=27.43&radius_km=10&kategori=arsa"