Türkiye gayrimenkul verisi, tek bir API'de.

Parsel ve kadastro, imar planı, zemin riski, hexagon / mahalle bazında piyasa değeri, kira getirisi, resmi satış adetleri, otomatik değerleme ve etki alanı analizi. JSON döner, anahtarla çalışır, kullandığınız kadar ödersiniz.

REST · JSON121 uç nokta81 ilOpenAPI 3.1Sürüm 1.4.0

Tapusor API'ye sorun

Aradığınız veri bu API'de var mı, hangi adresle alınır? Doğal dille yazın; yapay zekâ yalnız bu belgedeki hizmet listesine bakarak cevaplar.

Hızlı başlangıç

1) Test anahtarı isteyin (ücretsiz); canlıya geçerken canlı anahtar alın. 2) İsteği Authorization başlığıyla gönderin. 3) Yanıttaki data alanını kullanın.

curl -s "https://www.ai.tapusor.com/public/api/v1/valuation/estimate?lat=41.0369&lng=28.985&subcategory=10010&area_m2=120" \
  -H "Authorization: Bearer tsk_test_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Kimlik doğrulama

Her istekte anahtarınızı Authorization: Bearer <anahtar> ya da X-API-Key: <anahtar> başlığıyla gönderin. Anahtarı adres satırına (sorgu dizgesine) koymayın.

AnahtarBiçimDavranış
Canlıtsk_live_…Gerçek veri, kredi düşer, faturaya girer.
Testtsk_test_…Gerçek veri, ücretsiz; günde 200, dakikada 10 istek. Entegrasyon geliştirmek içindir.
Anahtarınız yalnız oluşturulduğu anda bir kez gösterilir; biz yalnız tek yönlü özetini saklarız. Kaybederseniz yenisini isteyin, eskisi iptal edilir. Anahtarı yalnız sunucu tarafında tutun; isterseniz belirli IP / ağlara kilitletebilirsiniz.

Yanıt biçimi

Başarılı yanıt her zaman data ve meta taşır. data ürüne göre nesne ya da dizidir.

{
  "data": { "value": 9856000, "unit": 82133, "lo": 8900000, "hi": 10800000, "conf": { … } },
  "meta": {
    "request_id": "req_4f1c…",          // destek isterken bunu iletin
    "product": "valuation.estimate",
    "credits_charged": 10,
    "credits_remaining": 49120,
    "period_end": "2026-11-01",
    "environment": "live",
    "took_ms": 412,
    "version": "1.4.0"
  }
}

Her yanıtta şu başlıklar da gelir: X-Request-Id, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (Unix zamanı), başarılı veri isteğinde X-Credits-Charged ve X-Credits-Remaining.

Çıktı biçimi: JSON, GeoJSON, metin

Her veri ucunda format parametresiyle biçim seçilir; kredi ve sınırlar aynıdır. Hata yanıtları her zaman JSON'dur.

formatİçerik türüNe döner
json (varsayılan)application/json{ "data": …, "meta": … }
geojsonapplication/geo+jsonGeoJSON FeatureCollection: her sonuç bir Feature (geometri, yoksa enlem-boylamdan nokta; geometrisi olmayan sonuçta null), meta ek üye olarak. QGIS, Leaflet, Mapbox ve ArcGIS'e doğrudan yüklenir.
texttext/plainOkunur düz metin: alan.alt_alan: değer satırları ve sonda # meta satırları (geometriler yazılmaz).
curl -s "https://www.ai.tapusor.com/public/api/v1/market/hexagons?bbox=28.74,41.03,28.78,41.06&resolution=4&format=geojson" -H "Authorization: Bearer $TAPUSOR_API_KEY" > hexagonlar.geojson

Harita katmanları için aşağıdaki WMS servisine bakın.

WMS harita servisi

Risk, kadastro ve arazi katmanlarını hazır harita görüntüsü olarak alın: QGIS, ArcGIS, MapInfo, Leaflet, OpenLayers doğrudan bağlanır. OGC WMS 1.1.1 ve 1.3.0; GetCapabilities ve GetLegendGraphic ücretsiz, her GetMap 1 kredi. Koordinat sistemi EPSG:3857 / EPSG:4326, görüntü en çok 1024 × 1024 piksel, PNG / JPEG.

Adres: https://www.ai.tapusor.com/public/api/v1/wms
QGIS: Katman › Katman Ekle › WMS/WMTS › Yeni bağlantı
  URL: https://www.ai.tapusor.com/public/api/v1/wms
  HTTP başlığı: X-API-Key = tsk_live_…      (başlık eklenemeyen istemcide: https://www.ai.tapusor.com/public/api/v1/wms?key=tsk_live_…)
Katman adıİçerikGörünür alan sınırıKaynak
tapusor:parselParsel sınırları (TKGM, güncel)
Türkiye geneli güncel kadastro parselleri.
en çok 8 kmTKGM
tapusor:binaBina taban alanları
Bina izleri (Microsoft Building Footprints).
en çok 8 kmMicrosoft Building Footprints (ODbL)
tapusor:idari-sinirİdari sınırlar
İl, ilçe ve mahalle sınırları.
—Tapusor
tapusor:arazi-kullanimiArazi kullanımı (şehir atlası)
Kentsel arazi kullanım sınıfları.
en çok 60 kmTUCBS şehir atlası
tapusor:kisitli-alanKısıtlı alanlar
Yapılaşmayı kısıtlayan alanların birleşik görünümü.
—Tapusor
tapusor:fay-hattiFay hatları
Fay hattı zonları.
—Tapusor
tapusor:heyelanHeyelan alanları
Heyelan riski taşıyan alanlar.
—Tapusor
tapusor:su-havzasiSu havzaları
İçme suyu havza koruma alanları.
—Tapusor
tapusor:ormanOrman alanları
Orman ve bitki örtüsü alanları.
en çok 200 kmTapusor
tapusor:sit-alaniSit ve Resmî Gazete alanları
Resmî Gazete kararlarıyla ilan edilen sit ve koruma alanları.
—Resmî Gazete
tapusor:kentsel-donusumKentsel dönüşüm alanları
Kentsel dönüşüm projesi kapsamındaki alanlar.
—Resmî Gazete
tapusor:kamulastirmaKamulaştırma alanları
Resmî Gazete kararlarıyla kamulaştırmaya giren alanlar.
—Resmî Gazete
tapusor:ova-korumaBüyük ova koruma alanları
Resmî Gazete ile ilan edilen ova koruma alanları.
—Resmî Gazete
tapusor:imar-planie-Plan imar planı sınırları
e-Plan'da yayımlanan imar planlarının kapsama alanları.
en çok 120 kme-Plan
tapusor:corine-ormanOrman ve yarı doğal alanlar (CORINE)
Uydu görüntülerinden arazi örtüsü.
—CORINE
tapusor:corine-meraMeralar (CORINE)
Uydu görüntülerinden mera alanları.
—CORINE
tapusor:corine-sulak-alanSulak alanlar (CORINE)
Uydu görüntülerinden sulak alanlar.
—CORINE
tapusor:poiÖnemli noktalar (OSM)
OpenStreetMap ilgi noktaları.
en çok 15 km© OpenStreetMap katkıcıları (ODbL)
tapusor:yolYollar (OSM)
OpenStreetMap yol ağı.
en çok 40 km© OpenStreetMap katkıcıları (ODbL)
tapusor:denizDeniz alanları
Deniz ve kıyı alanları.
—Tapusor

Anahtar adres satırında (?key=) yalnız WMS'te kabul edilir; mümkünse başlık kullanın. Nesne bilgisi sorgusu (GetFeatureInfo) ve süzgeç parametreleri kapalıdır. OSM / ODbL kaynaklı katmanlarda haritada “© OpenStreetMap katkıcıları” atfı zorunludur.

Hatalar

Hata yanıtı tek biçimdedir; code makine tarafından okunur, message insan içindir. Hatalı isteklerden kredi düşmez.

{ "error": { "code": "invalid_parameter", "message": "lat: aralık dışı (35.5–42.5)", "param": "lat", "request_id": "req_…" } }
HTTPcodeAnlamıNe yapmalı
401unauthorizedAPI anahtarı yok ya da geçersiz.Anahtarı ve başlığı denetleyin.
401key_revokedBu API anahtarı iptal edilmiş.Yeni anahtar isteyin.
401token_invalidToken geçersiz ya da süresi dolmuş; POST /v1/token ile yenisini alın.
403account_no_userBu API hesabı bir Tapusor üyesine (i_user) bağlı değil; anahtar ve token kullanılamaz.
403account_suspendedHesap askıya alınmış ya da kapalı.Satış ekibiyle görüşün.
403ip_not_allowedBu IP adresi anahtar için izinli değil.IP izin listesini güncelletin.
403product_not_in_planBu ürün planınızda yok.Planınızı yükseltin.
404not_foundBöyle bir uç nokta yok.Yolu belgeyle karşılaştırın.
405method_not_allowedBu uç nokta yalnız GET kabul eder.GET kullanın.
422invalid_parameterParametre geçersiz.param alanındaki parametreyi düzeltin.
429rate_limitedDakikalık istek sınırı aşıldı.Retry-After saniye bekleyip yeniden deneyin.
429quota_exceededDönem kredisi bitti.Yeni dönemi bekleyin ya da plan yükseltin.
429daily_limitTest anahtarının günlük istek sınırı doldu.Yarını bekleyin ya da canlı anahtar kullanın.
404no_dataBu konum / parametre için veri yok.Bu konumda veri yok; kredi düşmedi.
500internal_errorBeklenmeyen bir hata oluştu.request_id ile bildirin.
502upstream_errorVeri kaynağı yanıt vermedi.Biraz sonra yeniden deneyin (üstel bekleme).
503maintenanceBakım çalışması var; kısa süre sonra tekrar deneyin.Retry-After kadar bekleyin.
503busySunucu meşgul; kısa süre sonra tekrar deneyin.Retry-After kadar bekleyin.

Kredi ve hız sınırı

Her ürünün bir kredi değeri vardır (uç nokta başlığında yazar). Kredi yalnız başarılı (2xx) ve veri dönen istekte düşer. Planınızdaki kredi her fatura döneminin başında yenilenir; kullanılmayan kredi devretmez. Aşımı açık planlarda kredi bitince istekler sürer, aşım dönem sonunda 1.000 kredilik dilimlerle faturalanır; aşımı kapalı planlarda quota_exceeded döner.

Hız sınırı anahtar başına dakikalıktır. Sınır aşılınca 429 rate_limited ve Retry-After başlığı döner. Toplu işler için istekleri yayın; 5xx ve 429'da üstel bekleme ile yeniden deneyin.

ÜrünYolKredi
Koordinattaki parselGET /public/api/v1/parcels/at1
Ada / parsel aramasıGET /public/api/v1/parcels/search1
İl / ilçe / mahalle listesiGET /public/api/v1/locationsücretsiz
Koordinattan idari kimliklerGET /public/api/v1/locations/resolve1
Sınır geometrisiGET /public/api/v1/boundaries1
Zemin ve heyelanGET /public/api/v1/risk/ground2
e-Plan imar planlarıGET /public/api/v1/zoning/plans2
Parsel imar durumuGET /public/api/v1/zoning/parcel3
Parsel açık cepheGET /public/api/v1/parcels/frontage2
Bina bilgisiGET /public/api/v1/buildings/at2
Hexagon piyasa haritasıGET /public/api/v1/market/hexagons3
Tek hexagon istatistiğiGET /public/api/v1/market/hexagons/{id}1
İlçe / mahalle piyasa haritasıGET /public/api/v1/market/areas3
Tek ilçe / mahalle istatistiğiGET /public/api/v1/market/areas/{id}1
Çeyreklik m² trendiGET /public/api/v1/market/trend1
Oda sayısına göre kira getirisiGET /public/api/v1/market/rental-yield2
Piyasa göstergeleriGET /public/api/v1/market/indicators3
Finansal derinlik ve rekabetGET /public/api/v1/market/competition3
Pazarda kalma süresiGET /public/api/v1/market/time-on-market3
Resmi (TKGM) satış adetleriGET /public/api/v1/sales/official2
Bölge değer skoruGET /public/api/v1/scores/location1
Otomatik değerlemeGET /public/api/v1/valuation/estimate10
Etki alanı analiziGET /public/api/v1/catchment5
Kayıt aramaGET /public/api/v1/records3
Kayıt ayrıntısıGET /public/api/v1/records/detail2
Noktaya yakın kayıtlarGET /public/api/v1/records/nearby3
Bileşik risk skoruGET /public/api/v1/risk/score8
Parsel teknik özetiGET /public/api/v1/technical/summary5
Teknik kontrollerGET /public/api/v1/technical/controls10
Haber ve şikâyet yoğunluğuGET /public/api/v1/news/summary2
Erişilebilirlik özetiGET /public/api/v1/accessibility3
Bölge donatı özetiGET /public/api/v1/poi/area2
Yakındaki tapu satışlarıGET /public/api/v1/sales/nearby2
Bölge tapu satış özetiGET /public/api/v1/sales/area2
Talep yoğunluğuGET /public/api/v1/demand/map3
Katman özeti (alan içi)GET /public/api/v1/layers/summary3
Alandaki imar planlarıGET /public/api/v1/layers/plans3
Yıllık m² değişimiGET /public/api/v1/market/yoy2
Emsalli değer sorgusuGET /public/api/v1/valuation/comparables10
EDI yapay zekâ konum skoruGET /public/api/v1/scores/edi3
TÜİK sosyoekonomik verilerGET /public/api/v1/socioeconomics3
Deprem risk puanıGET /public/api/v1/risk/earthquake3
İdari birimde TKGM satışlarıGET /public/api/v1/sales/admin2
TKGM satış serileriGET /public/api/v1/sales/trend2
Halka bazlı aylık m² medyanıGET /public/api/v1/market/ring-monthly2
En yakın donatılarGET /public/api/v1/poi/nearest2
Konut Fiyat Endeksi (KFE)GET /public/api/v1/index/kfe1
Fiyatı bugüne taşıma (KFE)GET /public/api/v1/index/kfe/adjust1
Makro veri kaynaklarıGET /public/api/v1/macro/sourcesücretsiz
Makro veri serisiGET /public/api/v1/macro/series1
Fay HattıGET /public/api/v1/technical/controls/fay-hatti2
Zemin Deprem PuanıGET /public/api/v1/technical/controls/zemin-deprem-puani2
Heyelan AlanıGET /public/api/v1/technical/controls/heyelan-alani2
Su Havzası AlanıGET /public/api/v1/technical/controls/su-havzasi-alani2
Sulak AlanGET /public/api/v1/technical/controls/sulak-alan2
Sit AlanıGET /public/api/v1/technical/controls/sit-alani2
Orman AlanıGET /public/api/v1/technical/controls/orman-alani2
Kamulaştırma AlanıGET /public/api/v1/technical/controls/kamulastirma-alani2
Resmî Gazete Kararı Kapsamındaki AlanGET /public/api/v1/technical/controls/resmi-gazete-karari-kapsamindaki-alan2
Ova Koruma AlanıGET /public/api/v1/technical/controls/ova-koruma-alani2
Sorgu Dışı AlanGET /public/api/v1/technical/controls/sorgu-disi-alan2
İmar PlanıGET /public/api/v1/technical/controls/imar-plani2
Yerleşim AlanıGET /public/api/v1/technical/controls/yerlesim-alani2
Kentsel Dönüşüm AlanıGET /public/api/v1/technical/controls/kentsel-donusum-alani2
Yenileme AlanıGET /public/api/v1/technical/controls/yenileme-alani2
Plan Tadilat AlanıGET /public/api/v1/technical/controls/plan-tadilat-alani2
Mega Projeler Alanı (İstanbul)GET /public/api/v1/technical/controls/mega-projeler-alani2
Arazi Toplulaştırma AlanıGET /public/api/v1/technical/controls/arazi-toplulastirma-alani2
Parsel Değişikliği Yapılan AlanGET /public/api/v1/technical/controls/parsel-degisikligi-yapilan-alan2
Kadastro AlanıGET /public/api/v1/technical/controls/kadastro-alani2
Belediye RayiçGET /public/api/v1/technical/controls/belediye-rayic2
Popülerlik AnaliziGET /public/api/v1/technical/controls/populerlik-analizi2
Tarla Satış HızıGET /public/api/v1/technical/controls/tarla-satis-hizi2
Daire Satış HızıGET /public/api/v1/technical/controls/daire-satis-hizi2
İşyeri Satış HızıGET /public/api/v1/technical/controls/isyeri-satis-hizi2
Ana Taşınmaz İpotekli Satış SkoruGET /public/api/v1/technical/controls/ana-tasinmaz-ipotekli-satis-skoru2
Ana Taşınmaz İpoteksiz Satış SkoruGET /public/api/v1/technical/controls/ana-tasinmaz-ipoteksiz-satis-skoru2
Bağımsız Bölüm İpotekli Satış SkoruGET /public/api/v1/technical/controls/bagimsiz-bolum-ipotekli-satis-skoru2
Bağımsız Bölüm İpoteksiz Satış SkoruGET /public/api/v1/technical/controls/bagimsiz-bolum-ipoteksiz-satis-skoru2
Bina (Fiziki Yapılaşmış) AlanGET /public/api/v1/technical/controls/bina-alan2
Site AlanıGET /public/api/v1/technical/controls/site-alani2
Ortalama Bina YaşıGET /public/api/v1/technical/controls/ortalama-bina-yasi2
Boğaz GörünümGET /public/api/v1/technical/controls/bogaz-gorunum2
Deniz Göl AlanıGET /public/api/v1/technical/controls/deniz-gol-alani2
Su Yüzeyi AlanıGET /public/api/v1/technical/controls/su-yuzeyi-alani2
Ulaşım AğıGET /public/api/v1/technical/controls/ulasim-agi2
Elektrik Şebekesi AlanıGET /public/api/v1/technical/controls/elektrik-sebekesi-alani2
OSB AlanıGET /public/api/v1/technical/controls/osb-alani2
Havamania AlanıGET /public/api/v1/technical/controls/havamania-alani2
En Yakın HavalimanıGET /public/api/v1/technical/controls/en-yakin-havalimani2
En Yakın Metro DurağıGET /public/api/v1/technical/controls/en-yakin-metro-duragi2
En Yakın Metrobüs DurağıGET /public/api/v1/technical/controls/en-yakin-metrobus-duragi2
En Yakın Otobüs DurağıGET /public/api/v1/technical/controls/en-yakin-otobus-duragi2
En Yakın Minibüs DurağıGET /public/api/v1/technical/controls/en-yakin-minibus-duragi2
En Yakın Taksi DurağıGET /public/api/v1/technical/controls/en-yakin-taksi-duragi2
En Yakın HastaneGET /public/api/v1/technical/controls/en-yakin-hastane2
En Yakın ÜniversiteGET /public/api/v1/technical/controls/en-yakin-universite2
En Yakın KarakolGET /public/api/v1/technical/controls/en-yakin-karakol2
En Yakın Eğitim KurumuGET /public/api/v1/technical/controls/en-yakin-egitim-kurumu2
Ekilebilir AlanGET /public/api/v1/technical/controls/ekilebilir-alan2
Kalıcı Mahsul AlanGET /public/api/v1/technical/controls/kalici-mahsul-alan2
Mera AlanGET /public/api/v1/technical/controls/mera-alan2
Heterojen Tarım AlanıGET /public/api/v1/technical/controls/heterojen-tarim-alani2
Altlık ParsellerGET /public/api/v1/technical/controls/altlik-parseller2
Şehir Atlası TUCBSGET /public/api/v1/technical/controls/sehir-atlasi-tucbs2
Şehir Atlası TuvimerGET /public/api/v1/technical/controls/sehir-atlasi-tuvimer2
TKGM Satış AlanıGET /public/api/v1/technical/controls/tkgm-satis-alani2
Lokasyon BilgisiGET /public/api/v1/technical/controls/lokasyon-bilgisi2
Resmî Gazete Kararı (2 km)GET /public/api/v1/technical/controls/resmi-gazete-karari2
En Yakın StarbucksGET /public/api/v1/technical/controls/en-yakin-starbucks2
En Yakın MigrosGET /public/api/v1/technical/controls/en-yakin-migros2
En Yakın A101GET /public/api/v1/technical/controls/en-yakin-a1012
En Yakın BİMGET /public/api/v1/technical/controls/en-yakin-bim2
En Yakın ŞokGET /public/api/v1/technical/controls/en-yakin-sok2
En Yakın AVMGET /public/api/v1/technical/controls/en-yakin-avm2
En Yakın SinemaGET /public/api/v1/technical/controls/en-yakin-sinema2
En Yakın TiyatroGET /public/api/v1/technical/controls/en-yakin-tiyatro2
En Yakın CamiGET /public/api/v1/technical/controls/en-yakin-cami2
En Yakın PlajGET /public/api/v1/technical/controls/en-yakin-plaj2
En Yakın Noktalar AnaliziGET /public/api/v1/technical/controls/en-yakin-noktalar-analizi2
Askıdaki PlanGET /public/api/v1/technical/controls/askidaki-plan2

Fiyatlar

Başlangıç

4.900 ₺ / ay
Küçük ekipler ve prototipler
  • 100 kredi / ay
  • Dakikada 10 istek
  • Aşım: 1.000 kredi 120 ₺
  • Tüm ürünler

Profesyonel

14.900 ₺ / ay
Üretimde çalışan uygulamalar
  • 500 kredi / ay
  • Dakikada 60 istek
  • Aşım: 1.000 kredi 90 ₺
  • Tüm ürünler

Kurumsal

49.900 ₺ / ay
Banka, sigorta, değerleme şirketleri; SLA
  • 2.500 kredi / ay
  • Dakikada 300 istek
  • Aşım: 1.000 kredi 60 ₺
  • Tüm ürünler

Fiyatlara KDV dahil değildir. Kurumsal sözleşme, özel kota ve SLA için satış ekibiyle görüşün.

Kullanımı izleme

GET /public/api/v1/usage (ücretsiz) geçerli dönemi, kullanılan / kalan krediyi, aşımı ve ürün kırılımını verir. Ürün listesi ve kredileri anahtarsız: GET /public/api/v1/products. Makine okunur tanım: /public/api/v1/openapi (Postman / Insomnia / kod üreticilerine doğrudan yüklenir).

Uç noktalar

Konum ve kadastro

Koordinattan parsel, ada / parsel araması, idari birimler ve sınırlar.

GET/public/api/v1/parcels/at1 kredi

Koordinattaki parsel parcel.at

Noktanın düştüğü güncel TKGM parselinin (Türkiye geneli) il / ilçe / mahalle, mevki, ada / parsel, nitelik, yüzölçüm, pafta, alan ve geometrisi.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
curl -s "https://www.ai.tapusor.com/public/api/v1/parcels/at?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/parcels/at?lat=41.04768437505737&lng=28.760775996083126
{
    "data": {
        "parsel_id": 50927385482858,
        "il_id": 56,
        "il_adi": "İstanbul",
        "ilce_id": 524,
        "ilce_adi": "Küçükçekmece",
        "mahalle_id": 146060,
        "mahalle_adi": "Halkalı",
        "mevkii": "Menekşe",
        "ada_no": 800,
        "parsel_no": 4,
        "nitelik": "61 blok betonamre apartman ve arsası",
        "yuzolcum": 246092.58,
        "pafta": "F21c21a1b",
        "zemin_km_durum": "Kat Mülkiyet",
        "durum": 1,
        "is_current": true,
        "kayit_tarihi": "2026-10-22",
        "geom_alan_m2": 245844,
        "merkez_lat": 41.047925,
        "merkez_lng": 28.760457,
        "geom": {
            "type": "Polygon",
            "coordinates": "… (koordinat dizisi kısaltıldı)"
        }
    },
    "meta": {
        "request_id": "req_7df083d931aaa74f0011",
        "product": "parcel.at",
        "credits_charged": 1,
        "credits_remaining": 1499340,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 141,
        "version": "1.3.0"
    }
}
GET/public/api/v1/locationsücretsiz

İl / ilçe / mahalle listesi location.list

TKGM idari birim listesi. Ücretsizdir (kredi düşmez, istek sayılır).

ParametreTürAçıklamaÖrnek
kind zorunlu seçenek: il, ilce, mahalleListe türü.ilce
parent_id tamsayı (1–999999999)Üst birim kimliği (ilçe için il, mahalle için ilçe).56
curl -s "https://www.ai.tapusor.com/public/api/v1/locations?kind=ilce" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/locations?kind=ilce&parent_id=56
{
    "data": [
        {
            "id": 504,
            "ad": "Adalar"
        },
        {
            "id": 6132,
            "ad": "Arnavutköy"
        },
        {
            "id": 6133,
            "ad": "Ataşehir"
        },
        "… (36 öğe daha)"
    ],
    "meta": {
        "request_id": "req_f2e94d67a6c067e29018",
        "product": "location.list",
        "credits_charged": 0,
        "credits_remaining": 1499339,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 88,
        "version": "1.3.0"
    }
}
GET/public/api/v1/locations/resolve1 kredi

Koordinattan idari kimlikler location.resolve

Noktanın idari (il / ilçe / mahalle), TKGM ve hexagon (1–8) kimlikleri; diğer uçlara girdi olarak kullanılır.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
curl -s "https://www.ai.tapusor.com/public/api/v1/locations/resolve?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/locations/resolve?lat=41.04768437505737&lng=28.760775996083126
{
    "data": {
        "hex1": 109068304,
        "hex2": 202272340,
        "hex3": 300570746,
        "hex4": 400143861,
        "hex5": 500036431,
        "hex6": 600009341,
        "hex7": 700002406,
        "hex8": 800001425,
        "ada_no": 800,
        "kds_id": 50927385482858,
        "kds_il": 56,
        "kds_lat": 41.047925,
        "kds_lng": 28.760457073170734,
        "kds_mah": 146060,
        "nitelik": "61 blok betonamre apartman ve arsası",
        "idari_il": 34,
        "kds_ilce": 524,
        "idari_mah": 33891,
        "kds_pafta": "F21c21a1b",
        "parsel_no": 4,
        "idari_ilce": 1823,
        "kds_il_adi": "İstanbul",
        "kds_nitelik": "61 blok betonamre apartman ve arsası",
        "kds_ilce_adi": "Küçükçekmece",
        "yuzolcum_int": 246092.58,
        "idari_il_name": "İstanbul",
        "kds_parsel_id": null,
        "idari_ilce_name": "Küçükçekmece",
        "kds_mahalle_adi": "Halkalı",
        "idari_mahkoy_name": "Atakent Mh."
    },
    "meta": {
        "request_id": "req_d069e565f230ddc02f5b",
        "product": "location.resolve",
        "credits_charged": 1,
        "credits_remaining": 1499341,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 215,
        "version": "1.3.0"
    }
}
GET/public/api/v1/boundaries1 kredi

Sınır geometrisi boundary.at

Noktayı içeren il / ilçe / mahalle / ada sınırı (GeoJSON).

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
level zorunlu seçenek: il, ilce, mah, adaSınır düzeyi.mah
curl -s "https://www.ai.tapusor.com/public/api/v1/boundaries?lat=41.0369&lng=28.985&level=mah" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · level mah (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/boundaries?lat=41.04768437505737&lng=28.760775996083126&level=mah
{
    "data": {
        "ad": "Halkalı",
        "n": 15413,
        "geom": "{\"type\":\"MultiPolygon\",\"coordinates\":[[[[28.75053,41.02908],[28.75058,41.02936],[28.7507,41.02954],[28.75098,41.03041],[28.75139,41.03127],[28.75214,41.03239],[28.75225,41.03292],[28.75211,41.03344],[…"
    },
    "meta": {
        "request_id": "req_ornek",
        "product": "boundary.at",
        "credits_charged": 1,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}

İmar ve risk

İmar planları, parsel imar durumu, zemin / heyelan, cephe, bina.

GET/public/api/v1/risk/ground2 kredi

Zemin ve heyelan ground.risk

Jeolojik birim (formasyon, yaş, puan) ve yakın heyelan envanteri.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
curl -s "https://www.ai.tapusor.com/public/api/v1/risk/ground?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/risk/ground?lat=41.04768437505737&lng=28.760775996083126
{
    "data": {
        "zemin": {
            "kod": "Yd",
            "formasyon": "Yapay Dolgu",
            "puan": 10,
            "jeo_yasi": "Güncel",
            "kisa_aciklama": "en kötü zemin grubudur"
        },
        "heyelan": {
            "n": 0,
            "tip": null
        }
    },
    "meta": {
        "request_id": "req_4cd0ce994fbd00e2ddd7",
        "product": "ground.risk",
        "credits_charged": 2,
        "credits_remaining": 1499336,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 117,
        "version": "1.3.0"
    }
}
GET/public/api/v1/zoning/plans2 kredi

e-Plan imar planları zoning.plans

Noktayı kapsayan onaylı imar planları (ad, tür, tarih, e-Plan bağlantısı).

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
curl -s "https://www.ai.tapusor.com/public/api/v1/zoning/plans?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04548, 28.99063 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/zoning/plans?lat=41.04548&lng=28.99063
{
    "data": [
        {
            "adi": "Harbiye Tarihi ve Kentsel Sit Alanı 1. Etap 1/1000 Ölçekli Koruma Amaçlı Uygulama İmar Planı",
            "turu": "Koruma Amaçlı Uygulama İmar Planı",
            "il": "İstanbul",
            "ilce": "",
            "tarih": "2026-08-14",
            "url": null
        },
        {
            "adi": "Harbiye Tarihi ve Kentsel Sit Alanı 1/5000 Ölçekli Koruma Amaçlı Nazım İmar Planı",
            "turu": "Koruma Amaçlı Nazım İmar Planı",
            "il": "İstanbul",
            "ilce": "",
            "tarih": "2026-08-14",
            "url": null
        }
    ],
    "meta": {
        "request_id": "req_ornek",
        "product": "zoning.plans",
        "credits_charged": 2,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}
GET/public/api/v1/zoning/parcel3 kredi

Parsel imar durumu zoning.parcel

1/1000 uygulama imar planındaki fonksiyon, TAKS / KAKS ve plan tadilatları.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
curl -s "https://www.ai.tapusor.com/public/api/v1/zoning/parcel?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/zoning/parcel?lat=41.04768437505737&lng=28.760775996083126
{
    "data": {
        "parsel": {
            "il": "İstanbul",
            "ilce": "Küçükçekmece",
            "mahkoy": "Halkalı",
            "ada": 800,
            "parsel": 4,
            "plan_fonksiyon_lkp": "YERLEŞİK KONUT ALANI",
            "plan_fonksiyon_pre_lkp": "KONUT ALANLARI",
            "page_url": "https://keos.kucukcekmece.bel.tr/imardurumu/service/imarsvc.aspx?type=adaparsel&adaparsel=800&ilce=-100000&tmahalle=-100000&tamKelimeAra=1",
            "tarih": "2025-10-14",
            "alan": 245843.700831566,
            "geom": "{\"type\":\"Polygon\",\"coordinates\":[[[28.76037,41.0512],[28.76169,41.05055],[28.76187,41.05034],[28.76187,41.05031],[28.76202,41.04904],[28.76206,41.04878],[28.76207,41.04864],[28.76208,41.04856],[28.762…"
        },
        "sisli": null,
        "tadilat": []
    },
    "meta": {
        "request_id": "req_ornek",
        "product": "zoning.parcel",
        "credits_charged": 3,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}
GET/public/api/v1/parcels/frontage2 kredi

Parsel açık cephe parcel.frontage

Parselin yola / boşluğa bakan cepheleri.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
curl -s "https://www.ai.tapusor.com/public/api/v1/parcels/frontage?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/parcels/frontage?lat=41.04768437505737&lng=28.760775996083126
{
    "data": {
        "cephe": [
            {
                "il": "İstanbul",
                "geom": {
                    "type": "LineString",
                    "coordinates": "… (koordinat dizisi kısaltıldı)"
                },
                "ilce": "Küçükçekmece",
                "ada_no": 800,
                "mahalle": "Halkalı",
                "cephe_no": 1,
                "parsel_no": 4,
                "mahalle_id": 146060,
                "cephe_metre": 917.47
            },
            {
                "il": "İstanbul",
                "geom": {
                    "type": "LineString",
                    "coordinates": "… (koordinat dizisi kısaltıldı)"
                },
                "ilce": "Küçükçekmece",
                "ada_no": 800,
                "mahalle": "Halkalı",
                "cephe_no": 2,
                "parsel_no": 4,
                "mahalle_id": 146060,
                "cephe_metre": 847.67
            }
        ]
    },
    "meta": {
        "request_id": "req_8acca86ed573e513b54e",
        "product": "parcel.frontage",
        "credits_charged": 2,
        "credits_remaining": 1499331,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 135,
        "version": "1.3.0"
    }
}
GET/public/api/v1/buildings/at2 kredi

Bina bilgisi building.at

Noktadaki bina: kat adedi, bağımsız bölüm sayıları, taban alanı, geometri (İstanbul envanteri; diğer illerde bina izi).

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
curl -s "https://www.ai.tapusor.com/public/api/v1/buildings/at?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/buildings/at?lat=41.04768437505737&lng=28.760775996083126
{
    "data": {
        "kaynak": "ist",
        "gid": 524411,
        "kat_adedi": 0,
        "normal_kat": 0,
        "bodrum_kat": 0,
        "cati_kati": 0,
        "konut_sayi": 0,
        "isyeri_say": 0,
        "yapi_adi": "Kandilli Restoran",
        "obje_adi": "Türk Restoran",
        "alan": 179.2533547054045,
        "geom": "{\"type\":\"Polygon\",\"coordinates\":[[[28.7608,41.047556],[28.760827,41.047562],[28.760822,41.047577],[28.760918,41.047614],[28.760927,41.047595],[28.760972,41.047614],[28.761018,41.047537],[28.760974,41.…",
        "oe": "{\"type\":\"Polygon\",\"coordinates\":[[[28.761022,41.047528],[28.760844,41.047452],[28.760796,41.047566],[28.760974,41.047641],[28.761022,41.047528]]]}",
        "uzak": 12.37718197
    },
    "meta": {
        "request_id": "req_3f61f7f6b0923eb5112d",
        "product": "building.at",
        "credits_charged": 2,
        "credits_remaining": 1499329,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 348,
        "version": "1.3.0"
    }
}

Piyasa verisi

Hexagon / ilçe / mahalle bazında m² değeri, trend, kira getirisi, pazarda kalma süresi, resmi satışlar.

GET/public/api/v1/market/hexagons3 kredi

Hexagon piyasa haritası market.hexagons

Alandaki hexagonlar için seçilen ölçü (medyan m² değeri, ilan sayısı, kira getirisi …) ve geometri. En çok 2.000 hücre.

ParametreTürAçıklamaÖrnek
bbox zorunlu alan (bbox)Alan: batı,güney,doğu,kuzey (derece).28.95,41.00,29.02,41.05
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (2 en ince; ince çözünürlükte alan dar tutulmalı). Varsayılan: 3.4
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
metric seçenek: med_rayic, ilan_sayisi, med_fiyat, med_m2, kira_getirisi, amortisman, ceyrek_degisim, komsu_fark, avg_med_fark, mod_med_farkÖlçü. Varsayılan: med_rayic.med_rayic
rooms seçenek: 1+0, 1+1, 2+0, 2+1, 2+2, 3+0, 3+1, 3+2, 4+0, 4+1, 4+2+Oda sayısı süzgeci (ör. 2+1). Boşsa tüm oda tipleri.2+1
quarter çeyrek (YYYYQ)Çeyrek, YYYYQ (ör. 20262 = 2026 2. çeyrek). Boşsa son çeyrek.20262
province tamsayı (1–81)İl plaka kodu (İstanbul 34). Varsayılan: 34.34
curl -s "https://www.ai.tapusor.com/public/api/v1/market/hexagons?bbox=28.95%2C41.00%2C29.02%2C41.05&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — subcategory 10010 · rooms 2+1 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/market/hexagons?bbox=28.7408%2C41.0327%2C28.7808%2C41.0627&resolution=4&subcategory=10010&rooms=2%2B1
{
    "data": [
        {
            "id": 400143861,
            "geom": {
                "type": "Polygon",
                "coordinates": "… (koordinat dizisi kısaltıldı)"
            },
            "deger": 90551,
            "deger_tahmini": null,
            "tahmin_hex": 5
        },
        {
            "id": 400143862,
            "geom": {
                "type": "Polygon",
                "coordinates": "… (koordinat dizisi kısaltıldı)"
            },
            "deger": 80000,
            "deger_tahmini": null,
            "tahmin_hex": 5
        },
        {
            "id": 400143858,
            "geom": {
                "type": "Polygon",
                "coordinates": "… (koordinat dizisi kısaltıldı)"
            },
            "deger": 44090,
            "deger_tahmini": null,
            "tahmin_hex": 5
        },
        "… (14 öğe daha)"
    ],
    "meta": {
        "request_id": "req_8d9efda64ea73c938f58",
        "product": "market.hexagons",
        "credits_charged": 3,
        "credits_remaining": 1499307,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 309,
        "version": "1.3.0"
    }
}
GET/public/api/v1/market/hexagons/{id}1 kredi

Tek hexagon istatistiği market.hexagon

Bir hexagonun çeyrek istatistiği: ilan sayısı, medyan / ortalama / mod değer, fiyat, m², oda / yaş / kat dağılımı.

ParametreTürAçıklamaÖrnek
id zorunlu (yolda) tamsayıHexagon kimliği (/v1/market/hexagons ya da /v1/locations/resolve).123456
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü. Varsayılan: 3.4
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
rooms seçenek: 1+0, 1+1, 2+0, 2+1, 2+2, 3+0, 3+1, 3+2, 4+0, 4+1, 4+2+Oda sayısı süzgeci (ör. 2+1). Boşsa tüm oda tipleri.2+1
quarter çeyrek (YYYYQ)Çeyrek, YYYYQ (ör. 20262 = 2026 2. çeyrek). Boşsa son çeyrek.20262
province tamsayı (1–81)İl plaka kodu (İstanbul 34). Varsayılan: 34.34
curl -s "https://www.ai.tapusor.com/public/api/v1/market/hexagons/123456?subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — subcategory 10010 · rooms 2+1 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/market/hexagons/400143861?resolution=4&subcategory=10010&rooms=2%2B1
{
    "data": {
        "tip": "hex4",
        "lokasyon": 400143861,
        "ad_date_quart": 20262,
        "ad_subcategory_int": 10010,
        "count": 15,
        "med_rayic": 75728,
        "med_fiyat": 7800000,
        "med_m2": 103,
        "avg_rayic": 80368,
        "avg_fiyat": 8780000,
        "avg_m2": 108,
        "mod_rayic": 72330,
        "mod_fiyat": 11500000,
        "mod_m2": 103,
        "ad_build_room_int": 1650,
        "ad_build_age_int": 1635,
        "ad_build_floor_int": 1646,
        "ad_build_current_floor_int": 1657
    },
    "meta": {
        "request_id": "req_70617b73e103e2d006ee",
        "product": "market.hexagon",
        "credits_charged": 1,
        "credits_remaining": 1499306,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 94,
        "version": "1.3.0"
    }
}
GET/public/api/v1/market/areas3 kredi

İlçe / mahalle piyasa haritası market.areas

Alandaki ilçe ya da mahalleler için seçilen ölçü, ad ve geometri.

ParametreTürAçıklamaÖrnek
bbox zorunlu alan (bbox)Alan: batı,güney,doğu,kuzey (derece).28.95,41.00,29.02,41.05
level zorunlu seçenek: ilce, mahalleDüzey.mahalle
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
metric seçenek: med_rayic, ilan_sayisi, med_fiyat, med_m2, kira_getirisi, amortisman, ceyrek_degisim, komsu_fark, avg_med_fark, mod_med_fark, ilan_kapiÖlçü. Varsayılan: med_rayic.med_rayic
zoom tamsayı (0–21)Harita yakınlığı (alan genişliği sınırını belirler). Varsayılan: 12.13
rooms seçenek: 1+0, 1+1, 2+0, 2+1, 2+2, 3+0, 3+1, 3+2, 4+0, 4+1, 4+2+Oda sayısı süzgeci (ör. 2+1). Boşsa tüm oda tipleri.2+1
quarter çeyrek (YYYYQ)Çeyrek, YYYYQ (ör. 20262 = 2026 2. çeyrek). Boşsa son çeyrek.20262
province tamsayı (1–81)İl plaka kodu (İstanbul 34). Varsayılan: 34.34
curl -s "https://www.ai.tapusor.com/public/api/v1/market/areas?bbox=28.95%2C41.00%2C29.02%2C41.05&level=mahalle&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — subcategory 10010 · rooms 2+1 · level mahalle (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/market/areas?bbox=28.7108%2C41.0077%2C28.8108%2C41.0877&level=mahalle&zoom=13&subcategory=10010&rooms=2%2B1
{
    "data": [
        {
            "id": 33891,
            "ad": "Küçükçekmece / Atakent Mh.",
            "geom": {
                "type": "Polygon",
                "coordinates": "… (koordinat dizisi kısaltıldı)"
            },
            "lbl_lat": 41.048594,
            "lbl_lng": 28.777663,
            "deger": 96559,
            "deger_tahmini": null,
            "tahmin_hex": null
        },
        {
            "id": 33909,
            "ad": "Küçükçekmece / Yarımburgaz Mh.",
            "geom": {
                "type": "Polygon",
                "coordinates": "… (koordinat dizisi kısaltıldı)"
            },
            "lbl_lat": 41.034876,
            "lbl_lng": 28.755001,
            "deger": 60081,
            "deger_tahmini": null,
            "tahmin_hex": null
        },
        {
            "id": 33462,
            "ad": "Başakşehir / Ziya Gökalp Mh.",
            "geom": {
                "type": "Polygon",
                "coordinates": "… (koordinat dizisi kısaltıldı)"
            },
            "lbl_lat": 41.077845,
            "lbl_lng": 28.776119,
            "deger": 77159,
            "deger_tahmini": null,
            "tahmin_hex": null
        },
        "… (23 öğe daha)"
    ],
    "meta": {
        "request_id": "req_78c1f7f5eee3d475898b",
        "product": "market.areas",
        "credits_charged": 3,
        "credits_remaining": 1499303,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 161,
        "version": "1.3.0"
    }
}
GET/public/api/v1/market/areas/{id}1 kredi

Tek ilçe / mahalle istatistiği market.area

İlçe ya da mahallenin çeyrek istatistiği (ilan sayısı, medyan değer, fiyat, m², alt / üst kırılım).

ParametreTürAçıklamaÖrnek
id zorunlu (yolda) tamsayıİlçe / mahalle kimliği. İdari kimlik: ilçe için /v1/locations/resolve → idari_ilce, mahalle için idari_mah; hexagon için hex2–hex7 (bu uçlar TKGM kimliği kullanmaz).1186
level zorunlu seçenek: ilce, mahalleDüzey.ilce
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
rooms seçenek: 1+0, 1+1, 2+0, 2+1, 2+2, 3+0, 3+1, 3+2, 4+0, 4+1, 4+2+Oda sayısı süzgeci (ör. 2+1). Boşsa tüm oda tipleri.2+1
quarter çeyrek (YYYYQ)Çeyrek, YYYYQ (ör. 20262 = 2026 2. çeyrek). Boşsa son çeyrek.20262
province tamsayı (1–81)İl plaka kodu (İstanbul 34). Varsayılan: 34.34
curl -s "https://www.ai.tapusor.com/public/api/v1/market/areas/1186?level=ilce&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — subcategory 10010 · rooms 2+1 · level mahalle (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/market/areas/33891?level=mahalle&subcategory=10010&rooms=2%2B1
{
    "data": {
        "tip": "mahalle",
        "lokasyon": "Küçükçekmece / Atakent Mh.",
        "id": 33891,
        "ad_date_quart": 20262,
        "ad_subcategory_int": 10010,
        "ilan_sayisi": 372,
        "kirilim_sayisi": 71,
        "med_rayic": 96559,
        "med_fiyat": 10756210,
        "med_m2": 110,
        "avg_rayic": 98240,
        "mod_rayic": 108626,
        "min_kirilim_rayic": 47368,
        "max_kirilim_rayic": 180645,
        "rec_date": "2026-07-20"
    },
    "meta": {
        "request_id": "req_e2809acfa545837f0a62",
        "product": "market.area",
        "credits_charged": 1,
        "credits_remaining": 1499302,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 89,
        "version": "1.3.0"
    }
}
GET/public/api/v1/market/trend1 kredi

Çeyreklik m² trendi market.trend

Bölgenin çeyrek çeyrek medyan m² değeri ve ilan adedi.

ParametreTürAçıklamaÖrnek
id zorunlu tamsayıHexagon / ilçe / mahalle kimliği. İdari kimlik: ilçe için /v1/locations/resolve → idari_ilce, mahalle için idari_mah; hexagon için hex2–hex7 (bu uçlar TKGM kimliği kullanmaz).1186
level zorunlu seçenek: 2, 3, 4, 5, 6, 7, ilce, mahalleDüzey: hexagon çözünürlüğü (2–7), ilce ya da mahalle.ilce
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
province tamsayı (1–81)İl plaka kodu (İstanbul 34). Varsayılan: 34.34
curl -s "https://www.ai.tapusor.com/public/api/v1/market/trend?id=1186&level=ilce&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — subcategory 10010 · level mahalle · id 33891 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/market/trend?id=33891&level=mahalle&subcategory=10010
{
    "data": [
        {
            "q": 20221,
            "v": 69090,
            "n": 17
        },
        {
            "q": 20222,
            "v": 50473,
            "n": 11
        },
        {
            "q": 20223,
            "v": 59223,
            "n": 11
        },
        "… (16 öğe daha)"
    ],
    "meta": {
        "request_id": "req_9b7f472bda88847342d9",
        "product": "market.trend",
        "credits_charged": 1,
        "credits_remaining": 1499301,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 94,
        "version": "1.3.0"
    }
}
GET/public/api/v1/market/rental-yield2 kredi

Oda sayısına göre kira getirisi market.rental_yield

Oda tipine göre satılık / kiralık medyan değer, brüt kira getirisi (%) ve amortisman (yıl).

ParametreTürAçıklamaÖrnek
id zorunlu tamsayıHexagon / ilçe / mahalle kimliği. İdari kimlik: ilçe için /v1/locations/resolve → idari_ilce, mahalle için idari_mah; hexagon için hex2–hex7 (bu uçlar TKGM kimliği kullanmaz).1186
level zorunlu seçenek: 2, 3, 4, 5, 6, 7, ilce, mahalleDüzey.ilce
subcategory seçenek: 10010, 10176, 10056, 10216Konut için 10010 ya da 10176, dükkan için 10056 ya da 10216 (satılık ve kiralık eşi birlikte kullanılır; sonuç aynı). Varsayılan: 10010.10010
quarter çeyrek (YYYYQ)Çeyrek, YYYYQ (ör. 20262 = 2026 2. çeyrek). Boşsa son çeyrek.20262
province tamsayı (1–81)İl plaka kodu (İstanbul 34). Varsayılan: 34.34
curl -s "https://www.ai.tapusor.com/public/api/v1/market/rental-yield?id=1186&level=ilce&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — subcategory 10010 · level ilce · id 1823 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/market/rental-yield?id=1823&level=ilce&subcategory=10010
{
    "data": [
        {
            "oda": "1+0",
            "satilik_rayic": 59540,
            "kiralik_rayic": 527,
            "getiri": 10.62,
            "amortisman": 9.4,
            "n_sat": 75,
            "n_kir": 164
        },
        {
            "oda": "1+1",
            "satilik_rayic": 67714,
            "kiralik_rayic": 493,
            "getiri": 8.74,
            "amortisman": 11.4,
            "n_sat": 1442,
            "n_kir": 1453
        },
        {
            "oda": "2+1",
            "satilik_rayic": 56362,
            "kiralik_rayic": 421,
            "getiri": 8.97,
            "amortisman": 11.1,
            "n_sat": 5341,
            "n_kir": 2025
        },
        "… (3 öğe daha)"
    ],
    "meta": {
        "request_id": "req_d95869c0b11369e9c0de",
        "product": "market.rental_yield",
        "credits_charged": 2,
        "credits_remaining": 1499299,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 91,
        "version": "1.3.0"
    }
}
GET/public/api/v1/market/indicators3 kredi

Piyasa göstergeleri market.indicators

Noktanın mahalle / ilçe / il bağlamında çeyreklik değer ve arz değişimi, TKGM satış / ilan oranı.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
scope seçenek: auto, parsel, hex, mah, ilce, ilKapsam. Varsayılan: auto.auto
resolution seçenek: 2, 3, 4, 5, 6scope=hex için hexagon çözünürlüğü. Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/market/indicators?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/market/indicators?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "lastQ": 20263,
        "scope": "auto",
        "mah": {
            "id": 33891,
            "ad": "Atakent Mh.",
            "ilce_id": 1823,
            "ilce": "Küçükçekmece",
            "il_id": 34
        },
        "rows": [
            {
                "l": "il",
                "q": 20243,
                "n": 151677,
                "v": 49648
            },
            {
                "l": "il",
                "q": 20244,
                "n": 170594,
                "v": 55945
            },
            {
                "l": "il",
                "q": 20251,
                "n": 175342,
                "v": 60238
            },
            "… (24 öğe daha)"
        ],
        "tk": [
            {
                "l": "mah",
                "s": 1996
            },
            {
                "l": "ilce",
                "s": 10523
            },
            {
                "l": "il",
                "s": 213452
            }
        ],
        "tkYear": 2025,
        "ilan": [
            {
                "l": "mah",
                "n": 6391
            },
            {
                "l": "ilce",
                "n": 42699
            },
            {
                "l": "il",
                "n": 748668
            }
        ]
    },
    "meta": {
        "request_id": "req_fd6063bc9e0d827977bb",
        "product": "market.indicators",
        "credits_charged": 3,
        "credits_remaining": 1499296,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 550,
        "version": "1.3.0"
    }
}
GET/public/api/v1/market/competition3 kredi

Finansal derinlik ve rekabet market.competition

İlin her ilçe / mahallesi için finansal skor, son 30 gün ilan adedi, emlakçı ilanı ve tekil emlakçı sayısı (yalnız sayı).

ParametreTürAçıklamaÖrnek
level zorunlu seçenek: ilce, mahalleDüzey.ilce
province tamsayı (1–81)İl plaka kodu (İstanbul 34). Varsayılan: 34.34
curl -s "https://www.ai.tapusor.com/public/api/v1/market/competition?level=ilce" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — level ilce · province 34 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/market/competition?level=ilce&province=34
{
    "data": [
        {
            "id": 1103,
            "fin_skor": 96.3,
            "ilan_30": 100,
            "emlakci_ilan_30": 91,
            "tekil_emlakci_30": 39
        },
        {
            "id": 1166,
            "fin_skor": 99.6,
            "ilan_30": 1441,
            "emlakci_ilan_30": 1309,
            "tekil_emlakci_30": 536
        },
        {
            "id": 1183,
            "fin_skor": 99.7,
            "ilan_30": 2219,
            "emlakci_ilan_30": 2083,
            "tekil_emlakci_30": 787
        },
        "… (36 öğe daha)"
    ],
    "meta": {
        "request_id": "req_d08836cdd6501f72d739",
        "product": "market.competition",
        "credits_charged": 3,
        "credits_remaining": 1499293,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 114,
        "version": "1.3.0"
    }
}
GET/public/api/v1/market/time-on-market3 kredi

Pazarda kalma süresi market.time_on_market

Yarıçap içindeki ilanların gözlenen yayın süresi, aktif stok yaşı, fiyat indirimi oranı, yıllık trend.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
radius tamsayı (200–3000)Yarıçap (m). Varsayılan: 1000.1000
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
curl -s "https://www.ai.tapusor.com/public/api/v1/market/time-on-market?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/market/time-on-market?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010&radius=1000
{
    "data": {
        "r": 1000,
        "subcat": 10010,
        "il": 34,
        "ok": true,
        "mx": "2026-10-18",
        "n": 5127,
        "multi": 2746,
        "closed": 5006,
        "closed_multi": 2719,
        "dur_q": [
            17,
            36,
            77.5
        ],
        "active": 121,
        "active_age": 14,
        "cut_n": 979,
        "cut_med": 0.02857142857142858,
        "hist": [
            {
                "b": 0,
                "n": 576
            },
            {
                "b": 1,
                "n": 681
            },
            {
                "b": 2,
                "n": 576
            },
            "… (3 öğe daha)"
        ],
        "trend": [
            {
                "y": "2024-10-01",
                "n": 515,
                "med": 29
            },
            {
                "y": "2025-01-01",
                "n": 541,
                "med": 30
            },
            {
                "y": "2025-04-01",
                "n": 548,
                "med": 42
            },
            "… (6 öğe daha)"
        ]
    },
    "meta": {
        "request_id": "req_ac8cef17a88fdfeed156",
        "product": "market.time_on_market",
        "credits_charged": 3,
        "credits_remaining": 1499290,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 5423,
        "version": "1.3.0"
    }
}
GET/public/api/v1/sales/official2 kredi

Resmi (TKGM) satış adetleri sales.official

İlçe / mahalle bazında yıllık gerçekleşen tapu satış adetleri, işlem tipine göre (a1–a5).

ParametreTürAçıklamaÖrnek
level zorunlu seçenek: ilce, mahalleDüzey.ilce
ids zorunlu tamsayı listesiVirgülle ayrılmış ilçe / mahalle kimlikleri (en çok 500). İdari kimlik: ilçe için /v1/locations/resolve → idari_ilce, mahalle için idari_mah; hexagon için hex2–hex7 (bu uçlar TKGM kimliği kullanmaz).1186,1183
year_from tamsayı (2018–2025)Başlangıç yılı. Varsayılan: 2018.2022
year_to tamsayı (2018–2025)Bitiş yılı. Varsayılan: 2025.2025
curl -s "https://www.ai.tapusor.com/public/api/v1/sales/official?level=ilce&ids=1186%2C1183" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — level ilce (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/sales/official?level=ilce&ids=1823&year_from=2023&year_to=2025
{
    "data": [
        {
            "id": 1823,
            "y": 2023,
            "a1": 11096,
            "a2": 3712,
            "a3": 6,
            "a4": 5999,
            "a5": 1416
        },
        {
            "id": 1823,
            "y": 2024,
            "a1": 12604,
            "a2": 7822,
            "a3": 2,
            "a4": 7210,
            "a5": 1512
        },
        {
            "id": 1823,
            "y": 2025,
            "a1": 16201,
            "a2": 5698,
            "a3": 6,
            "a4": 8436,
            "a5": 2087
        }
    ],
    "meta": {
        "request_id": "req_4552c60a045ea6439715",
        "product": "sales.official",
        "credits_charged": 2,
        "credits_remaining": 1499288,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 125,
        "version": "1.3.0"
    }
}
GET/public/api/v1/scores/location1 kredi

Bölge değer skoru score.location

Konut ve arsa için bölge puanı, açıklaması ve yüzdelik dilimi.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
curl -s "https://www.ai.tapusor.com/public/api/v1/scores/location?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/scores/location?lat=41.04768437505737&lng=28.760775996083126
{
    "data": [
        {
            "tur": "Konut",
            "puan": 60,
            "puan_aciklama": "ORTA DÜZEY",
            "yuzde": 19,
            "tarih": "2026-01-24"
        },
        {
            "tur": "Arsa",
            "puan": 60,
            "puan_aciklama": "ORTA DÜZEY",
            "yuzde": 5.4,
            "tarih": "2026-01-24"
        }
    ],
    "meta": {
        "request_id": "req_4996ec8a6e6bf5441fbe",
        "product": "score.location",
        "credits_charged": 1,
        "credits_remaining": 1499328,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 130,
        "version": "1.3.0"
    }
}
GET/public/api/v1/market/yoy2 kredi

Yıllık m² değişimi market.yoy

Noktanın mahallesi ve ilçesi için son tamamlanan çeyrek ile bir yıl önceki çeyreğin medyan m² değeri ve değişimi.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10143, 10125, 10033, 10056, 10113, 10026, 10135Alt kategori. Varsayılan: 10010.10010
curl -s "https://www.ai.tapusor.com/public/api/v1/market/yoy?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/market/yoy?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "sub": 10010,
        "q": 20263,
        "pq": 20253,
        "mah": {
            "id": 33891,
            "ad": "Atakent Mh.",
            "ilce": "Küçükçekmece"
        },
        "mah_prev": {
            "v": 85278,
            "n": 1581
        },
        "mah_now": {
            "v": 104036,
            "n": 1317
        },
        "ilce_prev": {
            "v": 49326,
            "n": 10866
        },
        "ilce_now": {
            "v": 62062,
            "n": 9319
        }
    },
    "meta": {
        "request_id": "req_ecf115026cdfac699fca",
        "product": "market.yoy",
        "credits_charged": 2,
        "credits_remaining": 1499286,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 163,
        "version": "1.3.0"
    }
}

Değerleme

Konum ve özelliklere göre otomatik değer tahmini (aralık ve güven puanıyla).

GET/public/api/v1/valuation/estimate10 kredi

Otomatik değerleme valuation.estimate

Yakın ve güncel emsallerden (mesafe × ilan yaşı ağırlıklı) m² birim değer, toplam değer, alt / üst aralık ve güven puanı. Emsal ilanların kendisi dönmez.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
area_m2 sayı (10–100000)Brüt alan (m²). Boşsa parsel / bölge medyanı.120
building_age tamsayı (0–100)Bina yaşı (yıl).10
as_of_days seçenek: 0, 30, 90, 270, 365, 730, 1095Kaç gün önceki piyasaya göre (0 = bugün). Varsayılan: 0.0
rooms seçenek: 1+0, 1+1, 2+0, 2+1, 2+2, 3+0, 3+1, 3+2, 4+0, 4+1, 4+2+Oda sayısı süzgeci (ör. 2+1). Boşsa tüm oda tipleri.2+1
curl -s "https://www.ai.tapusor.com/public/api/v1/valuation/estimate?lat=41.0369&lng=28.985&subcategory=10010&area_m2=120" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 · rooms 2+1 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/valuation/estimate?lat=41.04768437505737&lng=28.760775996083126&area_m2=100&subcategory=10010&rooms=2%2B1
{
    "data": {
        "value": 6660000,
        "value_low": 5953800,
        "value_high": 7015100,
        "unit_value": 66579,
        "unit_low": 59538,
        "unit_high": 70151,
        "currency": "TRY",
        "confidence": {
            "score": 72,
            "label": "Orta",
            "components": {
                "örnek": 100,
                "yakınlık": 48,
                "tutarlılık": 68,
                "uyum": 67
            }
        },
        "comparables": {
            "candidates": 778,
            "used": 88,
            "outliers_removed": 1,
            "search_radius_m": 1000
        },
        "nearby": {
            "unit_value": 59944,
            "value": 5990000,
            "count": 5
        },
        "subject": {
            "lat": 41.047684375057,
            "lng": 28.760775996083,
            "area_m2": 100,
            "area_source": "girdi",
            "building_age": null
        },
        "as_of": "2026-10-23",
        "as_of_days": 0
    },
    "meta": {
        "request_id": "req_7efc4070c7013607f79b",
        "product": "valuation.estimate",
        "credits_charged": 10,
        "credits_remaining": 1499276,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 479,
        "version": "1.3.0"
    }
}

Resmî kayıtlar

Resmî Gazete kararları, Yargıtay kararları ve icra / ihale ilanları: arama, ayrıntı, noktaya yakın kayıtlar.

GET/public/api/v1/records/detail2 kredi

Kayıt ayrıntısı records.detail

Tek kaydın tüm alanları: tarih, tür, başlık, karar / esas no, il / ilçe / mahalle, ada / parsel, geometri; icra / ihale için ihale fiyatı, usulü, saati, alan ve nitelik. Serbest metin açıklama ve adres dönmez.

ParametreTürAçıklamaÖrnek
source zorunlu seçenek: rg, yg, icKaynak.ic
id zorunlu tamsayıKayıt kimliği (/v1/records).123456
curl -s "https://www.ai.tapusor.com/public/api/v1/records/detail?source=ic&id=123456" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — id 674125 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/records/detail?source=ic&id=674125
{
    "data": {
        "id": 674125,
        "tarih": "2026-12-21",
        "tur": null,
        "alt_tur": null,
        "baslik": "İstanbul Küçükçekmece'de Üzerinde Bina Bulunan Arsa Vasıflı Taşınmaz İcradan (25/144 HİSSESİ) Satılıktır",
        "il_adi_t": "İstanbul",
        "ilce_adi_t": "Küçükçekmece",
        "mah_adi_t": "Halkalı Merkez",
        "ada": 42,
        "parsel": 3,
        "nitelik": null,
        "alan_m2": null,
        "ihale_fiyati": null,
        "ihale_usulu": null,
        "ihale_saat": null,
        "aktif": true,
        "lat": 41.0334565,
        "lng": 28.7969282,
        "gj": {
            "type": "Polygon",
            "coordinates": "… (koordinat dizisi kısaltıldı)"
        },
        "k": "ic",
        "kaynak_adi": "İcra / ihale"
    },
    "meta": {
        "request_id": "req_df368107fb0bcf5bb09c",
        "product": "records.detail",
        "credits_charged": 2,
        "credits_remaining": 1499266,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 116,
        "version": "1.3.0"
    }
}
GET/public/api/v1/records/nearby3 kredi

Noktaya yakın kayıtlar records.nearby

Noktadaki parsel (kadastro) ve yarıçap içindeki Resmî Gazete / Yargıtay / icra kayıtları: kaynak başına toplam + en yakın 8 kayıt.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
radius tamsayı (25–1000)Yarıçap (m). Varsayılan: 150.250
sources çoklu seçim (virgülle): rg, yg, icKaynaklar. Varsayılan: rg,yg,ic.rg,yg,ic
curl -s "https://www.ai.tapusor.com/public/api/v1/records/nearby?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/records/nearby?lat=41.04768437505737&lng=28.760775996083126&radius=500
{
    "data": {
        "lat": 41.047684,
        "lng": 28.760776,
        "radius_m": 500,
        "parcel": {
            "il_adi": "İstanbul",
            "ilce_adi": "Küçükçekmece",
            "mahalle_adi": "Halkalı",
            "mahalle_id": 146060,
            "ada_no": 800,
            "parsel_no": 4,
            "nitelik": "61 blok betonamre apartman ve arsası",
            "yuzolcum": 246092.58,
            "mevkii": "Menekşe",
            "pafta": "F21c21a1b",
            "zemin_km_durum": "Kat Mülkiyet",
            "is_current": true,
            "tarih": "2026-10-22",
            "alan": 245844,
            "lat": 41.047925,
            "lng": 28.760457,
            "gj": {
                "type": "Polygon",
                "coordinates": "… (koordinat dizisi kısaltıldı)"
            }
        },
        "place": {
            "il_adi": "İstanbul",
            "ilce_adi": "Küçükçekmece",
            "mahalle_adi": "Halkalı"
        },
        "records": {
            "rg": {
                "total": 2,
                "nearest": [
                    {
                        "id": 3634,
                        "title": "Proje Uygulama Alanı · 2012/3573   İstanbul İlinde Bulunan Bazı Alanlarda Gerçekleştirilecek Proje Uygulamaları Kapsamında Çevre ve Şehirci…",
                        "date": "2012-09-08",
                        "distance_m": 0
                    },
                    {
                        "id": 547109,
                        "title": "Acele Kamulaştırma · ––  Halkalı-Çerkezköy Yüksek Standartlı Demiryolu Projesinin Belirlenen İş Programına ve Taahhüt Edilen Sürelere Uygun…",
                        "date": "2021-08-06",
                        "distance_m": 435
                    }
                ]
            },
            "yg": {
                "total": 24,
                "nearest": [
                    {
                        "id": 323962,
                        "title": "Yargıtay 12. Hukuk Dairesi · 2014/17487",
                        "date": "2014-06-17",
                        "distance_m": 0
                    },
                    {
                        "id": 492496,
                        "title": "Yargıtay 5. Hukuk Dairesi · 2025/2618",
                        "date": "2025-02-26",
                        "distance_m": 234
                    },
                    {
                        "id": 256417,
                        "title": "Yargıtay 5. Hukuk Dairesi · 2022/3039",
                        "date": "2022-02-24",
                        "distance_m": 351
                    },
                    "… (5 öğe daha)"
                ]
            },
            "ic": {
                "total": 1,
                "nearest": [
                    {
                        "id": 666913,
                        "title": "İstanbul Küçükçekmece'de brüt 160 m² daire icradan satılıktır",
                        "date": "2026-10-19",
                        "distance_m": 431
                    }
                ]
            }
        }
    },
    "meta": {
        "request_id": "req_f82cf22a47326876e541",
        "product": "records.nearby",
        "credits_charged": 3,
        "credits_remaining": 1499263,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 180,
        "version": "1.3.0"
    }
}

Teknik analiz ve risk

Parsel bazında 70'ten fazla teknik / hukuki kontrol, bileşik risk skoru, haber / şikâyet yoğunluğu.

GET/public/api/v1/risk/score8 kredi

Bileşik risk skoru risk.score

Fay, heyelan, sit, orman, kamulaştırma, su havzası, mera, ova koruma … kontrollerinden ağırlıklı 0–100 risk puanı, seviye ve bayraklar; imar fonksiyonu, zemin, e-Plan planları.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
curl -s "https://www.ai.tapusor.com/public/api/v1/risk/score?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/risk/score?lat=41.04768437505737&lng=28.760775996083126
{
    "data": {
        "skor": 35,
        "seviye": "Yüksek",
        "bayrak": [
            {
                "no": 2,
                "ad": "Zemin deprem puanı düşük (10/100)",
                "tur": "risk",
                "puan": 15,
                "msg": "Dikkat! Deprem puanı kötü (10/100 puan)"
            },
            {
                "no": 9,
                "ad": "Resmî Gazete kararı kapsamı",
                "tur": "risk",
                "puan": 10,
                "msg": "Proje Uygulama Alanında bulunmaktadır."
            },
            {
                "no": 17,
                "ad": "Mega proje alanı",
                "tur": "bilgi",
                "puan": 0,
                "msg": "Istanbul Saraylari alanında bulunmaktadır."
            },
            "… (2 öğe daha)"
        ],
        "imar": false,
        "aski": {
            "var": false,
            "m": null,
            "msg": "Seçili parselin 1000 metre çevresinde askı sürecinde plan kaydı bulunmamaktadır."
        },
        "zemin": {
            "puan": 10,
            "metin": "Dikkat! Deprem puanı kötü (10/100 puan)"
        },
        "planlar": [],
        "kontrol": 27,
        "eksik": 0
    },
    "meta": {
        "request_id": "req_1d89bf8d008b143237a2",
        "product": "risk.score",
        "credits_charged": 8,
        "credits_remaining": 1499320,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 1703,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/summary5 kredi

Parsel teknik özeti technical.summary

Parseldeki ilanların teknik kontrol bayrakları (deprem, fay, heyelan, sit, orman, gürültü, havza …), katman ayrıntıları ve deprem puanı ortalaması. İlanlar listelenmez. Şimdilik yalnız İstanbul; Türkiye geneli için /v1/technical/controls.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/summary?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/summary?lat=41.04768437505737&lng=28.760775996083126
{
    "data": {
        "src": "parsel",
        "n": 40,
        "agg": {
            "earthquake": [
                0,
                40
            ],
            "fay": [
                0,
                40
            ],
            "landslide": [
                0,
                40
            ],
            "basin": [
                0,
                40
            ],
            "sulak_alan": [
                0,
                40
            ],
            "forest": [
                0,
                40
            ],
            "mera": [
                0,
                40
            ],
            "ekilebilir_arazi": [
                0,
                40
            ],
            "heterojen_tarim": [
                0,
                40
            ],
            "kalici_mahsul": [
                0,
                40
            ],
            "protection": [
                0,
                40
            ],
            "seaflag": [
                0,
                0
            ],
            "bogaz": [
                0,
                40
            ],
            "havamania": [
                0,
                40
            ],
            "osb": [
                0,
                40
            ],
            "development_plan": [
                0,
                40
            ],
            "alteration_plan": [
                0,
                40
            ],
            "plan_change": [
                0,
                0
            ],
            "renovation": [
                0,
                40
            ],
            "urbantransformation": [
                0,
                40
            ],
            "expropriation": [
                0,
                40
            ],
            "cadastral": [
                0,
                40
            ],
            "icra": [
                0,
                40
            ],
            "ihale": [
                0,
                40
            ],
            "news": [
                0,
                0
            ],
            "u_kds": [
                0,
                0
            ],
            "u_tgb": [
                0,
                0
            ],
            "u_kyd": [
                0,
                0
            ],
            "u_afet": [
                0,
                0
            ],
            "u_oeb": [
                0,
                0
            ],
            "u_pua": [
                0,
                0
            ]
        },
        "det": [],
        "eq": null
    },
    "meta": {
        "request_id": "req_8132e4ecb8e7a8a7793c",
        "product": "technical.summary",
        "credits_charged": 5,
        "credits_remaining": 1499315,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 3487,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls10 kredi

Teknik kontroller technical.controls

Seçilen teknik / hukuki kontrolleri (en çok 12) noktada çalıştırır: fay, heyelan, sit, orman, kamulaştırma, kentsel dönüşüm, OSB, tarım, enerji hatları … Kontrol listesi: /v1/products → technical_controls.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
controls zorunlu tamsayı listesi (1–77)Kontrol numaraları (virgülle, en çok 12).1,3,6,7,8
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü. Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls?lat=41.0369&lng=28.985&controls=1%2C3%2C6%2C7%2C8&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls?lat=41.04768437505737&lng=28.760775996083126&controls=1%2C3%2C6%2C7%2C8%2C14&subcategory=10010
{
    "data": {
        "q": [
            1,
            3,
            6,
            "… (3 öğe daha)"
        ],
        "items": [
            {
                "id": 1,
                "no": 6,
                "data": {
                    "protected": {
                        "id": 943,
                        "msg": {
                            "en": "This location isn't in the Protected area.",
                            "tr": "Sit alanında değildir.",
                            "key": "protected_status_false"
                        },
                        "sira": 6,
                        "title": {
                            "en": "Protected Area",
                            "tr": "Sit Alanı",
                            "key": "protected_title"
                        },
                        "status": "false",
                        "distance": 1436
                    }
                },
                "desc": "Kültürel, tarihi ya da doğal koruma statüsündeki alanları belirtir. Yapılaşma ve kullanım kısıtları çok sert olabilir.",
                "group": "Kritik Risk & Yasal Durum",
                "title": "Sit Alanı"
            },
            {
                "id": 1,
                "no": 7,
                "data": {
                    "forest": {
                        "id": 941,
                        "msg": {
                            "en": "This location isn't in the forest area.",
                            "tr": "Orman alanında değildir.",
                            "key": "forestarea_status_false"
                        },
                        "title": {
                            "en": "Forest Area",
                            "tr": "Orman Alanı",
                            "key": "forestarea_title"
                        },
                        "status": "false",
                        "distance": null
                    }
                },
                "desc": "Orman vasfı taşıyan veya ormanla ilişkili alanları ifade eder. Tasarruf ve geliştirme açısından ciddi kısıt doğurabilir.",
                "group": "Kritik Risk & Yasal Durum",
                "title": "Orman Alanı"
            },
            {
                "id": 1,
                "no": 8,
                "data": {
                    "expropriation": {
                        "id": 933,
                        "msg": {
                            "en": "This location isn't in the expropriation area.",
                            "tr": "Kamulaştırma alanında değildir.",
                            "key": "expropriation_status_false"
                        },
                        "sira": 8,
                        "title": {
                            "en": "Expropration",
                            "tr": "Kamulaştırma Alanı",
                            "key": "expropriation_title"
                        },
                        "status": "false",
                        "distance": 436
                    }
                },
                "desc": "Kamu tarafından el koyma veya proje kapsamına girme riski bulunan alanları ifade eder. Mülkiyet güvenliği açısından çok önemlidir.",
                "group": "Kritik Risk & Yasal Durum",
                "title": "Kamulaştırma Alanı"
            },
            "… (3 öğe daha)"
        ]
    },
    "meta": {
        "request_id": "req_a4a2a5b5cb3724c2e958",
        "product": "technical.controls",
        "credits_charged": 10,
        "credits_remaining": 1499253,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 168,
        "version": "1.3.0"
    }
}
GET/public/api/v1/news/summary2 kredi

Haber ve şikâyet yoğunluğu news.summary

1 km içindeki haber / şikâyet kayıtlarının sınıf ve mesafe bandına göre adetleri (metinler dönmez).

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
curl -s "https://www.ai.tapusor.com/public/api/v1/news/summary?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/news/summary?lat=41.04768437505737&lng=28.760775996083126
{
    "data": {
        "total": 25,
        "note": "En yakın 25 kayıt üzerinden; bantlar birikimsizdir.",
        "by_class": {
            "diğer": {
                "250m": 0,
                "500m": 2,
                "1000m": 21,
                "total": 23
            },
            "Terrorism and Bombing": {
                "250m": 0,
                "500m": 0,
                "1000m": 2,
                "total": 2
            }
        }
    },
    "meta": {
        "request_id": "req_539c0ea27e962437819a",
        "product": "news.summary",
        "credits_charged": 2,
        "credits_remaining": 1499313,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 139,
        "version": "1.3.0"
    }
}

Kontrol · Kritik risk ve yasal durum

Tekil teknik kontroller: fay, zemin, heyelan, havza, sit, orman, kamulaştırma, ova koruma …

GET/public/api/v1/technical/controls/fay-hatti2 kredi

Fay Hattı control.fay_hatti

Parselin aktif ya da riskli fay zonlarına yakınlığını gösterir. Yapılaşma ve sigorta algısı açısından kritik risktir. (Teknik kontrol no 1.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/fay-hatti?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/fay-hatti?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 1,
        "name": "Fay Hattı",
        "group": "Kritik Risk & Yasal Durum",
        "description": "Parselin aktif ya da riskli fay zonlarına yakınlığını gösterir. Yapılaşma ve sigorta algısı açısından kritik risktir.",
        "result": {
            "fault": {
                "id": 920,
                "msg": {
                    "en": "This location isn't in the Fault Line area.",
                    "tr": "Fay Hattı alanında değildir.",
                    "key": "fault_status_false"
                },
                "sira": 1,
                "title": {
                    "en": "fault Area",
                    "tr": "Fay Hattı",
                    "key": "fault_title"
                },
                "status": "false",
                "distance": null
            }
        }
    },
    "meta": {
        "request_id": "req_4db857ba9a371a142692",
        "product": "control.fay_hatti",
        "credits_charged": 2,
        "credits_remaining": 1499236,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 134,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/zemin-deprem-puani2 kredi

Zemin Deprem Puanı control.zemin_deprem_puani

Zeminin deprem davranışı ve taşıma güvenliği açısından genel risk puanıdır. Özellikle proje geliştirmede ilk filtrelerden biridir. (Teknik kontrol no 2.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/zemin-deprem-puani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/zemin-deprem-puani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 2,
        "name": "Zemin Deprem Puanı",
        "group": "Kritik Risk & Yasal Durum",
        "description": "Zeminin deprem davranışı ve taşıma güvenliği açısından genel risk puanıdır. Özellikle proje geliştirmede ilk filtrelerden biridir.",
        "result": {
            "ground_score": {
                "id": 953,
                "msg": {
                    "en": "Ground Earthquake Score found.",
                    "tr": "Zemin Deprem puanı bulunmaktadır.",
                    "key": "ground_status_false"
                },
                "kadi": "Dikkat! Deprem puanı kötü (10/100 puan)",
                "sira": 2,
                "title": {
                    "en": "Ground Earthquake Score",
                    "tr": "Zemin Deprem Puanı",
                    "key": "ground_title"
                },
                "status": true,
                "distance": 0
            }
        }
    },
    "meta": {
        "request_id": "req_479cf048ca80de7d7ac1",
        "product": "control.zemin_deprem_puani",
        "credits_charged": 2,
        "credits_remaining": 1499234,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 159,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/heyelan-alani2 kredi

Heyelan Alanı control.heyelan_alani

Toprak kayması riski taşıyan bölgeleri gösterir. İnşaat maliyeti ve güvenlik açısından çok kritiktir. (Teknik kontrol no 3.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/heyelan-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/heyelan-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 3,
        "name": "Heyelan Alanı",
        "group": "Kritik Risk & Yasal Durum",
        "description": "Toprak kayması riski taşıyan bölgeleri gösterir. İnşaat maliyeti ve güvenlik açısından çok kritiktir.",
        "result": {
            "landslide": {
                "id": 923,
                "msg": {
                    "en": "This location isn't in the Landslide area.",
                    "tr": "Heyelan alanında değildir.",
                    "key": "landslide_status_false"
                },
                "sira": 3,
                "title": {
                    "en": "Landslide Area",
                    "tr": "Heyelan Alanı",
                    "key": "landslide_title"
                },
                "status": "false",
                "distance": 2585
            }
        }
    },
    "meta": {
        "request_id": "req_f9198f93d8acd5b77154",
        "product": "control.heyelan_alani",
        "credits_charged": 2,
        "credits_remaining": 1499232,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 142,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/su-havzasi-alani2 kredi

Su Havzası Alanı control.su_havzasi_alani

İçme suyu veya havza koruma sınırlarında kalan alanları gösterir. İnşaat ve kullanım izinleri sınırlanabilir. (Teknik kontrol no 4.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/su-havzasi-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/su-havzasi-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 4,
        "name": "Su Havzası Alanı",
        "group": "Kritik Risk & Yasal Durum",
        "description": "İçme suyu veya havza koruma sınırlarında kalan alanları gösterir. İnşaat ve kullanım izinleri sınırlanabilir.",
        "result": {
            "waterBasin": {
                "id": 922,
                "msg": {
                    "en": "This location isn't in the Water Basin area.",
                    "tr": "Su Havzası alanında değildir.",
                    "key": "waterbasinarea_status_false"
                },
                "sira": 4,
                "title": {
                    "en": "Water Basin Area",
                    "tr": "Su Havzası Alanı",
                    "key": "waterbasinarea_title"
                },
                "status": "false",
                "distance": 7134
            }
        }
    },
    "meta": {
        "request_id": "req_d791274e1e24c6aac2f8",
        "product": "control.su_havzasi_alani",
        "credits_charged": 2,
        "credits_remaining": 1499230,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 141,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/sulak-alan2 kredi

Sulak Alan control.sulak_alan

Ekolojik koruma altında olabilecek sulak bölgeleri ifade eder. Geliştirme kabiliyeti düşebilir. (Teknik kontrol no 5.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/sulak-alan?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/sulak-alan?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 5,
        "name": "Sulak Alan",
        "group": "Kritik Risk & Yasal Durum",
        "description": "Ekolojik koruma altında olabilecek sulak bölgeleri ifade eder. Geliştirme kabiliyeti düşebilir.",
        "result": {
            "wetland": {
                "id": 946,
                "msg": {
                    "en": "This location isn't in the Wetland.",
                    "tr": "Sulak alanda değildir.",
                    "key": "wetland_status_false"
                },
                "sira": 5,
                "title": {
                    "en": "Protected Area",
                    "tr": "Sulak Alan",
                    "key": "wetland_title"
                },
                "status": "false",
                "distance": 1081
            }
        }
    },
    "meta": {
        "request_id": "req_e5883972a7135e0f2f22",
        "product": "control.sulak_alan",
        "credits_charged": 2,
        "credits_remaining": 1499228,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 144,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/sit-alani2 kredi

Sit Alanı control.sit_alani

Kültürel, tarihi ya da doğal koruma statüsündeki alanları belirtir. Yapılaşma ve kullanım kısıtları çok sert olabilir. (Teknik kontrol no 6.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/sit-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/sit-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 6,
        "name": "Sit Alanı",
        "group": "Kritik Risk & Yasal Durum",
        "description": "Kültürel, tarihi ya da doğal koruma statüsündeki alanları belirtir. Yapılaşma ve kullanım kısıtları çok sert olabilir.",
        "result": {
            "protected": {
                "id": 943,
                "msg": {
                    "en": "This location isn't in the Protected area.",
                    "tr": "Sit alanında değildir.",
                    "key": "protected_status_false"
                },
                "sira": 6,
                "title": {
                    "en": "Protected Area",
                    "tr": "Sit Alanı",
                    "key": "protected_title"
                },
                "status": "false",
                "distance": 1436
            }
        }
    },
    "meta": {
        "request_id": "req_309629ba20954fee42b3",
        "product": "control.sit_alani",
        "credits_charged": 2,
        "credits_remaining": 1499226,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 145,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/orman-alani2 kredi

Orman Alanı control.orman_alani

Orman vasfı taşıyan veya ormanla ilişkili alanları ifade eder. Tasarruf ve geliştirme açısından ciddi kısıt doğurabilir. (Teknik kontrol no 7.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/orman-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/orman-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 7,
        "name": "Orman Alanı",
        "group": "Kritik Risk & Yasal Durum",
        "description": "Orman vasfı taşıyan veya ormanla ilişkili alanları ifade eder. Tasarruf ve geliştirme açısından ciddi kısıt doğurabilir.",
        "result": {
            "forest": {
                "id": 941,
                "msg": {
                    "en": "This location isn't in the forest area.",
                    "tr": "Orman alanında değildir.",
                    "key": "forestarea_status_false"
                },
                "title": {
                    "en": "Forest Area",
                    "tr": "Orman Alanı",
                    "key": "forestarea_title"
                },
                "status": "false",
                "distance": null
            }
        }
    },
    "meta": {
        "request_id": "req_be08bb3b6695e5afff3e",
        "product": "control.orman_alani",
        "credits_charged": 2,
        "credits_remaining": 1499224,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 133,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/kamulastirma-alani2 kredi

Kamulaştırma Alanı control.kamulastirma_alani

Kamu tarafından el koyma veya proje kapsamına girme riski bulunan alanları ifade eder. Mülkiyet güvenliği açısından çok önemlidir. (Teknik kontrol no 8.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/kamulastirma-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/kamulastirma-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 8,
        "name": "Kamulaştırma Alanı",
        "group": "Kritik Risk & Yasal Durum",
        "description": "Kamu tarafından el koyma veya proje kapsamına girme riski bulunan alanları ifade eder. Mülkiyet güvenliği açısından çok önemlidir.",
        "result": {
            "expropriation": {
                "id": 933,
                "msg": {
                    "en": "This location isn't in the expropriation area.",
                    "tr": "Kamulaştırma alanında değildir.",
                    "key": "expropriation_status_false"
                },
                "sira": 8,
                "title": {
                    "en": "Expropration",
                    "tr": "Kamulaştırma Alanı",
                    "key": "expropriation_title"
                },
                "status": "false",
                "distance": 436
            }
        }
    },
    "meta": {
        "request_id": "req_3ec57844da5e3f1d040a",
        "product": "control.kamulastirma_alani",
        "credits_charged": 2,
        "credits_remaining": 1499222,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 162,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/resmi-gazete-karari-kapsamindaki-alan2 kredi

Resmî Gazete Kararı Kapsamındaki Alan control.resmi_gazete_karari_kapsamindaki_alan

Merkezi idare kararıyla özel hükümlere tabi olabilecek alanları gösterir. Ani statü değişimi yaratabilir. (Teknik kontrol no 9.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/resmi-gazete-karari-kapsamindaki-alan?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/resmi-gazete-karari-kapsamindaki-alan?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 9,
        "name": "Resmî Gazete Kararı Kapsamındaki Alan",
        "group": "Kritik Risk & Yasal Durum",
        "description": "Merkezi idare kararıyla özel hükümlere tabi olabilecek alanları gösterir. Ani statü değişimi yaratabilir.",
        "result": {
            "rgazete": {
                "id": 879,
                "msg": {
                    "en": "This location is in the Official Gazette decision area.",
                    "tr": "Proje Uygulama Alanında bulunmaktadır.",
                    "key": "rgazete_false"
                },
                "sira": 9,
                "title": {
                    "en": "Official Gazette Decision Area",
                    "tr": "Resmî Gazete Kararı Kapsamındaki Alan",
                    "key": "rgazete"
                },
                "status": true,
                "distance": 0
            }
        }
    },
    "meta": {
        "request_id": "req_8c5e2a7d8e7af49a5119",
        "product": "control.resmi_gazete_karari_kapsamindaki_alan",
        "credits_charged": 2,
        "credits_remaining": 1499220,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 139,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/ova-koruma-alani2 kredi

Ova Koruma Alanı control.ova_koruma_alani

Tarımsal niteliği korunması gereken ovaları gösterir. Amaç dışı kullanım zorlaşabilir. (Teknik kontrol no 10.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/ova-koruma-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/ova-koruma-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 10,
        "name": "Ova Koruma Alanı",
        "group": "Kritik Risk & Yasal Durum",
        "description": "Tarımsal niteliği korunması gereken ovaları gösterir. Amaç dışı kullanım zorlaşabilir.",
        "result": {
            "protected_plain": {
                "id": 868,
                "msg": {
                    "en": "This location isn't in the Protected Plain area.",
                    "tr": "Ova Koruma alanında değildir.",
                    "key": "protected_plain_false"
                },
                "sira": 10,
                "title": {
                    "en": "Protected Plain Area",
                    "tr": "Ova Koruma  Alanı",
                    "key": "protected_plain"
                },
                "status": "false",
                "distance": null
            }
        }
    },
    "meta": {
        "request_id": "req_50d8a0b1af7b0474bc04",
        "product": "control.ova_koruma_alani",
        "credits_charged": 2,
        "credits_remaining": 1499218,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 143,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/sorgu-disi-alan2 kredi

Sorgu Dışı Alan control.sorgu_disi_alan

Sistemsel veya hukuki sebeple standart sorgu kapsamına (askeri bölgeler, su yüzeyleri, park alanları vb.) girmeyen alanlardır. Belirsizlik içerdiği için yatırımcı açısından kırmızı bayraktır. (Teknik kontrol no 11.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/sorgu-disi-alan?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/sorgu-disi-alan?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 11,
        "name": "Sorgu Dışı Alan",
        "group": "Kritik Risk & Yasal Durum",
        "description": "Sistemsel veya hukuki sebeple standart sorgu kapsamına (askeri bölgeler, su yüzeyleri, park alanları vb.) girmeyen alanlardır. Belirsizlik içerdiği için yatırımcı açısından kırmızı bayraktır.",
        "result": {
            "sorgu_disi": {
                "id": 863,
                "msg": {
                    "en": "This location isn't in the Restricted area.",
                    "tr": "Sorgu dışı alanda değildir.",
                    "key": "sorgu_disi_false"
                },
                "sira": 11,
                "title": {
                    "en": "Restricted Area",
                    "tr": "Sorgu Dışı Alan",
                    "key": "sorgu_disi"
                },
                "status": "false",
                "distance": 961
            }
        }
    },
    "meta": {
        "request_id": "req_fb2623d3457887b2c51b",
        "product": "control.sorgu_disi_alan",
        "credits_charged": 2,
        "credits_remaining": 1499216,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 480,
        "version": "1.3.0"
    }
}

Kontrol · İmar hakları

Tekil kontroller: imar planı, askıdaki plan, kentsel dönüşüm, yenileme, plan tadilatı, mega proje, toplulaştırma, kadastro.

GET/public/api/v1/technical/controls/imar-plani2 kredi

İmar Planı control.imar_plani

Parselin ne şekilde kullanılabileceğini gösteren temel plan verisidir. Değer üretiminin ana belirleyicisidir. (Teknik kontrol no 12.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/imar-plani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/imar-plani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 12,
        "name": "İmar Planı",
        "group": "İmar(Mevcut ve Gelecekteki Haklar)",
        "description": "Parselin ne şekilde kullanılabileceğini gösteren temel plan verisidir. Değer üretiminin ana belirleyicisidir.",
        "result": {
            "dev_plan": {
                "id": 896,
                "msg": {
                    "en": "It is not located in an area with a zoning plan.",
                    "tr": "İmar planı bulunan alanda yer almamaktadır.",
                    "key": "dev_plan_false"
                },
                "sira": 12,
                "title": {
                    "en": "Development Plan",
                    "tr": "İmar Planı",
                    "key": "dev_plan"
                },
                "status": "false"
            }
        }
    },
    "meta": {
        "request_id": "req_edb27309cf447fb788b5",
        "product": "control.imar_plani",
        "credits_charged": 2,
        "credits_remaining": 1499214,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 160,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/yerlesim-alani2 kredi

Yerleşim Alanı control.yerlesim_alani

Mevcut veya planlı yerleşim düzeni içinde kalan bölgeleri gösterir. Oturum ve talep açısından olumlu sinyaldir. (Teknik kontrol no 13.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/yerlesim-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/yerlesim-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 13,
        "name": "Yerleşim Alanı",
        "group": "İmar(Mevcut ve Gelecekteki Haklar)",
        "description": "Mevcut veya planlı yerleşim düzeni içinde kalan bölgeleri gösterir. Oturum ve talep açısından olumlu sinyaldir.",
        "result": {
            "residential": {
                "id": 867,
                "msg": {
                    "en": "This location is in the Residential area.",
                    "tr": "İskan alanında bulunmaktadır.",
                    "key": "residential_false"
                },
                "sira": 13,
                "title": {
                    "en": "Residential Area",
                    "tr": "Yerleşim Alanı",
                    "key": "residential"
                },
                "status": true,
                "distance": 0,
                "residential": "İskan"
            }
        }
    },
    "meta": {
        "request_id": "req_6c3ca89b8e89d12546bf",
        "product": "control.yerlesim_alani",
        "credits_charged": 2,
        "credits_remaining": 1499212,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 164,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/kentsel-donusum-alani2 kredi

Kentsel Dönüşüm Alanı control.kentsel_donusum_alani

Dönüşüm kapsamına alınmış bölgeleri ifade eder. Yüksek potansiyel kadar uygulama riski de içerir. (Teknik kontrol no 14.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/kentsel-donusum-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/kentsel-donusum-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 14,
        "name": "Kentsel Dönüşüm Alanı",
        "group": "İmar(Mevcut ve Gelecekteki Haklar)",
        "description": "Dönüşüm kapsamına alınmış bölgeleri ifade eder. Yüksek potansiyel kadar uygulama riski de içerir.",
        "result": {
            "transformation": {
                "id": 937,
                "msg": {
                    "en": "This location isn't in the transformation area.",
                    "tr": "Kentsel Dönüşüm alanında değildir.",
                    "key": "transformation_status_false"
                },
                "sira": 14,
                "title": {
                    "en": "Transformation Area",
                    "tr": "Kentsel Dönüşüm Alanı",
                    "key": "transformation_title"
                },
                "status": "false",
                "distance": 2397
            }
        }
    },
    "meta": {
        "request_id": "req_9e37e7c0a4077fcf6f7d",
        "product": "control.kentsel_donusum_alani",
        "credits_charged": 2,
        "credits_remaining": 1499210,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 154,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/yenileme-alani2 kredi

Yenileme Alanı control.yenileme_alani

Özellikle eski yerleşimlerde yenileme ve yeniden geliştirme odaklı alanlardır. Proje fırsatı yaratabilir. (Teknik kontrol no 15.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/yenileme-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/yenileme-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 15,
        "name": "Yenileme Alanı",
        "group": "İmar(Mevcut ve Gelecekteki Haklar)",
        "description": "Özellikle eski yerleşimlerde yenileme ve yeniden geliştirme odaklı alanlardır. Proje fırsatı yaratabilir.",
        "result": {
            "renewal": {
                "id": 951,
                "msg": {
                    "en": "This location isn't in the renewal area.",
                    "tr": "Yenileme alanında değildir.",
                    "key": "renewal_status_false"
                },
                "sira": 15,
                "title": {
                    "en": "Renewal Area",
                    "tr": "Yenileme Alanı",
                    "key": "renewal_title"
                },
                "status": "false",
                "distance": null
            }
        }
    },
    "meta": {
        "request_id": "req_2fe79ba6881f29107c00",
        "product": "control.yenileme_alani",
        "credits_charged": 2,
        "credits_remaining": 1499208,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 149,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/plan-tadilat-alani2 kredi

Plan Tadilat Alanı control.plan_tadilat_alani

Plan değişikliği yapılmış veya yapılmakta olan bölgeleri gösterir. (Teknik kontrol no 16.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/plan-tadilat-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/plan-tadilat-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 16,
        "name": "Plan Tadilat Alanı",
        "group": "İmar(Mevcut ve Gelecekteki Haklar)",
        "description": "Plan değişikliği yapılmış veya yapılmakta olan bölgeleri gösterir.",
        "result": {
            "plan_tadilat": {
                "id": 866,
                "msg": {
                    "en": "This location isn't in the Zoning Plan Amendment area.",
                    "tr": "Plan tadilat alanı kapsamında değildir.",
                    "key": "plan_tadilat_false"
                },
                "sira": 16,
                "title": {
                    "en": "Zoning Plan Amendment Area",
                    "tr": "Plan Tadilat Alanı",
                    "key": "plan_tadilat"
                },
                "status": "false",
                "distance": 546
            }
        }
    },
    "meta": {
        "request_id": "req_39bfb7bcaf602d6cb3dd",
        "product": "control.plan_tadilat_alani",
        "credits_charged": 2,
        "credits_remaining": 1499206,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 211,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/mega-projeler-alani2 kredi

Mega Projeler Alanı (İstanbul) control.mega_projeler_alani

Büyük kamu veya özel ölçekli projelerin etkilediği alanlardır. (Teknik kontrol no 17.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/mega-projeler-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/mega-projeler-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 17,
        "name": "Mega Projeler Alanı (İstanbul)",
        "group": "İmar(Mevcut ve Gelecekteki Haklar)",
        "description": "Büyük kamu veya özel ölçekli projelerin etkilediği alanlardır.",
        "result": {
            "megapro": {
                "id": 869,
                "msg": {
                    "en": "This location is in the Mega Projects area.",
                    "tr": "Istanbul Saraylari alanında bulunmaktadır.",
                    "key": "megapro_false"
                },
                "sira": 17,
                "title": {
                    "en": "Mega Projects Area",
                    "tr": "Mega Projeler Alanı",
                    "key": "megapro"
                },
                "status": true,
                "megapro": "Istanbul Saraylari",
                "distance": 0
            }
        }
    },
    "meta": {
        "request_id": "req_5da7a3f0313f6522d1f7",
        "product": "control.mega_projeler_alani",
        "credits_charged": 2,
        "credits_remaining": 1499204,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 147,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/arazi-toplulastirma-alani2 kredi

Arazi Toplulaştırma Alanı control.arazi_toplulastirma_alani

Tarımsal parsellerin yeniden düzenlendiği alanları gösterir. Özellikle kırsal yatırımda önemlidir. (Teknik kontrol no 18.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/arazi-toplulastirma-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/arazi-toplulastirma-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 18,
        "name": "Arazi Toplulaştırma Alanı",
        "group": "İmar(Mevcut ve Gelecekteki Haklar)",
        "description": "Tarımsal parsellerin yeniden düzenlendiği alanları gösterir. Özellikle kırsal yatırımda önemlidir.",
        "result": {
            "arazi_top": {
                "id": 870,
                "msg": {
                    "en": "This location isn't in the Land Consolidation area.",
                    "tr": "Arazi Toplulaştırma alanında değildir.",
                    "key": "arazi_top_false"
                },
                "sira": 18,
                "title": {
                    "en": "Land Consolidation Area",
                    "tr": "Arazi Toplulaştırma Alanı",
                    "key": "arazi_top"
                },
                "status": "false",
                "distance": null
            }
        }
    },
    "meta": {
        "request_id": "req_4141567051767032d254",
        "product": "control.arazi_toplulastirma_alani",
        "credits_charged": 2,
        "credits_remaining": 1499202,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 180,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/parsel-degisikligi-yapilan-alan2 kredi

Parsel Değişikliği Yapılan Alan control.parsel_degisikligi_yapilan_alan

Parsel yapısı sonradan değişmiş bölgeleri ifade eder. Tapu ve sınır okumalarında dikkat gerektirir. (Teknik kontrol no 19.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/parsel-degisikligi-yapilan-alan?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/parsel-degisikligi-yapilan-alan?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 19,
        "name": "Parsel Değişikliği Yapılan Alan",
        "group": "İmar(Mevcut ve Gelecekteki Haklar)",
        "description": "Parsel yapısı sonradan değişmiş bölgeleri ifade eder. Tapu ve sınır okumalarında dikkat gerektirir.",
        "result": {
            "parcel_change": {
                "id": 874,
                "msg": {
                    "en": "This location isn't in the Parcel Change area.",
                    "tr": "Parsel değişikliği yapılan alanda değildir.",
                    "key": "parcel_change_false"
                },
                "sira": 19,
                "title": {
                    "en": "Parcel Change Area",
                    "tr": "Parsel Değişikliği Yapılan Alan",
                    "key": "parcel_change"
                },
                "status": "false",
                "distance": 1082
            }
        }
    },
    "meta": {
        "request_id": "req_0ba8cf1176fb30613645",
        "product": "control.parsel_degisikligi_yapilan_alan",
        "credits_charged": 2,
        "credits_remaining": 1499200,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 673,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/kadastro-alani2 kredi

Kadastro Alanı control.kadastro_alani

Kadastro verisi ve parsel sınırlarıyla ilgili katmandır. Mülkiyet doğrulaması için temel referanstır. (Teknik kontrol no 20.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/kadastro-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/kadastro-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 20,
        "name": "Kadastro Alanı",
        "group": "İmar(Mevcut ve Gelecekteki Haklar)",
        "description": "Kadastro verisi ve parsel sınırlarıyla ilgili katmandır. Mülkiyet doğrulaması için temel referanstır.",
        "result": {
            "cadastral": {
                "id": 877,
                "msg": {
                    "en": "This location is in the Cadastral area.",
                    "tr": "Kadastro alanında bulunmaktadır.",
                    "key": "cadastral_false"
                },
                "sira": 20,
                "title": {
                    "en": "Cadastral Area",
                    "tr": "Kadastro Alanı",
                    "key": "cadastral"
                },
                "status": true,
                "distance": null
            }
        }
    },
    "meta": {
        "request_id": "req_ad6224bb59bc0ec1da89",
        "product": "control.kadastro_alani",
        "credits_charged": 2,
        "credits_remaining": 1499198,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 145,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/askidaki-plan2 kredi

Askıdaki Plan control.askidaki_plan

İlgili parsele ait askı sürecindeki imar planı bilgisini gösterir. Planın kesinleşmemiş mevcut durumunu ve olası kullanım kararlarını içerir. (Teknik kontrol no 77.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/askidaki-plan?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/askidaki-plan?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 77,
        "name": "Askıdaki Plan",
        "group": "İmar(Mevcut ve Gelecekteki Haklar)",
        "description": "İlgili parsele ait askı sürecindeki imar planı bilgisini gösterir. Planın kesinleşmemiş mevcut durumunu ve olası kullanım kararlarını içerir.",
        "result": {
            "aski_plan": {
                "id": 896,
                "msg": {
                    "en": "There is no pending zoning plan record within 1000 meters of the selected parcel.",
                    "tr": "Seçili parselin 1000 metre çevresinde askı sürecinde plan kaydı bulunmamaktadır.",
                    "key": "aski_plan_false"
                },
                "sira": 12,
                "title": {
                    "en": "Pending Zoning Plan",
                    "tr": "Askıdaki Plan",
                    "key": "aski_plan"
                },
                "status": "false"
            }
        }
    },
    "meta": {
        "request_id": "req_8d21444873babae199e5",
        "product": "control.askidaki_plan",
        "credits_charged": 2,
        "credits_remaining": 1499096,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 370,
        "version": "1.3.0"
    }
}

Kontrol · Tarım ve doğal kullanım

Tekil kontroller: ekilebilir, kalıcı mahsul, mera, heterojen tarım alanı.

GET/public/api/v1/technical/controls/ekilebilir-alan2 kredi

Ekilebilir Alan control.ekilebilir_alan

Tarımsal üretime uygun alanları gösterir. Tarla yatırımında temel kriterdir. (Teknik kontrol no 52.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/ekilebilir-alan?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/ekilebilir-alan?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 52,
        "name": "Ekilebilir Alan",
        "group": "Tarım & Doğal Kullanım Sınıfları",
        "description": "Tarımsal üretime uygun alanları gösterir. Tarla yatırımında temel kriterdir.",
        "result": {
            "arable_land": {
                "id": 947,
                "msg": {
                    "en": "This location isn't in the Arable Land.",
                    "tr": "Ekilebilir alanda değildir.",
                    "key": "arable_status_false"
                },
                "sira": 52,
                "title": {
                    "en": "Protected Area",
                    "tr": "Ekilebilir Alan",
                    "key": "arable_title"
                },
                "status": "false",
                "distance": 783
            }
        }
    },
    "meta": {
        "request_id": "req_c159aec036bc16c2b08d",
        "product": "control.ekilebilir_alan",
        "credits_charged": 2,
        "credits_remaining": 1499138,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 140,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/kalici-mahsul-alan2 kredi

Kalıcı Mahsul Alan control.kalici_mahsul_alan

Bağ, bahçe, meyvelik, zeytinlik gibi süreklilik taşıyan üretim alanlarını ifade eder. Kullanım dönüşümü zor olabilir. (Teknik kontrol no 53.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/kalici-mahsul-alan?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/kalici-mahsul-alan?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 53,
        "name": "Kalıcı Mahsul Alan",
        "group": "Tarım & Doğal Kullanım Sınıfları",
        "description": "Bağ, bahçe, meyvelik, zeytinlik gibi süreklilik taşıyan üretim alanlarını ifade eder. Kullanım dönüşümü zor olabilir.",
        "result": {
            "per_crops": {
                "id": 39,
                "msg": {
                    "en": "This location isn't in the Permanent crops.",
                    "tr": "Kalıcı Mahsul alanda değildir.",
                    "key": "per_crops_status_false"
                },
                "sira": 53,
                "title": {
                    "en": "Permanent crops",
                    "tr": "Kalıcı Mahsul Alan",
                    "key": "per_crops_title"
                },
                "status": "false",
                "distance": null
            }
        }
    },
    "meta": {
        "request_id": "req_8144ae1aae9c7a5290bd",
        "product": "control.kalici_mahsul_alan",
        "credits_charged": 2,
        "credits_remaining": 1499136,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 168,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/mera-alan2 kredi

Mera Alan control.mera_alan

Otlatma ve ortak kullanım niteliği taşıyan alanlardır. Hayvancılık yatırımlarında pozitif etkisi olur. Buralar özel yatırım açısından ciddi kısıt yaratabilir. (Teknik kontrol no 54.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/mera-alan?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/mera-alan?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 54,
        "name": "Mera Alan",
        "group": "Tarım & Doğal Kullanım Sınıfları",
        "description": "Otlatma ve ortak kullanım niteliği taşıyan alanlardır. Hayvancılık yatırımlarında pozitif etkisi olur. Buralar özel yatırım açısından ciddi kısıt yaratabilir.",
        "result": {
            "pasture": {
                "id": 54,
                "msg": {
                    "en": "This location isn't in the Pastures.",
                    "tr": "Mera alanında değildir.",
                    "key": "pasture_status_false"
                },
                "title": {
                    "en": "Pastures",
                    "tr": "Mera Alan",
                    "key": "pasture_title"
                },
                "status": "false",
                "distance": 4723
            }
        }
    },
    "meta": {
        "request_id": "req_642a5531db762616b500",
        "product": "control.mera_alan",
        "credits_charged": 2,
        "credits_remaining": 1499134,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 169,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/heterojen-tarim-alani2 kredi

Heterojen Tarım Alanı control.heterojen_tarim_alani

Karışık tarımsal kullanım yapısına sahip bölgeleri gösterir. Net kullanım analizi gerektirir. (Teknik kontrol no 55.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/heterojen-tarim-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/heterojen-tarim-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 55,
        "name": "Heterojen Tarım Alanı",
        "group": "Tarım & Doğal Kullanım Sınıfları",
        "description": "Karışık tarımsal kullanım yapısına sahip bölgeleri gösterir. Net kullanım analizi gerektirir.",
        "result": {
            "heteroge": {
                "id": 38,
                "msg": {
                    "en": "This location isn't in the Heterogeneous Agricultural Areas..",
                    "tr": "Heterojen Tarım Alanında değildir.",
                    "key": "heteroge_status_false"
                },
                "sira": 55,
                "title": {
                    "en": "Heterogeneous Agricultural Areas.",
                    "tr": "Heterojen Tarım Alan",
                    "key": "pasture_title"
                },
                "status": "false",
                "distance": 783
            }
        }
    },
    "meta": {
        "request_id": "req_f05fb026abc2ba225822",
        "product": "control.heterojen_tarim_alani",
        "credits_charged": 2,
        "credits_remaining": 1499132,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 175,
        "version": "1.3.0"
    }
}

Kontrol · Altyapı ve stratejik konum

Tekil kontroller: ulaşım ağı, elektrik şebekesi, OSB, havamania.

GET/public/api/v1/technical/controls/ulasim-agi2 kredi

Ulaşım Ağı control.ulasim_agi

Ana yol, bağlantı hattı ve erişim etkisi yaratan ulaşım kararlarını gösterir. Bölgenin kullanım değerini artırır. (Teknik kontrol no 38.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/ulasim-agi?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/ulasim-agi?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 38,
        "name": "Ulaşım Ağı",
        "group": "Altyapı & Sanayi/Stratejik Konum",
        "description": "Ana yol, bağlantı hattı ve erişim etkisi yaratan ulaşım kararlarını gösterir. Bölgenin kullanım değerini artırır.",
        "result": {
            "transport": {
                "id": 871,
                "msg": {
                    "en": "This location is in the Transport area.",
                    "tr": "Metro alanında bulunmaktadır.",
                    "key": "transport_false"
                },
                "sira": 38,
                "title": {
                    "en": "Transport Area",
                    "tr": "Ulaşım Alanı",
                    "key": "transport"
                },
                "status": true,
                "distance": 423,
                "transport": "Metro"
            }
        }
    },
    "meta": {
        "request_id": "req_b1cd39d215f4e2afa6c3",
        "product": "control.ulasim_agi",
        "credits_charged": 2,
        "credits_remaining": 1499166,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 151,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/elektrik-sebekesi-alani2 kredi

Elektrik Şebekesi Alanı control.elektrik_sebekesi_alani

Enerji altyapısına yakınlık veya altyapı etkisini gösterir. Özellikle arsa ve sanayi yatırımlarında önemlidir. (Teknik kontrol no 39.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/elektrik-sebekesi-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/elektrik-sebekesi-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 39,
        "name": "Elektrik Şebekesi Alanı",
        "group": "Altyapı & Sanayi/Stratejik Konum",
        "description": "Enerji altyapısına yakınlık veya altyapı etkisini gösterir. Özellikle arsa ve sanayi yatırımlarında önemlidir.",
        "result": {
            "electrical_grid": {
                "id": 872,
                "msg": {
                    "en": "This location isn't in the Electrical Grid area.",
                    "tr": "Elektrik Şebeke alanında değildir.",
                    "key": "electrical_grid_false"
                },
                "sira": 39,
                "title": {
                    "en": "Electrical Grid Area",
                    "tr": "Elektrik Şebeke  Alanı",
                    "key": "electrical_grid"
                },
                "status": "false",
                "distance": 728
            }
        }
    },
    "meta": {
        "request_id": "req_293fa80647da44170780",
        "product": "control.elektrik_sebekesi_alani",
        "credits_charged": 2,
        "credits_remaining": 1499164,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 152,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/osb-alani2 kredi

OSB Alanı control.osb_alani

Organize sanayi bölgesi etkisindeki alanları ifade eder. Sanayi, depo, lojistik ve işgücü talebi açısından değerlidir. (Teknik kontrol no 40.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/osb-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/osb-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 40,
        "name": "OSB Alanı",
        "group": "Altyapı & Sanayi/Stratejik Konum",
        "description": "Organize sanayi bölgesi etkisindeki alanları ifade eder. Sanayi, depo, lojistik ve işgücü talebi açısından değerlidir.",
        "result": {
            "osb": {
                "id": 862,
                "msg": {
                    "en": "This location isn't in the OIZ area.",
                    "tr": "OSB alanında değildir.",
                    "key": "osb_status_false"
                },
                "sira": 40,
                "title": {
                    "en": "OIZ",
                    "tr": "OSB Alanı",
                    "key": "osb_title"
                },
                "status": "false",
                "distance": 2489
            }
        }
    },
    "meta": {
        "request_id": "req_6a74f0fb34ca1cb17f12",
        "product": "control.osb_alani",
        "credits_charged": 2,
        "credits_remaining": 1499162,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 178,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/havamania-alani2 kredi

Havamania Alanı control.havamania_alani

Havalimanı, uçuş koridoru ya da havacılık etkili özel alan kategorisi olarak değerlendirilir. Gürültü, yükseklik veya kullanım etkisi doğurabilir. (Teknik kontrol no 41.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/havamania-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/havamania-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 41,
        "name": "Havamania Alanı",
        "group": "Altyapı & Sanayi/Stratejik Konum",
        "description": "Havalimanı, uçuş koridoru ya da havacılık etkili özel alan kategorisi olarak değerlendirilir. Gürültü, yükseklik veya kullanım etkisi doğurabilir.",
        "result": {
            "havamania": {
                "id": 921,
                "msg": {
                    "en": "This location isn't in the airport area.",
                    "tr": "Havamania alanında değildir.",
                    "key": "havamania_status_false"
                },
                "sira": 41,
                "title": {
                    "en": "Airport Area",
                    "tr": "Havamania Alanı",
                    "key": "havamania_title"
                },
                "status": "false",
                "distance": 2602
            }
        }
    },
    "meta": {
        "request_id": "req_801898d595b4ee4f840a",
        "product": "control.havamania_alani",
        "credits_charged": 2,
        "credits_remaining": 1499160,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 134,
        "version": "1.3.0"
    }
}

Kontrol · Fiziksel ve mekânsal özellikler

Tekil kontroller: yapılaşma, site, bina yaşı, Boğaz görünümü, deniz / göl, su yüzeyi.

GET/public/api/v1/technical/controls/bina-alan2 kredi

Bina (Fiziki Yapılaşmış) Alan control.bina_alan

Yapılaşmış alan bilgisini verir. Yoğunluk ve mevcut kullanım hakkında fikir sağlar. (Teknik kontrol no 32.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/bina-alan?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/bina-alan?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 32,
        "name": "Bina (Fiziki Yapılaşmış) Alan",
        "group": "Fiziksel & Mekansal Özellikler",
        "description": "Yapılaşmış alan bilgisini verir. Yoğunluk ve mevcut kullanım hakkında fikir sağlar.",
        "result": {
            "building": {
                "id": 878,
                "msg": {
                    "en": "This location isn't in the Building area.",
                    "tr": "Bina alanında değildir.",
                    "key": "building_false"
                },
                "sira": 32,
                "title": {
                    "en": "Building Area",
                    "tr": "Bina Alanı",
                    "key": "building"
                },
                "status": false,
                "distance": null
            }
        }
    },
    "meta": {
        "request_id": "req_4e678914018536dcde5c",
        "product": "control.bina_alan",
        "credits_charged": 2,
        "credits_remaining": 1499178,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 133,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/site-alani2 kredi

Site Alanı control.site_alani

Toplu konut/site düzeni içindeki bölgeleri gösterir. Güvenlik ve yaşam standardı beklentisini etkiler. (Teknik kontrol no 33.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/site-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/site-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 33,
        "name": "Site Alanı",
        "group": "Fiziksel & Mekansal Özellikler",
        "description": "Toplu konut/site düzeni içindeki bölgeleri gösterir. Güvenlik ve yaşam standardı beklentisini etkiler.",
        "result": {
            "site_status": {
                "id": 873,
                "msg": {
                    "en": "This location is in the Site area.",
                    "tr": "Konut Bloklarında bulunmaktadır.",
                    "key": "site_status"
                },
                "sira": 33,
                "title": {
                    "en": "Site Area",
                    "tr": "Site Alanı",
                    "key": "site_status"
                },
                "status": true,
                "distance": 0,
                "site_status": null
            }
        }
    },
    "meta": {
        "request_id": "req_c18135af4dfeafa36cff",
        "product": "control.site_alani",
        "credits_charged": 2,
        "credits_remaining": 1499176,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 1584,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/ortalama-bina-yasi2 kredi

Ortalama Bina Yaşı control.ortalama_bina_yasi

Yapı stokunun yaş ortalamasını gösterir. Dönüşüm potansiyeli ve bakım maliyeti açısından önemlidir. (Teknik kontrol no 34.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/ortalama-bina-yasi?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/ortalama-bina-yasi?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 34,
        "name": "Ortalama Bina Yaşı",
        "group": "Fiziksel & Mekansal Özellikler",
        "description": "Yapı stokunun yaş ortalamasını gösterir. Dönüşüm potansiyeli ve bakım maliyeti açısından önemlidir.",
        "result": {
            "avg_build_age": {
                "id": 890,
                "msg": {
                    "en": "This location is in an area with an average building age of 10-20.",
                    "tr": "10-20 ortalama bina yaşına sahip alanda bulunmaktadır.",
                    "key": "avg_build_age_true"
                },
                "sira": 34,
                "title": {
                    "en": "Average Building Age",
                    "tr": "Ortalama Bina Yaşı",
                    "key": "avg_build_age"
                },
                "status": "true"
            }
        }
    },
    "meta": {
        "request_id": "req_5224c8db22c0b232f683",
        "product": "control.ortalama_bina_yasi",
        "credits_charged": 2,
        "credits_remaining": 1499174,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 176,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/bogaz-gorunum2 kredi

Boğaz Görünüm control.bogaz_gorunum

Manzara etkisini gösterir. Prestij ve fiyat primi yaratabilir ama temel yatırım verisi değildir. (Teknik kontrol no 35.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/bogaz-gorunum?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/bogaz-gorunum?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 35,
        "name": "Boğaz Görünüm",
        "group": "Fiziksel & Mekansal Özellikler",
        "description": "Manzara etkisini gösterir. Prestij ve fiyat primi yaratabilir ama temel yatırım verisi değildir.",
        "result": {
            "bosphorus": {
                "id": 915,
                "msg": {
                    "en": "This location isn't in the Bosphorus area.",
                    "tr": "Boğaz Görünüm alanında değildir.",
                    "key": "bosphorus_status_false"
                },
                "sira": 35,
                "title": {
                    "en": "Bosphorus Area",
                    "tr": "Boğaz Görünüm",
                    "key": "bosphorus_title"
                },
                "status": "false",
                "distance": null
            }
        }
    },
    "meta": {
        "request_id": "req_bc4eab1c7362161474d3",
        "product": "control.bogaz_gorunum",
        "credits_charged": 2,
        "credits_remaining": 1499172,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 135,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/deniz-gol-alani2 kredi

Deniz Göl Alanı control.deniz_gol_alani

Büyük su kütleleriyle ilişkili alan bilgisidir. Çevresel, görsel ve kullanım etkisi olabilir. (Teknik kontrol no 36.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/deniz-gol-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/deniz-gol-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 36,
        "name": "Deniz Göl Alanı",
        "group": "Fiziksel & Mekansal Özellikler",
        "description": "Büyük su kütleleriyle ilişkili alan bilgisidir. Çevresel, görsel ve kullanım etkisi olabilir.",
        "result": {
            "deniz_gol": {
                "id": 864,
                "msg": {
                    "en": "This location is in the Sea–Lake area.",
                    "tr": "Göl alanında bulunmaktadır.",
                    "key": "deniz_gol_false"
                },
                "sira": 36,
                "title": {
                    "en": "Sea–Lake Area",
                    "tr": "Deniz Göl Alanı",
                    "key": "deniz_gol"
                },
                "status": true,
                "distance": 0,
                "deniz_gol": "Göl"
            }
        }
    },
    "meta": {
        "request_id": "req_664d7478dc5320d4cbd6",
        "product": "control.deniz_gol_alani",
        "credits_charged": 2,
        "credits_remaining": 1499170,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 646,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/su-yuzeyi-alani2 kredi

Su Yüzeyi Alanı control.su_yuzeyi_alani

Gölet, nehir, kanal veya açık su yüzeylerini ifade eder. Kullanım ve manzara etkisi yaratır. (Teknik kontrol no 37.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/su-yuzeyi-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/su-yuzeyi-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 37,
        "name": "Su Yüzeyi Alanı",
        "group": "Fiziksel & Mekansal Özellikler",
        "description": "Gölet, nehir, kanal veya açık su yüzeylerini ifade eder. Kullanım ve manzara etkisi yaratır.",
        "result": {
            "water_bodies": {
                "id": 876,
                "msg": {
                    "en": "This location isn't in the Water Bodies area.",
                    "tr": "Su Yüzeyi alanında değildir.",
                    "key": "water_bodies_false"
                },
                "sira": 37,
                "title": {
                    "en": "Water Bodies Area",
                    "tr": "Su Yüzeyi Alanı",
                    "key": "water_bodies"
                },
                "status": "false",
                "distance": 937
            }
        }
    },
    "meta": {
        "request_id": "req_ba42f226496357d0243c",
        "product": "control.su_yuzeyi_alani",
        "credits_charged": 2,
        "credits_remaining": 1499168,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 161,
        "version": "1.3.0"
    }
}

Kontrol · Lokasyon erişimi

Tekil kontroller: en yakın metro, metrobüs, otobüs, hastane, okul, AVM, market zincirleri, sinema, cami, plaj …

GET/public/api/v1/technical/controls/en-yakin-havalimani2 kredi

En Yakın Havalimanı control.en_yakin_havalimani

Şehrin dış bağlantısına erişim düzeyini ifade eder. Lojistik, turizm ve üst segment projelerde önemlidir. (Teknik kontrol no 42.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-havalimani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-havalimani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 42,
        "name": "En Yakın Havalimanı",
        "group": "Lokasyon Erişim",
        "description": "Şehrin dış bağlantısına erişim düzeyini ifade eder. Lojistik, turizm ve üst segment projelerde önemlidir.",
        "result": {
            "airport": {
                "id": 952,
                "adi": "Atatürk Havalimanı AirShow",
                "lat": 40.998103,
                "lng": 28.801098,
                "msg": {
                    "en": "This location is in the airport area.",
                    "tr": "Havalimanı bulunmaktadır.",
                    "key": "airport_status"
                },
                "cate": "Havalimanı",
                "sira": 42,
                "title": {
                    "en": "Airport Area",
                    "tr": "Havalimanı Alanı",
                    "key": "airport_title"
                },
                "status": false,
                "ana_cate": "Ulaşım",
                "distance": 115459
            }
        }
    },
    "meta": {
        "request_id": "req_2d70cda27781ecb97ba1",
        "product": "control.en_yakin_havalimani",
        "credits_charged": 2,
        "credits_remaining": 1499158,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 9715,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-metro-duragi2 kredi

En Yakın Metro Durağı control.en_yakin_metro_duragi

Raylı sisteme erişim yakınlığını gösterir. Büyükşehirlerde fiyat ve kira üzerinde güçlü etkiye sahiptir. (Teknik kontrol no 43.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-metro-duragi?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-metro-duragi?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 43,
        "name": "En Yakın Metro Durağı",
        "group": "Lokasyon Erişim",
        "description": "Raylı sisteme erişim yakınlığını gösterir. Büyükşehirlerde fiyat ve kira üzerinde güçlü etkiye sahiptir.",
        "result": {
            "metro_station": {
                "id": 960,
                "adi": "Metro",
                "lat": 41.034368,
                "lng": 28.794967,
                "msg": {
                    "en": "This location is in the Metro Station area.",
                    "tr": "Metro Durağı bulunmaktadır.",
                    "key": "metro_station_status"
                },
                "cate": "Metro Durağı",
                "sira": 43,
                "title": {
                    "en": "Metro Station Area",
                    "tr": "Metro Durağı Alanı",
                    "key": "metro_station_title"
                },
                "status": false,
                "ana_cate": "Ulaşım",
                "distance": 3233
            }
        }
    },
    "meta": {
        "request_id": "req_e67deb12192c8d764f2b",
        "product": "control.en_yakin_metro_duragi",
        "credits_charged": 2,
        "credits_remaining": 1499156,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 454,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-metrobus-duragi2 kredi

En Yakın Metrobüs Durağı control.en_yakin_metrobus_duragi

Yoğun toplu taşımaya erişimi ölçer. Özellikle İstanbul özelinde çok anlamlıdır. (Teknik kontrol no 44.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-metrobus-duragi?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-metrobus-duragi?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 44,
        "name": "En Yakın Metrobüs Durağı",
        "group": "Lokasyon Erişim",
        "description": "Yoğun toplu taşımaya erişimi ölçer. Özellikle İstanbul özelinde çok anlamlıdır.",
        "result": {
            "metrobus_stop": {
                "id": 959,
                "adi": "İETT Küçükçekmece Metrobüs Durağı",
                "lat": 40.9881,
                "lng": 28.7702,
                "msg": {
                    "en": "This location is in the Metrobus Stop area.",
                    "tr": "Metrobüs Durağı bulunmaktadır.",
                    "key": "metrobus_stop_status"
                },
                "cate": "Metrobüs Durağı",
                "sira": 44,
                "title": {
                    "en": "Metrobus Stop Area",
                    "tr": "Metrobüs Durağı Alanı",
                    "key": "metrobus_stop_title"
                },
                "status": false,
                "ana_cate": "Ulaşım",
                "distance": 6665
            }
        }
    },
    "meta": {
        "request_id": "req_42a2caeda1d820f1e490",
        "product": "control.en_yakin_metrobus_duragi",
        "credits_charged": 2,
        "credits_remaining": 1499154,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 427,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-otobus-duragi2 kredi

En Yakın Otobüs Durağı control.en_yakin_otobus_duragi

Temel toplu taşıma erişimini gösterir. Mikro lokasyon kararında destekleyicidir. (Teknik kontrol no 45.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-otobus-duragi?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-otobus-duragi?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 45,
        "name": "En Yakın Otobüs Durağı",
        "group": "Lokasyon Erişim",
        "description": "Temel toplu taşıma erişimini gösterir. Mikro lokasyon kararında destekleyicidir.",
        "result": {
            "bus_station": {
                "id": 956,
                "adi": "İETT Seralar Otobüs Durağı",
                "lat": 41.04790299,
                "lng": 28.75579092,
                "msg": {
                    "en": "This location is in the Bus Station area.",
                    "tr": "Otobüs Durağı bulunmaktadır.",
                    "key": "bus_station_status"
                },
                "cate": "Otobüs Durağı",
                "sira": 45,
                "title": {
                    "en": "Bus Station Area",
                    "tr": "Otobüs Durağı Alanı",
                    "key": "bus_station_title"
                },
                "status": false,
                "ana_cate": "Ulaşım",
                "distance": 420
            }
        }
    },
    "meta": {
        "request_id": "req_62f47c09cd8d80110a57",
        "product": "control.en_yakin_otobus_duragi",
        "credits_charged": 2,
        "credits_remaining": 1499152,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 477,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-minibus-duragi2 kredi

En Yakın Minibüs Durağı control.en_yakin_minibus_duragi

Mahalle ve ilçe içi pratik erişim imkânını yansıtır. Yerel kullanıcı açısından değerlidir. (Teknik kontrol no 46.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-minibus-duragi?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-minibus-duragi?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 46,
        "name": "En Yakın Minibüs Durağı",
        "group": "Lokasyon Erişim",
        "description": "Mahalle ve ilçe içi pratik erişim imkânını yansıtır. Yerel kullanıcı açısından değerlidir.",
        "result": {
            "minibus_stop": {
                "id": 958,
                "adi": "Minibüs Durağı",
                "lat": 41.0565,
                "lng": 28.7626,
                "msg": {
                    "en": "This location is in the Minibus Stop area.",
                    "tr": "Minibüs Durağı bulunmaktadır.",
                    "key": "minibus_stop_status"
                },
                "cate": "Minibüs Durağı",
                "sira": 46,
                "title": {
                    "en": "Minibus Stop Area",
                    "tr": "Minibüs Durağı Alanı",
                    "key": "minibus_stop_title"
                },
                "status": false,
                "ana_cate": "Ulaşım",
                "distance": 991
            }
        }
    },
    "meta": {
        "request_id": "req_5a490541e7ebebaa325b",
        "product": "control.en_yakin_minibus_duragi",
        "credits_charged": 2,
        "credits_remaining": 1499150,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 485,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-taksi-duragi2 kredi

En Yakın Taksi Durağı control.en_yakin_taksi_duragi

Hızlı bireysel ulaşım erişimini gösterir. Ticari ve konut kullanımında destekleyici veridir. (Teknik kontrol no 47.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-taksi-duragi?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-taksi-duragi?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 47,
        "name": "En Yakın Taksi Durağı",
        "group": "Lokasyon Erişim",
        "description": "Hızlı bireysel ulaşım erişimini gösterir. Ticari ve konut kullanımında destekleyici veridir.",
        "result": {
            "taxi_stand": {
                "id": 957,
                "adi": "Miss Meydan Taksi Durağı",
                "lat": 41.050922,
                "lng": 28.76181,
                "msg": {
                    "en": "This location is in the Taxi Stand area.",
                    "tr": "Taksi Durağı bulunmaktadır.",
                    "key": "taxi_stand_status"
                },
                "cate": "Taksi Durağı",
                "sira": 47,
                "title": {
                    "en": "Taxi Stand Area",
                    "tr": "Taksi Durağı Alanı",
                    "key": "taxi_stand_title"
                },
                "status": false,
                "ana_cate": "Ulaşım",
                "distance": 370
            }
        }
    },
    "meta": {
        "request_id": "req_ffb14c05fa57fb97f042",
        "product": "control.en_yakin_taksi_duragi",
        "credits_charged": 2,
        "credits_remaining": 1499148,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 476,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-hastane2 kredi

En Yakın Hastane control.en_yakin_hastane

Sağlık hizmetine erişimi gösterir. Konut talebi ve yaşanabilirlik açısından önemlidir. (Teknik kontrol no 48.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-hastane?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-hastane?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 48,
        "name": "En Yakın Hastane",
        "group": "Lokasyon Erişim",
        "description": "Sağlık hizmetine erişimi gösterir. Konut talebi ve yaşanabilirlik açısından önemlidir.",
        "result": {
            "hospital": {
                "id": 953,
                "adi": "Kanuni Sultan Süleyman Hastanesi Spor Hekimliği",
                "lat": 41.052174,
                "lng": 28.762956,
                "msg": {
                    "en": "This location is in the hospital area.",
                    "tr": "Hastane bulunmaktadır.",
                    "key": "hospital_status"
                },
                "cate": "Hastane",
                "sira": 48,
                "title": {
                    "en": "Hospital Area",
                    "tr": "Hastane Alanı",
                    "key": "hospital_title"
                },
                "status": false,
                "ana_cate": "Sağlık",
                "distance": 531
            }
        }
    },
    "meta": {
        "request_id": "req_9595a7257e99d14dbd57",
        "product": "control.en_yakin_hastane",
        "credits_charged": 2,
        "credits_remaining": 1499146,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 634,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-universite2 kredi

En Yakın Üniversite control.en_yakin_universite

Öğrenci ve akademik nüfus etkisini gösterir. Kiralık konut ve ticari talep üretir. (Teknik kontrol no 49.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-universite?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-universite?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 49,
        "name": "En Yakın Üniversite",
        "group": "Lokasyon Erişim",
        "description": "Öğrenci ve akademik nüfus etkisini gösterir. Kiralık konut ve ticari talep üretir.",
        "result": {
            "university": {
                "id": 955,
                "adi": "İstanbul Sabahattin Zaim Üniversitesi Yabancı Diller Fakultesi",
                "lat": 41.032716,
                "lng": 28.783905,
                "msg": {
                    "en": "This location is in the University area.",
                    "tr": "Üniversite bulunmaktadır.",
                    "key": "university_status"
                },
                "cate": "Üniversite",
                "sira": 49,
                "title": {
                    "en": "University Area",
                    "tr": "Üniversite Alanı",
                    "key": "university_title"
                },
                "status": false,
                "ana_cate": "Eğitim",
                "distance": 2559
            }
        }
    },
    "meta": {
        "request_id": "req_48a5793906ccbbbbf56b",
        "product": "control.en_yakin_universite",
        "credits_charged": 2,
        "credits_remaining": 1499144,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 726,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-karakol2 kredi

En Yakın Karakol control.en_yakin_karakol

Güvenlik hizmetine erişimi gösterir. Bölge algısı üzerinde dolaylı etkisi vardır. (Teknik kontrol no 50.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-karakol?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-karakol?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 50,
        "name": "En Yakın Karakol",
        "group": "Lokasyon Erişim",
        "description": "Güvenlik hizmetine erişimi gösterir. Bölge algısı üzerinde dolaylı etkisi vardır.",
        "result": {
            "police_station": {
                "id": 954,
                "msg": {
                    "en": "This location isn't in the police station area.",
                    "tr": "Karakol bulunmamaktadır.",
                    "key": "police_station_status_false"
                },
                "sira": 50,
                "title": {
                    "en": "Police Station Area",
                    "tr": "Karakol Alanı",
                    "key": "police_station_title"
                },
                "status": "false",
                "distance": 1295
            }
        }
    },
    "meta": {
        "request_id": "req_6d0a9c33d88331ed278c",
        "product": "control.en_yakin_karakol",
        "credits_charged": 2,
        "credits_remaining": 1499142,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 490,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-egitim-kurumu2 kredi

En Yakın Eğitim Kurumu control.en_yakin_egitim_kurumu

Okul veya eğitim fonksiyonlarıyla ilişkili alanları belirtir. Aile odaklı konut talebinde önemlidir. (Teknik kontrol no 51.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-egitim-kurumu?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-egitim-kurumu?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 51,
        "name": "En Yakın Eğitim Kurumu",
        "group": "Lokasyon Erişim",
        "description": "Okul veya eğitim fonksiyonlarıyla ilişkili alanları belirtir. Aile odaklı konut talebinde önemlidir.",
        "result": {
            "education_facility": {
                "id": 875,
                "lat": 41.031091,
                "lng": 28.704334000000003,
                "msg": {
                    "en": "This location is in the Education Facility area.",
                    "tr": "Anadolu Lise alanında bulunmaktadır.",
                    "key": "education_facility_false"
                },
                "sira": 51,
                "title": {
                    "en": "Education Facility Area",
                    "tr": "Eğitim Kurumu Alanı",
                    "key": "education_facility"
                },
                "status": false,
                "distance": 430,
                "education_facility": "Anadolu Lise"
            }
        }
    },
    "meta": {
        "request_id": "req_6e9db19abd0d72da4bca",
        "product": "control.en_yakin_egitim_kurumu",
        "credits_charged": 2,
        "credits_remaining": 1499140,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 173,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-starbucks2 kredi

En Yakın Starbucks control.en_yakin_starbucks

Premium müşteri segmentini çeken, yüksek harcama gücü ve marka prestiji ile bulunduğu lokasyonun değerini ve ticari cazibesini üst seviyeye taşıyan güçlü bir yatırım referans noktasıdır. (Teknik kontrol no 65.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-starbucks?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-starbucks?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 65,
        "name": "En Yakın Starbucks",
        "group": "Lokasyon Erişim",
        "description": "Premium müşteri segmentini çeken, yüksek harcama gücü ve marka prestiji ile bulunduğu lokasyonun değerini ve ticari cazibesini üst seviyeye taşıyan güçlü bir yatırım referans noktasıdır.",
        "result": {
            "strbucks": {
                "id": 965,
                "adi": "Starbucks",
                "lat": 41.051337,
                "lng": 28.762544,
                "msg": {
                    "en": "There is a Starbucks at this location.",
                    "tr": "Bu konumda Starbucks bulunmaktadır.",
                    "key": "strbucks_status"
                },
                "cate": "Starbucks",
                "sira": 65,
                "title": {
                    "en": "Starbucks",
                    "tr": "Starbucks",
                    "key": "strbucks_title"
                },
                "status": false,
                "ana_cate": "Cafe-Restoran",
                "distance": 432
            }
        }
    },
    "meta": {
        "request_id": "req_95750dbfda50869481a2",
        "product": "control.en_yakin_starbucks",
        "credits_charged": 2,
        "credits_remaining": 1499118,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 314,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-migros2 kredi

En Yakın Migros control.en_yakin_migros

Orta-üst segment müşteri kitlesine hitap eden, güçlü marka değeri ve yüksek harcama potansiyeli ile lokasyonun ticari değerini ve yatırım çekiciliğini belirgin şekilde artıran bir perakende noktasıdır. (Teknik kontrol no 66.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-migros?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-migros?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 66,
        "name": "En Yakın Migros",
        "group": "Lokasyon Erişim",
        "description": "Orta-üst segment müşteri kitlesine hitap eden, güçlü marka değeri ve yüksek harcama potansiyeli ile lokasyonun ticari değerini ve yatırım çekiciliğini belirgin şekilde artıran bir perakende noktasıdır…",
        "result": {
            "migros": {
                "id": 967,
                "adi": "Mm Migros",
                "lat": 41.045,
                "lng": 28.7621,
                "msg": {
                    "en": "There is a Migros at this location.",
                    "tr": "Bu konumda Migros bulunmaktadır.",
                    "key": "migros_status"
                },
                "cate": "Migros",
                "sira": 66,
                "title": {
                    "en": "Migros",
                    "tr": "Migros",
                    "key": "migros_title"
                },
                "status": false,
                "ana_cate": "Market",
                "distance": 318
            }
        }
    },
    "meta": {
        "request_id": "req_a74006e3a0ba6ebd2991",
        "product": "control.en_yakin_migros",
        "credits_charged": 2,
        "credits_remaining": 1499116,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 320,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-a1012 kredi

En Yakın A101 control.en_yakin_a101

Yüksek erişilebilirlik ve yoğun müşteri trafiği ile günlük ihtiyaçları karşılayan, düşük sepet ortalaması nedeniyle daha sınırlı gelir profiline sahip, ancak düzenli talep oluşturan bir perakende noktasıdır. (Teknik kontrol no 67.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-a101?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-a101?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 67,
        "name": "En Yakın A101",
        "group": "Lokasyon Erişim",
        "description": "Yüksek erişilebilirlik ve yoğun müşteri trafiği ile günlük ihtiyaçları karşılayan, düşük sepet ortalaması nedeniyle daha sınırlı gelir profiline sahip, ancak düzenli talep oluşturan bir perakende nokt…",
        "result": {
            "a101": {
                "id": 968,
                "adi": "A101",
                "lat": 41.044881,
                "lng": 28.767892999999997,
                "msg": {
                    "en": "There is a A101 at this location.",
                    "tr": "Bu konumda A101 bulunmaktadır.",
                    "key": "a101_status"
                },
                "cate": "A101",
                "sira": 67,
                "title": {
                    "en": "A101",
                    "tr": "A101",
                    "key": "a101_title"
                },
                "status": false,
                "ana_cate": "Market",
                "distance": 675
            }
        }
    },
    "meta": {
        "request_id": "req_1c6ae4800ea1374eccb4",
        "product": "control.en_yakin_a101",
        "credits_charged": 2,
        "credits_remaining": 1499114,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 337,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-bim2 kredi

En Yakın BİM control.en_yakin_bim

Geniş kitlelere hitap eden, yüksek müşteri trafiği oluşturmasına rağmen düşük sepet ortalaması ile daha çok günlük ihtiyaç odaklı, kira istikrarı sağlayan bir perakende noktasıdır. (Teknik kontrol no 68.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-bim?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-bim?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 68,
        "name": "En Yakın BİM",
        "group": "Lokasyon Erişim",
        "description": "Geniş kitlelere hitap eden, yüksek müşteri trafiği oluşturmasına rağmen düşük sepet ortalaması ile daha çok günlük ihtiyaç odaklı, kira istikrarı sağlayan bir perakende noktasıdır.",
        "result": {
            "bim": {
                "id": 969,
                "adi": "Bim",
                "lat": 41.0555,
                "lng": 28.7619,
                "msg": {
                    "en": "There is a BİM at this location.",
                    "tr": "Bu konumda BİM bulunmaktadır.",
                    "key": "bim_status"
                },
                "cate": "Bim",
                "sira": 68,
                "title": {
                    "en": "BİM",
                    "tr": "BİM",
                    "key": "bim_title"
                },
                "status": false,
                "ana_cate": "Market",
                "distance": 873
            }
        }
    },
    "meta": {
        "request_id": "req_283d3ede72864077026e",
        "product": "control.en_yakin_bim",
        "credits_charged": 2,
        "credits_remaining": 1499112,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 316,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-sok2 kredi

En Yakın Şok control.en_yakin_sok

Yoğun müşteri sirkülasyonu ile erişilebilirlik sağlayan, ancak düşük harcama ortalamasıyla daha çok temel ihtiyaçlara hizmet eden, stabil ancak sınırlı gelir potansiyeline sahip bir ticari noktadır. (Teknik kontrol no 69.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-sok?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-sok?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 69,
        "name": "En Yakın Şok",
        "group": "Lokasyon Erişim",
        "description": "Yoğun müşteri sirkülasyonu ile erişilebilirlik sağlayan, ancak düşük harcama ortalamasıyla daha çok temel ihtiyaçlara hizmet eden, stabil ancak sınırlı gelir potansiyeline sahip bir ticari noktadır.",
        "result": {
            "sok": {
                "id": 970,
                "msg": {
                    "en": "There is not a Şok Market at this location.",
                    "tr": "Bu konumda Şok Market bulunmamaktadır.",
                    "key": "sok_status_false"
                },
                "sira": 69,
                "title": {
                    "en": "Şok",
                    "tr": "Şok",
                    "key": "sok_title"
                },
                "status": "false",
                "distance": 1295
            }
        }
    },
    "meta": {
        "request_id": "req_02836cfe57429c75cacf",
        "product": "control.en_yakin_sok",
        "credits_charged": 2,
        "credits_remaining": 1499110,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 318,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-avm2 kredi

En Yakın AVM control.en_yakin_avm

Geniş marka çeşitliliği, sosyal yaşam alanları ve yüksek ziyaretçi trafiği ile lokasyonun ticari değerini ve yatırım potansiyelini belirgin şekilde artıran güçlü bir çekim merkezidir. (Teknik kontrol no 70.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-avm?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-avm?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 70,
        "name": "En Yakın AVM",
        "group": "Lokasyon Erişim",
        "description": "Geniş marka çeşitliliği, sosyal yaşam alanları ve yüksek ziyaretçi trafiği ile lokasyonun ticari değerini ve yatırım potansiyelini belirgin şekilde artıran güçlü bir çekim merkezidir.",
        "result": {
            "avm": {
                "id": 971,
                "adi": "Bosphorus City Ortaköy Avm",
                "lat": 41.047341,
                "lng": 28.759829,
                "msg": {
                    "en": "There is a AVM at this location.",
                    "tr": "Bu konumda AVM bulunmaktadır.",
                    "key": "avm_status"
                },
                "cate": "AVM",
                "sira": 70,
                "title": {
                    "en": "AVM",
                    "tr": "AVM",
                    "key": "avm_title"
                },
                "status": false,
                "ana_cate": "Mağaza",
                "distance": 88
            }
        }
    },
    "meta": {
        "request_id": "req_db054845c8f104f35503",
        "product": "control.en_yakin_avm",
        "credits_charged": 2,
        "credits_remaining": 1499108,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 345,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-sinema2 kredi

En Yakın Sinema control.en_yakin_sinema

Belirtilen konuma en yakın sinema salonunu gösterir. Sinema gibi yüksek ziyaretçi trafiği oluşturan sosyal noktalar, bölgedeki yaya hareketliliğini artırarak ticari potansiyel ve dolaylı gelir fırsatları açısından önemli bir gösterge sunar. (Teknik kontrol no 71.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-sinema?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-sinema?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 71,
        "name": "En Yakın Sinema",
        "group": "Lokasyon Erişim",
        "description": "Belirtilen konuma en yakın sinema salonunu gösterir. Sinema gibi yüksek ziyaretçi trafiği oluşturan sosyal noktalar, bölgedeki yaya hareketliliğini artırarak ticari potansiyel ve dolaylı gelir fırsatl…",
        "result": {
            "sinema": {
                "id": 972,
                "adi": "Bağcılar Planetaryum Sinema",
                "lat": 41.03318633,
                "lng": 28.85640157,
                "msg": {
                    "en": "There is a Cinema at this location.",
                    "tr": "Bu konumda Sinema bulunmaktadır.",
                    "key": "sinema_status"
                },
                "cate": "Sinema",
                "sira": 71,
                "title": {
                    "en": "Cinema",
                    "tr": "Sinema",
                    "key": "sinema_title"
                },
                "status": false,
                "ana_cate": "Kültürel",
                "distance": 8201
            }
        }
    },
    "meta": {
        "request_id": "req_de24d7d7945388598826",
        "product": "control.en_yakin_sinema",
        "credits_charged": 2,
        "credits_remaining": 1499106,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 346,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-tiyatro2 kredi

En Yakın Tiyatro control.en_yakin_tiyatro

Belirtilen konuma en yakın tiyatro salonunu gösterir. Tiyatro gibi kültürel etkinlik alanları, bölgenin sosyal ve kültürel çekim gücünü artırarak nitelikli ziyaretçi trafiği oluşturur ve çevredeki ticari birimler için değer artışı potansiyeli sunar. (Teknik kontrol no 72.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-tiyatro?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-tiyatro?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 72,
        "name": "En Yakın Tiyatro",
        "group": "Lokasyon Erişim",
        "description": "Belirtilen konuma en yakın tiyatro salonunu gösterir. Tiyatro gibi kültürel etkinlik alanları, bölgenin sosyal ve kültürel çekim gücünü artırarak nitelikli ziyaretçi trafiği oluşturur ve çevredeki tic…",
        "result": {
            "tiyatro": {
                "id": 973,
                "adi": "Amfi Tiyatro",
                "lat": 41.04492201,
                "lng": 28.79655912,
                "msg": {
                    "en": "There is a Theatre at this location.",
                    "tr": "Bu konumda Tiyatro bulunmaktadır.",
                    "key": "tiyatro_status"
                },
                "cate": "Tiyatro",
                "sira": 72,
                "title": {
                    "en": "Theatre",
                    "tr": "Tiyatro",
                    "key": "tiyatro_title"
                },
                "status": false,
                "ana_cate": "Kültürel",
                "distance": 3025
            }
        }
    },
    "meta": {
        "request_id": "req_b223ba9991db7f1df7bf",
        "product": "control.en_yakin_tiyatro",
        "credits_charged": 2,
        "credits_remaining": 1499104,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 345,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-cami2 kredi

En Yakın Cami control.en_yakin_cami

Belirtilen konuma en yakın camiyi gösterir. Cami gibi düzenli ziyaret edilen ibadet alanları, bölgedeki yerleşik nüfus yoğunluğu ve süreklilik gösteren yaya trafiği hakkında önemli bir gösterge sunarak ticari potansiyelin değerlendirilmesine katkı sağlar. (Teknik kontrol no 73.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-cami?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-cami?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 73,
        "name": "En Yakın Cami",
        "group": "Lokasyon Erişim",
        "description": "Belirtilen konuma en yakın camiyi gösterir. Cami gibi düzenli ziyaret edilen ibadet alanları, bölgedeki yerleşik nüfus yoğunluğu ve süreklilik gösteren yaya trafiği hakkında önemli bir gösterge sunara…",
        "result": {
            "cami": {
                "id": 974,
                "adi": "Hacı Fatma Hanım Cami",
                "lat": 41.045029,
                "lng": 28.761607,
                "msg": {
                    "en": "There is a Mosque at this location.",
                    "tr": "Bu konumda Cami bulunmaktadır.",
                    "key": "cami_status"
                },
                "cate": "Cami",
                "sira": 73,
                "title": {
                    "en": "Mosque",
                    "tr": "Cami",
                    "key": "cami_title"
                },
                "status": false,
                "ana_cate": "Dini",
                "distance": 303
            }
        }
    },
    "meta": {
        "request_id": "req_9976d4480b76c39d5aab",
        "product": "control.en_yakin_cami",
        "credits_charged": 2,
        "credits_remaining": 1499102,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 329,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-plaj2 kredi

En Yakın Plaj control.en_yakin_plaj

Belirtilen konuma en yakın plajı gösterir. Plaj gibi doğal çekim noktaları, özellikle turizm ve sezonluk talep açısından yüksek ziyaretçi trafiği oluşturarak bölgedeki gayrimenkul değer artışı ve ticari potansiyel üzerinde olumlu etki yaratır. (Teknik kontrol no 74.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-plaj?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-plaj?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 74,
        "name": "En Yakın Plaj",
        "group": "Lokasyon Erişim",
        "description": "Belirtilen konuma en yakın plajı gösterir. Plaj gibi doğal çekim noktaları, özellikle turizm ve sezonluk talep açısından yüksek ziyaretçi trafiği oluşturarak bölgedeki gayrimenkul değer artışı ve tica…",
        "result": {
            "plaj": {
                "id": 975,
                "adi": "Tarihi haylayf plajı",
                "lat": 40.9777159,
                "lng": 28.7740802,
                "msg": {
                    "en": "There is a Beach at this location.",
                    "tr": "Bu konumda Plaj bulunmaktadır.",
                    "key": "plaj_status"
                },
                "cate": "Plaj",
                "sira": 74,
                "title": {
                    "en": "Beach",
                    "tr": "Plaj",
                    "key": "plaj_title"
                },
                "status": false,
                "ana_cate": "Eğlence",
                "distance": 7852
            }
        }
    },
    "meta": {
        "request_id": "req_82e7c183710bcae23718",
        "product": "control.en_yakin_plaj",
        "credits_charged": 2,
        "credits_remaining": 1499100,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 383,
        "version": "1.3.0"
    }
}

Kontrol · Değer ve satış analitiği

Tekil kontroller: belediye rayiç, popülerlik, satış hızları, ipotekli / ipoteksiz satış skorları.

GET/public/api/v1/technical/controls/belediye-rayic2 kredi

Belediye Rayiç control.belediye_rayic

Belediyenin esas aldığı birim değer yaklaşımıdır. Taban referans sağlar. (Teknik kontrol no 21.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/belediye-rayic?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/belediye-rayic?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 21,
        "name": "Belediye Rayiç",
        "group": "Değer & Satış Analitiği",
        "description": "Belediyenin esas aldığı birim değer yaklaşımıdır. Taban referans sağlar.",
        "result": {
            "municipal_rate": {
                "id": 880,
                "msg": {
                    "en": "This location is in the Official Municipal Rate.",
                    "tr": "Turgut Özal Blv. alanında 2015 yil rayiç 1365.72 TL/m2 bulunmaktadır.",
                    "key": "municipal_rate_false"
                },
                "sira": 21,
                "title": {
                    "en": "Municipal Rate",
                    "tr": "Belediye Rayiç",
                    "key": "municipal_rate"
                },
                "status": true,
                "distance": 130
            }
        }
    },
    "meta": {
        "request_id": "req_cd03ed623efd9092044b",
        "product": "control.belediye_rayic",
        "credits_charged": 2,
        "credits_remaining": 1499196,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 593,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/populerlik-analizi2 kredi

Popülerlik Analizi control.populerlik_analizi

Bölgeye yönelik ilgi yoğunluğunu gösterir. Talep yönünü okumaya yardımcı olur. (Teknik kontrol no 23.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/populerlik-analizi?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/populerlik-analizi?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 23,
        "name": "Popülerlik Analizi",
        "group": "Değer & Satış Analitiği",
        "description": "Bölgeye yönelik ilgi yoğunluğunu gösterir. Talep yönünü okumaya yardımcı olur.",
        "result": {
            "popularity": {
                "id": 891,
                "msg": {
                    "en": "This location is in the Popularity area.",
                    "tr": "Yüksek Popüler Seviyesine Sahip alanda bulunmaktadır.",
                    "key": "popularity_false"
                },
                "sira": 23,
                "title": {
                    "en": "Popularity Area",
                    "tr": "Popülerlik Alanı",
                    "key": "popularity"
                },
                "status": true,
                "distance": 0,
                "popularity": "Yüksek Popüler Seviyesine Sahip"
            }
        }
    },
    "meta": {
        "request_id": "req_58801faafbce218631d8",
        "product": "control.populerlik_analizi",
        "credits_charged": 2,
        "credits_remaining": 1499194,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 174,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/tarla-satis-hizi2 kredi

Tarla Satış Hızı control.tarla_satis_hizi

Tarla tipindeki taşınmazların ne kadar hızlı el değiştirdiğini gösterir. Kırsal likidite için önemlidir. (Teknik kontrol no 25.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/tarla-satis-hizi?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/tarla-satis-hizi?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 25,
        "name": "Tarla Satış Hızı",
        "group": "Değer & Satış Analitiği",
        "description": "Tarla tipindeki taşınmazların ne kadar hızlı el değiştirdiğini gösterir. Kırsal likidite için önemlidir.",
        "result": {
            "field_sales_rate": {
                "id": 892,
                "msg": {
                    "en": "The field sales speed data is not available in the relevant area.",
                    "tr": "Tarla satış hızı verisi, ilgili alanda mevcut değildir.",
                    "key": "field_sales_rate_false"
                },
                "sira": 25,
                "title": {
                    "en": "Field Sales Rate",
                    "tr": "Tarla Satış Hızı",
                    "key": "field_sales_rate"
                },
                "status": "false"
            }
        }
    },
    "meta": {
        "request_id": "req_a7bf205e6b3e4052197d",
        "product": "control.tarla_satis_hizi",
        "credits_charged": 2,
        "credits_remaining": 1499192,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 155,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/daire-satis-hizi2 kredi

Daire Satış Hızı control.daire_satis_hizi

Konut ürününün bölgede ne kadar akışkan olduğunu ölçer. Çıkış stratejisi için çok değerlidir. (Teknik kontrol no 26.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/daire-satis-hizi?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/daire-satis-hizi?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 26,
        "name": "Daire Satış Hızı",
        "group": "Değer & Satış Analitiği",
        "description": "Konut ürününün bölgede ne kadar akışkan olduğunu ölçer. Çıkış stratejisi için çok değerlidir.",
        "result": {
            "apart_sales_rate": {
                "id": 893,
                "msg": {
                    "en": "The apartment sales speed data is available in the relevant area.",
                    "tr": "Daire Satış Hızı Normal olan alanda bulunmaktadır.",
                    "key": "apart_sales_rate"
                },
                "sira": 26,
                "title": {
                    "en": "Apartment Sales Rate",
                    "tr": "Daire Satış Hızı",
                    "key": "apart_sales_rate"
                },
                "status": "true"
            }
        }
    },
    "meta": {
        "request_id": "req_62ab55b2c39515fbcc3e",
        "product": "control.daire_satis_hizi",
        "credits_charged": 2,
        "credits_remaining": 1499190,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 3712,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/isyeri-satis-hizi2 kredi

İşyeri Satış Hızı control.isyeri_satis_hizi

Ticari taşınmazların satış temposunu gösterir. Yatırımın nakde dönüş hızını etkiler. (Teknik kontrol no 27.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/isyeri-satis-hizi?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/isyeri-satis-hizi?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 27,
        "name": "İşyeri Satış Hızı",
        "group": "Değer & Satış Analitiği",
        "description": "Ticari taşınmazların satış temposunu gösterir. Yatırımın nakde dönüş hızını etkiler.",
        "result": {
            "commercial_sales_rate": {
                "id": 894,
                "msg": {
                    "en": "The commercial property sales speed data is available in the relevant area.",
                    "tr": "İşyeri Satış Hızı Hızlı olan alanda bulunmaktadır.",
                    "key": "commercial_sales_rate"
                },
                "sira": 27,
                "title": {
                    "en": "Commercial Property Sales Rate",
                    "tr": "İşyeri Satış Hızı",
                    "key": "commercial_sales_rate"
                },
                "status": "true"
            }
        }
    },
    "meta": {
        "request_id": "req_f86588a177fa8c08fcd9",
        "product": "control.isyeri_satis_hizi",
        "credits_charged": 2,
        "credits_remaining": 1499188,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 134,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/ana-tasinmaz-ipotekli-satis-skoru2 kredi

Ana Taşınmaz İpotekli Satış Skoru control.ana_tasinmaz_ipotekli_satis_skoru

Finansmanlı satış eğilimini ölçer. Krediye bağımlı piyasalarda önemli sinyaldir. (Teknik kontrol no 28.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/ana-tasinmaz-ipotekli-satis-skoru?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/ana-tasinmaz-ipotekli-satis-skoru?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 28,
        "name": "Ana Taşınmaz İpotekli Satış Skoru",
        "group": "Değer & Satış Analitiği",
        "description": "Finansmanlı satış eğilimini ölçer. Krediye bağımlı piyasalarda önemli sinyaldir.",
        "result": {
            "main_property_mortgaged_sales": {
                "id": 881,
                "msg": {
                    "en": "This location isn't in the Main Property Mortgaged Sales Area.",
                    "tr": "Ana Taşınmaz İpotekli Satış alanında bulunmamaktadır.",
                    "key": "main_property_mortgaged_sales_false"
                },
                "sira": 28,
                "title": {
                    "en": "Main Property Mortgaged Sales",
                    "tr": "Ana Taşınmaz İpotekli Satış",
                    "key": "main_property_mortgaged_sales"
                },
                "status": "false"
            }
        }
    },
    "meta": {
        "request_id": "req_8876f461dfa62a92cd43",
        "product": "control.ana_tasinmaz_ipotekli_satis_skoru",
        "credits_charged": 2,
        "credits_remaining": 1499186,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 119,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/ana-tasinmaz-ipoteksiz-satis-skoru2 kredi

Ana Taşınmaz İpoteksiz Satış Skoru control.ana_tasinmaz_ipoteksiz_satis_skoru

Nakit veya krediden bağımsız işlem gücünü yansıtır. Daha sağlıklı piyasa derinliği göstergesidir. (Teknik kontrol no 29.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/ana-tasinmaz-ipoteksiz-satis-skoru?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/ana-tasinmaz-ipoteksiz-satis-skoru?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 29,
        "name": "Ana Taşınmaz İpoteksiz Satış Skoru",
        "group": "Değer & Satış Analitiği",
        "description": "Nakit veya krediden bağımsız işlem gücünü yansıtır. Daha sağlıklı piyasa derinliği göstergesidir.",
        "result": {
            "main_property_w_mortgaged_sales": {
                "en": "This location is in the Main Property Sale Area Without Mortgage.",
                "id": 884,
                "tr": "Orta Düzey Ana Taşınmaz İpoteksiz Satış alanında bulunmaktadır.",
                "key": "main_property_w_mortgaged_sales",
                "msg": {
                    "en": "This location is in the Main Property Sale Area Without Mortgage.",
                    "tr": "Ana Taşınmaz İpoteksiz Satış alanında bulunmaktadır.",
                    "key": "main_property_w_mortgaged_sales"
                },
                "sira": 29
            }
        }
    },
    "meta": {
        "request_id": "req_bee6e1ba7449281285f7",
        "product": "control.ana_tasinmaz_ipoteksiz_satis_skoru",
        "credits_charged": 2,
        "credits_remaining": 1499184,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 135,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/bagimsiz-bolum-ipotekli-satis-skoru2 kredi

Bağımsız Bölüm İpotekli Satış Skoru control.bagimsiz_bolum_ipotekli_satis_skoru

Daire/ofis gibi bağımsız birimlerde kredi destekli satış davranışını ölçer. Konut piyasasında anlamlıdır. (Teknik kontrol no 30.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/bagimsiz-bolum-ipotekli-satis-skoru?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/bagimsiz-bolum-ipotekli-satis-skoru?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 30,
        "name": "Bağımsız Bölüm İpotekli Satış Skoru",
        "group": "Değer & Satış Analitiği",
        "description": "Daire/ofis gibi bağımsız birimlerde kredi destekli satış davranışını ölçer. Konut piyasasında anlamlıdır.",
        "result": {
            "ind_unit_sale_mortgage": {
                "id": 886,
                "msg": {
                    "en": "This location is in the Independent Unit Mortgaged Sales Area.",
                    "tr": "Orta Düzey Bağımsız Bölüm İpotekli Satış alanında bulunmaktadır.",
                    "key": "ind_unit_sale_mortgage_true"
                },
                "sira": 30,
                "title": {
                    "en": "Independent Unit Mortgage Sale",
                    "tr": "Bağımsız Bölüm İpotekli Satış",
                    "key": "ind_unit_sale_mortgage"
                },
                "status": "true"
            }
        }
    },
    "meta": {
        "request_id": "req_fab4c2ac44c7353d62a3",
        "product": "control.bagimsiz_bolum_ipotekli_satis_skoru",
        "credits_charged": 2,
        "credits_remaining": 1499182,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 129,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/bagimsiz-bolum-ipoteksiz-satis-skoru2 kredi

Bağımsız Bölüm İpoteksiz Satış Skoru control.bagimsiz_bolum_ipoteksiz_satis_skoru

Bağımsız bölümlerde nakit ağırlıklı talebi yansıtır. Güçlü yatırımcı iştahını gösterir. (Teknik kontrol no 31.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/bagimsiz-bolum-ipoteksiz-satis-skoru?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/bagimsiz-bolum-ipoteksiz-satis-skoru?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 31,
        "name": "Bağımsız Bölüm İpoteksiz Satış Skoru",
        "group": "Değer & Satış Analitiği",
        "description": "Bağımsız bölümlerde nakit ağırlıklı talebi yansıtır. Güçlü yatırımcı iştahını gösterir.",
        "result": {
            "ind_unit_sale_w_mortgage": {
                "id": 885,
                "msg": {
                    "en": "This location is in the Independent Unit Sale Area Without Mortgage.",
                    "tr": "Orta Düzey Bağımsız Bölüm İpoteksiz Satış alanında bulunmaktadır.",
                    "key": "ind_unit_sale_w_mortgage_true"
                },
                "sira": 31,
                "title": {
                    "en": "Independent Unit Sale Without Mortgage",
                    "tr": "Bağımsız Bölüm İpoteksiz Satış",
                    "key": "ind_unit_sale_w_mortgage"
                },
                "status": "true"
            }
        }
    },
    "meta": {
        "request_id": "req_1c3eaadd4ba340f0448c",
        "product": "control.bagimsiz_bolum_ipoteksiz_satis_skoru",
        "credits_charged": 2,
        "credits_remaining": 1499180,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 137,
        "version": "1.3.0"
    }
}

Kontrol · Destekleyici veriler

Tekil kontroller: altlık parseller, şehir atlası, TKGM satış alanı, lokasyon bilgisi, Resmî Gazete (2 km), en yakın noktalar.

GET/public/api/v1/technical/controls/altlik-parseller2 kredi

Altlık Parseller control.altlik_parseller

Referans parsel katmanıdır. Komşuluk ve sınır okumasında yardımcı olur. (Teknik kontrol no 56.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/altlik-parseller?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/altlik-parseller?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 56,
        "name": "Altlık Parseller",
        "group": "Diğer/Destekleyici Veriler",
        "description": "Referans parsel katmanıdır. Komşuluk ve sınır okumasında yardımcı olur.",
        "result": {
            "parcels": {
                "id": 887,
                "msg": {
                    "en": "There are parcels within a 500-meter radius of the parcel.",
                    "tr": "Parselin 500 metre çevresinde parseller bulunmaktadır.",
                    "key": "parcels"
                },
                "sira": 56,
                "title": {
                    "en": "Parcels",
                    "tr": "Parseller",
                    "key": "parcels"
                },
                "status": true,
                "parcels": [
                    {
                        "p": 50927385033614,
                        "ilid": 56,
                        "adano": 801,
                        "mahid": 146060,
                        "ilceid": 524,
                        "nitelik": "27 blok tamam diğerleri natamam 35 blok betonarme apartman ve arsasi",
                        "parselno": 21,
                        "yuzolcum_int": 124201
                    },
                    {
                        "p": 50927370717891,
                        "ilid": 56,
                        "adano": 800,
                        "mahid": 146060,
                        "ilceid": 524,
                        "nitelik": "12 bloklu kargir apartman",
                        "parselno": 8,
                        "yuzolcum_int": 51662.63
                    },
                    {
                        "p": 50927385259703,
                        "ilid": 56,
                        "adano": 800,
                        "mahid": 146060,
                        "ilceid": 524,
                        "nitelik": "arsa(ortaöğretim tesis alani)",
                        "parselno": 3,
                        "yuzolcum_int": 15692.29
                    },
                    "… (242 öğe daha)"
                ]
            }
        }
    },
    "meta": {
        "request_id": "req_746df5b7bb7a798dd778",
        "product": "control.altlik_parseller",
        "credits_charged": 2,
        "credits_remaining": 1499130,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 203,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/sehir-atlasi-tucbs2 kredi

Şehir Atlası TUCBS control.sehir_atlasi_tucbs

Bölgesel veri ve katmanları bir araya getiren genel analiz ekranıdır. Makro bakış sağlar. (Teknik kontrol no 59.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/sehir-atlasi-tucbs?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/sehir-atlasi-tucbs?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 59,
        "name": "Şehir Atlası TUCBS",
        "group": "Diğer/Destekleyici Veriler",
        "description": "Bölgesel veri ve katmanları bir araya getiren genel analiz ekranıdır. Makro bakış sağlar.",
        "result": {
            "city_atlas": {
                "id": 895,
                "msg": {
                    "en": "The City Atlas data for this layer is available in the relevant area.",
                    "tr": "Seçili parsel Orta Yoğunluklu Süreksiz Kentsel Alan (30% - 50%) alanında bulunmaktadır.",
                    "key": "city_atlas_true"
                },
                "alan": 166860.95,
                "geom": {
                    "type": "MultiPolygon",
                    "coordinates": "… (koordinat dizisi kısaltıldı)"
                },
                "sira": 59,
                "title": {
                    "en": "City Atlas",
                    "tr": "Şehir Atlası",
                    "key": "city_atlas"
                },
                "status": "true",
                "aciklama": "Orta Yoğunluklu Süreksiz Kentsel Alan (30% - 50%), genellikle konut kullanımı amacıyla ayrılmış yerleşim bölgelerini ifade eder. İmar planlarında bu alanlar çoğunlukla Orta Yoğunluklu Konut Alanı olar…"
            }
        }
    },
    "meta": {
        "request_id": "req_dd99dd1ac16e71789797",
        "product": "control.sehir_atlasi_tucbs",
        "credits_charged": 2,
        "credits_remaining": 1499128,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 141,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/sehir-atlasi-tuvimer2 kredi

Şehir Atlası Tuvimer control.sehir_atlasi_tuvimer

Bölgesel veri ve katmanları bir araya getiren genel analiz ekranıdır. Makro bakış sağlar. (Teknik kontrol no 60.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/sehir-atlasi-tuvimer?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/sehir-atlasi-tuvimer?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 60,
        "name": "Şehir Atlası Tuvimer",
        "group": "Diğer/Destekleyici Veriler",
        "description": "Bölgesel veri ve katmanları bir araya getiren genel analiz ekranıdır. Makro bakış sağlar.",
        "result": [
            {
                "city_atlas_yeni": {
                    "id": 897,
                    "msg": {
                        "en": "The City Atlas data for this layer is available in the relevant area.",
                        "tr": "Seçili parsel Orta Yoğunluklu Süreksiz Kentsel Alan (30% - 50%) alanında bulunmaktadır.",
                        "key": "city_atlas_yeni_true"
                    },
                    "alan": 77474.66,
                    "geom": {
                        "type": "MultiPolygon",
                        "coordinates": "… (koordinat dizisi kısaltıldı)"
                    },
                    "sira": 60,
                    "title": {
                        "en": "City Atlas",
                        "tr": "Şehir Atlası",
                        "key": "city_atlas_yeni"
                    },
                    "status": "true",
                    "aciklama": "Orta Yoğunluklu Süreksiz Kentsel Alan (30% - 50%), genellikle konut kullanımı amacıyla ayrılmış yerleşim bölgelerini ifade eder. İmar planlarında bu alanlar çoğunlukla Orta Yoğunluklu Konut Alanı olar…"
                }
            },
            {
                "city_atlas_yeni": {
                    "id": 897,
                    "msg": {
                        "en": "The City Atlas data for this layer is available in the relevant area.",
                        "tr": "Seçili parsel Orta Yoğunluklu Süreksiz Kentsel Alan (30% - 50%) alanında bulunmaktadır.",
                        "key": "city_atlas_yeni_true"
                    },
                    "alan": 67533.35,
                    "geom": {
                        "type": "MultiPolygon",
                        "coordinates": "… (koordinat dizisi kısaltıldı)"
                    },
                    "sira": 60,
                    "title": {
                        "en": "City Atlas",
                        "tr": "Şehir Atlası",
                        "key": "city_atlas_yeni"
                    },
                    "status": "true",
                    "aciklama": "Orta Yoğunluklu Süreksiz Kentsel Alan (30% - 50%), genellikle konut kullanımı amacıyla ayrılmış yerleşim bölgelerini ifade eder. İmar planlarında bu alanlar çoğunlukla Orta Yoğunluklu Konut Alanı olar…"
                }
            },
            {
                "city_atlas_yeni": {
                    "id": 897,
                    "msg": {
                        "en": "The City Atlas data for this layer is available in the relevant area.",
                        "tr": "Seçili parsel Orta Yoğunluklu Süreksiz Kentsel Alan (30% - 50%) alanında bulunmaktadır.",
                        "key": "city_atlas_yeni_true"
                    },
                    "alan": 166860.95,
                    "geom": {
                        "type": "MultiPolygon",
                        "coordinates": "… (koordinat dizisi kısaltıldı)"
                    },
                    "sira": 60,
                    "title": {
                        "en": "City Atlas",
                        "tr": "Şehir Atlası",
                        "key": "city_atlas_yeni"
                    },
                    "status": "true",
                    "aciklama": "Orta Yoğunluklu Süreksiz Kentsel Alan (30% - 50%), genellikle konut kullanımı amacıyla ayrılmış yerleşim bölgelerini ifade eder. İmar planlarında bu alanlar çoğunlukla Orta Yoğunluklu Konut Alanı olar…"
                }
            },
            "… (11 öğe daha)"
        ]
    },
    "meta": {
        "request_id": "req_22d21fbf085bfe9d0d3c",
        "product": "control.sehir_atlasi_tuvimer",
        "credits_charged": 2,
        "credits_remaining": 1499126,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 166,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/tkgm-satis-alani2 kredi

TKGM Satış Alanı control.tkgm_satis_alani

Tapu Kadastro satış verisiyle ilişkili alan bilgisidir. Resmî işlem yoğunluğu görmek için destekleyicidir. (Teknik kontrol no 61.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/tkgm-satis-alani?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/tkgm-satis-alani?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 61,
        "name": "TKGM Satış Alanı",
        "group": "Diğer/Destekleyici Veriler",
        "description": "Tapu Kadastro satış verisiyle ilişkili alan bilgisidir. Resmî işlem yoğunluğu görmek için destekleyicidir.",
        "result": {
            "tkgm_satis": {
                "id": 865,
                "msg": {
                    "en": "This location is in the TKGM Sales area.",
                    "tr": "500 metre çevresinde Ana Taşınmaz Satışı bulunmaktadır.",
                    "key": "tkgm_satis_false"
                },
                "sira": 61,
                "title": {
                    "en": "TKGM Sales Area",
                    "tr": "TKGM Satış Alanı",
                    "key": "tkgm_satis"
                },
                "status": true,
                "distance": 0,
                "tkgm_satis": "Ana Taşınmaz Satış"
            }
        }
    },
    "meta": {
        "request_id": "req_1902696d6d7e8164db22",
        "product": "control.tkgm_satis_alani",
        "credits_charged": 2,
        "credits_remaining": 1499124,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 151,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/lokasyon-bilgisi2 kredi

Lokasyon Bilgisi control.lokasyon_bilgisi

Lokasyona ait coğrafi ve mekansal analiz sonuçlarını içerir. Bölgesel konum, yakınlık ve çevresel etkileşim gibi kriterlerin değerlendirilmesini sağlar. (Teknik kontrol no 62.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/lokasyon-bilgisi?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/lokasyon-bilgisi?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 62,
        "name": "Lokasyon Bilgisi",
        "group": "Diğer/Destekleyici Veriler",
        "description": "Lokasyona ait coğrafi ve mekansal analiz sonuçlarını içerir. Bölgesel konum, yakınlık ve çevresel etkileşim gibi kriterlerin değerlendirilmesini sağlar.",
        "result": {
            "queried": {
                "id": 961,
                "msg": {
                    "en": "Spatial analysis results for this location are displayed.",
                    "tr": "Bu lokasyonun mekansal analiz sonuçları gösterilmektedir.",
                    "key": "queried_true"
                },
                "data": {
                    "hex2": 202272340,
                    "hex3": 300570746,
                    "hex4": 400143861,
                    "hex5": 500036431,
                    "hex6": 600009341,
                    "hex7": 700002406,
                    "hex8": 800001425,
                    "f_key": "d665b7b5722d3ce50011fccb87b3d19b",
                    "ada_no": 800,
                    "kds_id": 50927385482858,
                    "kds_il": 56,
                    "kds_lat": 41.047925,
                    "kds_lng": 28.760457073170734,
                    "kds_mah": 146060,
                    "kds_old": [
                        {
                            "id": 50927380692521,
                            "rn": 83,
                            "oid": 50927380692521,
                            "st_x": 28.760457073170734,
                            "st_y": 41.047925,
                            "durum": 1,
                            "il_id": 56,
                            "pafta": "F21c21a1b",
                            "ada_no": 800,
                            "i_user": 385108,
                            "il_adi": "İstanbul",
                            "mevkii": "Menekşe",
                            "counter": null,
                            "ilce_id": 524,
                            "nitelik": "61 blok betonamre apartman ve arsası",
                            "data_md5": "b6ca38fa5996bcc5a9f4cd97faecc3e9",
                            "ilce_adi": "Küçükçekmece",
                            "on_query": null,
                            "yuzolcum": 246092.58,
                            "zemin_id": null,
                            "geom_alan": 245909,
                            "parsel_id": 50927380692521,
                            "parsel_no": 4,
                            "check_date": null,
                            "is_current": true,
                            "mahalle_id": 146060,
                            "mahalle_adi": "Halkalı",
                            "record_date": "2026-08-24T11:56:55.221322",
                            "yuzolcum_int": 246092.58,
                            "zemin_km_durum": "Kat Mülkiyet",
                            "t_004_parcels_id": null,
                            "on_query_start_time": null
                        }
                    ],
                    "nitelik": "61 blok betonamre apartman ve arsası",
                    "queried": {
                        "p_lat": 41.047684375057,
                        "p_lng": 28.760775996083
                    },
                    "idari_il": 34,
                    "kds_ilce": 524,
                    "idari_mah": 33891,
                    "kds_pafta": null,
                    "parsel_no": 4,
                    "idari_ilce": 1823,
                    "kds_il_adi": "İstanbul",
                    "parsel_ids": [
                        50927385482858,
                        50927385440367,
                        50927385437206,
                        "… (80 öğe daha)"
                    ],
                    "kds_nitelik": "61 blok betonamre apartman ve arsası",
                    "kds_ilce_adi": "Küçükçekmece",
                    "yuzolcum_int": 246092.58,
                    "idari_il_name": "İstanbul",
                    "kds_parsel_id": 50927385482858,
                    "idari_ilce_name": "Küçükçekmece",
                    "kds_mahalle_adi": "Halkalı",
                    "idari_mahkoy_name": "Atakent Mh."
                },
                "sira": 62,
                "title": {
                    "en": "Location Details",
                    "tr": "Lokasyon Bilgisi",
                    "key": "queried"
                },
                "status": "true"
            }
        }
    },
    "meta": {
        "request_id": "req_0937607217da4a6083c9",
        "product": "control.lokasyon_bilgisi",
        "credits_charged": 2,
        "credits_remaining": 1499122,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 143,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/resmi-gazete-karari2 kredi

Resmî Gazete Kararı (2 km) control.resmi_gazete_karari

Merkezi idare kararıyla özel hükümlere tabi olabilecek alanları gösterir. Ani statü değişimi yaratabilir. (Teknik kontrol no 63.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/resmi-gazete-karari?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/resmi-gazete-karari?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 63,
        "name": "Resmî Gazete Kararı (2 km)",
        "group": "Diğer/Destekleyici Veriler",
        "description": "Merkezi idare kararıyla özel hükümlere tabi olabilecek alanları gösterir. Ani statü değişimi yaratabilir.",
        "result": {
            "rg_new": {
                "id": 962,
                "msg": {
                    "en": "There is no Official Gazette decision within a 2-kilometer radius.",
                    "tr": "2 kilometre içinde Resmî Gazete kararı bulunmamaktadır.",
                    "key": "rg_new_false"
                },
                "data": {
                    "Özet": null,
                    "Karar_no": null,
                    "Page_url": null,
                    "Karar_tarihi": null
                },
                "sira": 63,
                "title": {
                    "en": "Official Gazette Decision Area",
                    "tr": "Resmî Gazete Kararı Kapsamındaki Alan",
                    "key": "rg_new"
                },
                "status": "false",
                "distance": null
            }
        }
    },
    "meta": {
        "request_id": "req_74a2ecc6efd631fc774e",
        "product": "control.resmi_gazete_karari",
        "credits_charged": 2,
        "credits_remaining": 1499120,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 203,
        "version": "1.3.0"
    }
}
GET/public/api/v1/technical/controls/en-yakin-noktalar-analizi2 kredi

En Yakın Noktalar Analizi control.en_yakin_noktalar_analizi

Belirtilen konum çevresindeki tüm önemli ticari, sosyal ve günlük yaşam noktalarını mesafe bazlı olarak listeler. Bölgenin erişilebilirlik seviyesi, yaya hareketliliği ve çevresel olanakları hakkında bütüncül bir görünüm sunarak yatırım kararlarının daha sağlıklı değerlendirilmesine katkı sağlar. (Teknik kontrol no 75.)

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (bkz. /v1/products → subcategories). Varsayılan: 10010.10010
resolution seçenek: 2, 3, 4, 5, 6, 7Hexagon çözünürlüğü (bölgesel kontrollerde). Varsayılan: 5.5
curl -s "https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-noktalar-analizi?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/technical/controls/en-yakin-noktalar-analizi?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "control": 75,
        "name": "En Yakın Noktalar Analizi",
        "group": "Diğer / Destekleyici Veriler",
        "description": "Belirtilen konum çevresindeki tüm önemli ticari, sosyal ve günlük yaşam noktalarını mesafe bazlı olarak listeler. Bölgenin erişilebilirlik seviyesi, yaya hareketliliği ve çevresel olanakları hakkında …",
        "result": [
            {
                "poi": {
                    "id": 976,
                    "lat": 41.04859924316406,
                    "lng": 28.765300750732422,
                    "msg": {
                        "en": "Nearby locations are listed.",
                        "tr": "Belirtilen konumda Kooperatif/Site bulunmaktadır.",
                        "key": "poi_true"
                    },
                    "name": "Tema İstanbul",
                    "sira": 75,
                    "title": {
                        "en": "Nearest Points",
                        "tr": "En Yakın Noktalar",
                        "key": "poi"
                    },
                    "status": "true",
                    "category": "Kooperatif/Site",
                    "distance": 394
                }
            },
            {
                "poi": {
                    "id": 976,
                    "lat": 41.04495297,
                    "lng": 28.76152788,
                    "msg": {
                        "en": "Nearby locations are listed.",
                        "tr": "Belirtilen konumda Cami bulunmaktadır.",
                        "key": "poi_true"
                    },
                    "name": "Hacı Fatma Hanım Cami",
                    "sira": 75,
                    "title": {
                        "en": "Nearest Points",
                        "tr": "En Yakın Noktalar",
                        "key": "poi"
                    },
                    "status": "true",
                    "category": "Cami",
                    "distance": 310
                }
            },
            {
                "poi": {
                    "id": 976,
                    "lat": 41.06180672,
                    "lng": 28.71553814,
                    "msg": {
                        "en": "Nearby locations are listed.",
                        "tr": "Belirtilen konumda Fuar Merkezi bulunmaktadır.",
                        "key": "poi_true"
                    },
                    "name": "Ispartakule Fuar Ve Sergi Merkezi",
                    "sira": 75,
                    "title": {
                        "en": "Nearest Points",
                        "tr": "En Yakın Noktalar",
                        "key": "poi"
                    },
                    "status": "true",
                    "category": "Fuar Merkezi",
                    "distance": 4114
                }
            },
            "… (49 öğe daha)"
        ]
    },
    "meta": {
        "request_id": "req_adf46bd3c4bd0cbcd358",
        "product": "control.en_yakin_noktalar_analizi",
        "credits_charged": 2,
        "credits_remaining": 1499098,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 14060,
        "version": "1.3.0"
    }
}

Çevre ve erişim

Çevredeki donatılar (ulaşım, eğitim, sağlık …), POI yoğunluğu, tapu satış dağılımı, talep yoğunluğu, veri katmanları.

GET/public/api/v1/accessibility3 kredi

Erişilebilirlik özeti accessibility.summary

Ulaşım, eğitim, sağlık, alışveriş, yeme-içme, yeşil alan … türlerinde 250 m / 900 m / 3 km içindeki donatı adetleri, en yakın donatının türü, mesafesi ve yürüme süresi.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
curl -s "https://www.ai.tapusor.com/public/api/v1/accessibility?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/accessibility?lat=41.04768437505737&lng=28.760775996083126
{
    "data": {
        "lat": 41.047684375057,
        "lng": 28.760775996083,
        "radii_m": [
            250,
            900,
            3000
        ],
        "walk_min": [
            3,
            11,
            38
        ],
        "types": [
            {
                "type": "Ulaşım",
                "essential": true,
                "counts": {
                    "250m": 1,
                    "900m": 35,
                    "3000m": 300
                },
                "nearest": {
                    "subtype": "Taksi Durağı",
                    "distance_m": 127,
                    "walk_min": 2
                }
            },
            {
                "type": "Eğitim",
                "essential": true,
                "counts": {
                    "250m": 0,
                    "900m": 28,
                    "3000m": 325
                },
                "nearest": {
                    "subtype": "Anaokulu",
                    "distance_m": 324,
                    "walk_min": 5
                }
            },
            {
                "type": "Sağlık",
                "essential": true,
                "counts": {
                    "250m": 4,
                    "900m": 30,
                    "3000m": 202
                },
                "nearest": {
                    "subtype": "Eczane",
                    "distance_m": 25,
                    "walk_min": 1
                }
            },
            "… (8 öğe daha)"
        ],
        "essential_types": 9,
        "essential_covered": {
            "250m": 6,
            "900m": 9,
            "3000m": 9
        }
    },
    "meta": {
        "request_id": "req_4be8fbf4f407d1d21125",
        "product": "accessibility.summary",
        "credits_charged": 3,
        "credits_remaining": 1499310,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 169,
        "version": "1.3.0"
    }
}
GET/public/api/v1/poi/area2 kredi

Bölge donatı özeti poi.area

İl / ilçe / mahalle ya da hexagon hücresindeki donatıların kategori ve alt kategori dağılımı, alan (km²) ve nüfus.

ParametreTürAçıklamaÖrnek
level zorunlu seçenek: il, ilce, mah, hex2, hex3, hex4, hex5, hex6, hex7Düzey.mah
id zorunlu tamsayıBölge / hücre kimliği (/v1/locations/resolve: idari_* ya da hex*).33593
curl -s "https://www.ai.tapusor.com/public/api/v1/poi/area?level=mah&id=33593" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — level mah · id 33891 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/poi/area?level=mah&id=33891
{
    "data": {
        "level": "mah",
        "id": 33891,
        "area": {
            "name": "Atakent Mh.",
            "parent": "Küçükçekmece, İstanbul",
            "km2": 8.38,
            "population": 82947
        },
        "total": 1857,
        "by_category": {
            "Hizmet": 312,
            "Yeme - İçme": 265,
            "Sosyal & Kültürel Tesis": 253,
            "Eğitim": 217,
            "Ulaşım": 207,
            "Alışveriş": 193,
            "Yeşil Alanlar": 121,
            "Konut Alanları": 116,
            "Sağlık": 87,
            "Diğer": 70,
            "Kamu & Resmi Kurum": 16
        },
        "top_subcategories": [
            {
                "subcategory": "Spor Tesisi",
                "category": "Sosyal & Kültürel Tesis",
                "count": 216
            },
            {
                "subcategory": "Toplu Taşıma",
                "category": "Ulaşım",
                "count": 146
            },
            {
                "subcategory": "Park & Bahçe",
                "category": "Yeşil Alanlar",
                "count": 118
            },
            "… (12 öğe daha)"
        ]
    },
    "meta": {
        "request_id": "req_2e7c70b96a5e0d0aabbe",
        "product": "poi.area",
        "credits_charged": 2,
        "credits_remaining": 1499251,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 138,
        "version": "1.3.0"
    }
}
GET/public/api/v1/sales/nearby2 kredi

Yakındaki tapu satışları sales.nearby

Yarıçap içindeki TKGM satışlarının yıl × işlem türü dağılımı ve noktanın idari birimleri (tekil satış konumu dönmez).

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
radius tamsayı (100–2000)Yarıçap (m). Varsayılan: 500.500
years tamsayı listesi (1990–2100)Yıllar (virgülle; boşsa hepsi).2023,2024,2025
curl -s "https://www.ai.tapusor.com/public/api/v1/sales/nearby?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/sales/nearby?lat=41.04768437505737&lng=28.760775996083126&radius=500&years=2023%2C2024%2C2025
{
    "data": {
        "lat": 41.047684375057,
        "lng": 28.760775996083,
        "radius_m": 500,
        "total": 637,
        "by_year": {
            "2023": 191,
            "2024": 243,
            "2025": 203
        },
        "by_type": {
            "Ana Taşınmaz Satış": 52,
            "Ana Taşınmaz İpotekli Satış": 2,
            "Bağımsız Bölüm Satış": 481,
            "Bağımsız Bölüm İpotekli Satış": 102
        },
        "by_year_type": [
            {
                "year": 2023,
                "type": "Ana Taşınmaz Satış",
                "count": 15
            },
            {
                "year": 2024,
                "type": "Ana Taşınmaz Satış",
                "count": 18
            },
            {
                "year": 2025,
                "type": "Ana Taşınmaz İpotekli Satış",
                "count": 2
            },
            "… (7 öğe daha)"
        ],
        "sources": {
            "2010-2020": "TKGM satış arşivi (kayıt sayısı)",
            "2021+": "TKGM işlem verisi (işlem sayısı)"
        },
        "areas": [
            {
                "level": "il",
                "id": 34,
                "name": "İstanbul",
                "parent": null,
                "km2": 5442.89,
                "population": 14657433
            },
            {
                "level": "ilce",
                "id": 1823,
                "name": "Küçükçekmece",
                "parent": "İstanbul",
                "km2": 44.97,
                "population": 761064
            },
            {
                "level": "mah",
                "id": 33891,
                "name": "Atakent Mh.",
                "parent": "Küçükçekmece, İstanbul",
                "km2": 8.38,
                "population": 82947
            }
        ]
    },
    "meta": {
        "request_id": "req_ornek",
        "product": "sales.nearby",
        "credits_charged": 2,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}
GET/public/api/v1/sales/area2 kredi

Bölge tapu satış özeti sales.area

İl / ilçe / mahalle ya da hexagon hücresinde yıl × işlem türü TKGM satış adetleri, alan ve nüfus.

ParametreTürAçıklamaÖrnek
level zorunlu seçenek: il, ilce, mah, hex2, hex3, hex4, hex5, hex6, hex7Düzey.ilce
id zorunlu tamsayıBölge / hücre kimliği (/v1/sales/nearby → areas).1186
curl -s "https://www.ai.tapusor.com/public/api/v1/sales/area?level=ilce&id=1186" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — level ilce · id 1823 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/sales/area?level=ilce&id=1823
{
    "data": {
        "level": "ilce",
        "id": 1823,
        "area": {
            "name": "Küçükçekmece",
            "parent": "İstanbul",
            "km2": 44.97,
            "population": 761064
        },
        "total": 95466,
        "by_year": {
            "2010": 5475,
            "2011": 6174,
            "2012": 5947,
            "2013": 6847,
            "2014": 7002,
            "2015": 7167,
            "2016": 7104,
            "2017": 6982,
            "2018": 6577,
            "2019": 2073,
            "2020": 6869,
            "2021": 7092,
            "2022": 6537,
            "2023": 5817,
            "2024": 6489,
            "2025": 1314
        },
        "by_type": {
            "Ana Taşınmaz Satış": 39631,
            "Ana Taşınmaz İpotekli Satış": 198,
            "Bağımsız Bölüm Satış": 30799,
            "Bağımsız Bölüm İpotekli Satış": 24838
        },
        "by_year_type": [
            {
                "year": 2010,
                "type": "Ana Taşınmaz Satış",
                "count": 2609
            },
            {
                "year": 2010,
                "type": "Ana Taşınmaz İpotekli Satış",
                "count": 21
            },
            {
                "year": 2010,
                "type": "Bağımsız Bölüm Satış",
                "count": 1370
            },
            "… (56 öğe daha)"
        ]
    },
    "meta": {
        "request_id": "req_348c87fce988a26c7f9f",
        "product": "sales.area",
        "credits_charged": 2,
        "credits_remaining": 1499247,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 135,
        "version": "1.3.0"
    }
}
GET/public/api/v1/demand/map3 kredi

Talep yoğunluğu demand.map

Platformdaki alım / kiralama / satış / kiraya verme taleplerinin il ya da ilçe bazında adetleri (en az 5 talep olan bölgeler).

ParametreTürAçıklamaÖrnek
type seçenek: 0, 1, 2, 3, 40 hepsi · 1 satılık arıyor · 2 kiralık arıyor · 3 satmak istiyor · 4 kiraya vermek istiyor. Varsayılan: 0.1
days seçenek: 0, 7, 30, 90, 365Son kaç gün (0 = tümü). Varsayılan: 0.90
province tamsayı (0–81)İl plaka kodu (0 = Türkiye). Varsayılan: 0.34
level seçenek: il, ilceDüzey. Varsayılan: il.ilce
curl -s "https://www.ai.tapusor.com/public/api/v1/demand/map" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — level ilce · province 34 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/demand/map?level=ilce&province=34&days=365
{
    "data": {
        "level": "ilce",
        "cells": [
            {
                "pid": 34,
                "il": "İstanbul",
                "did": 1622,
                "ilce": "Silivri",
                "n": 27,
                "t1": 6,
                "t2": 0,
                "t3": 21,
                "t4": 0,
                "son": "2026-09-15"
            },
            {
                "pid": 34,
                "il": "İstanbul",
                "did": 2048,
                "ilce": "Arnavutköy",
                "n": 27,
                "t1": 14,
                "t2": 0,
                "t3": 13,
                "t4": 0,
                "son": "2026-07-11"
            },
            {
                "pid": 34,
                "il": "İstanbul",
                "did": 1237,
                "ilce": "Çatalca",
                "n": 19,
                "t1": 2,
                "t2": 0,
                "t3": 17,
                "t4": 0,
                "son": "2026-09-28"
            },
            "… (18 öğe daha)"
        ]
    },
    "meta": {
        "request_id": "req_5c281c368ca6c309e0e4",
        "product": "demand.map",
        "credits_charged": 3,
        "credits_remaining": 1499244,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 128,
        "version": "1.3.0"
    }
}
GET/public/api/v1/layers/summary3 kredi

Katman özeti (alan içi) layers.summary

Alandaki imar planı, 1/1000 plan fonksiyonu, tapu satışı, donatı ya da haber / şikâyet kayıtlarının yıl × tür adetleri.

ParametreTürAçıklamaÖrnek
dataset zorunlu seçenek: eplan, imar_parsel, tkgm_satis, poi, haber_sikayetVeri seti.tkgm_satis
bbox zorunlu alan (bbox)Alan: batı,güney,doğu,kuzey (derece).28.95,41.00,29.02,41.05
zoom tamsayı (9–18)Harita yakınlığı (alan genişliği sınırı: 14400 / 2^zoom derece). Varsayılan: 13.13
categories tamsayı listesi (0–999)Tür kodları (boşsa hepsi).1,2
year_from tamsayı (2000–2030)Başlangıç yılı.2022
year_to tamsayı (2000–2030)Bitiş yılı.2025
curl -s "https://www.ai.tapusor.com/public/api/v1/layers/summary?dataset=tkgm_satis&bbox=28.95%2C41.00%2C29.02%2C41.05" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/layers/summary?dataset=tkgm_satis&bbox=28.7408%2C41.0327%2C28.7808%2C41.0627
{
    "data": [
        {
            "yr": 2010,
            "c": 2,
            "n": 90
        },
        {
            "yr": 2010,
            "c": 3,
            "n": 2
        },
        {
            "yr": 2010,
            "c": 4,
            "n": 42
        },
        "… (48 öğe daha)"
    ],
    "meta": {
        "request_id": "req_1aeeec5e328ba71e6354",
        "product": "layers.summary",
        "credits_charged": 3,
        "credits_remaining": 1499241,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 89,
        "version": "1.3.0"
    }
}
GET/public/api/v1/layers/plans3 kredi

Alandaki imar planları layers.plans

Alandaki e-Plan imar planları ya da 1/1000 plan fonksiyonlu parseller: başlık, tür, il / ilçe, tarih (en çok 50).

ParametreTürAçıklamaÖrnek
dataset zorunlu seçenek: eplan, imar_parseleplan (planlar) ya da imar_parsel (parsel plan fonksiyonu).eplan
bbox zorunlu alan (bbox)Alan: batı,güney,doğu,kuzey (derece).28.95,41.00,29.02,41.05
zoom tamsayı (9–18)Harita yakınlığı. Varsayılan: 14.14
categories tamsayı listesi (0–9)eplan: 1 nazım, 2 uygulama, 3 çevre düzeni, 0 diğer · imar_parsel: 1 konut, 2 ticaret, 3 sanayi, 4 turizm, 5 karma, 0 diğer.1,2
curl -s "https://www.ai.tapusor.com/public/api/v1/layers/plans?dataset=eplan&bbox=28.95%2C41.00%2C29.02%2C41.05" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/layers/plans?dataset=eplan&bbox=28.7108%2C41.0077%2C28.8108%2C41.0877
{
    "data": [
        {
            "title": "İSTANBUL İLİ, KÜÇÜKÇEKMECE İLÇESİ, HALKALI MAHALLESİ, 316 ADA 1, 2, 3, 14, 15, 16 VE 17 NUMARALI PARSELLER REZERV YAPI ALANINA İLİŞKİN 1/1000 ÖLÇEKLİ UİP DEĞİŞİKLİĞİ TEKLİFİ",
            "kategori": "Uygulama İmar Planı",
            "alt_kategori": "İstanbul / Küçükçekmece",
            "tarih": "2026-06-26",
            "url": null,
            "kaynak": "e-Plan",
            "url_text": null,
            "c": 2
        },
        {
            "title": "İSTANBUL İLİ, KÜÇÜKÇEKMECE İLÇESİ, HALKALI MAHALLESİ, 0 ADA 291, 292 PARSELLER İLE 293 PARSELİN BİR KISMINA İLİŞKİN REZERV YAPI ALANINA YÖNELİK 1/1000 ÖLÇEKLİ UİP, PLAN NOTU DEĞİŞİKLİĞİ TEKLİFİ",
            "kategori": "Uygulama İmar Planı",
            "alt_kategori": "İstanbul / Küçükçekmece",
            "tarih": "2026-06-26",
            "url": null,
            "kaynak": "e-Plan",
            "url_text": null,
            "c": 2
        },
        {
            "title": "KÜÇÜKÇEKMECE İLÇESİ, ATAKENT MAHALLESİ 824 ADA 1 PARSELİN DOĞUSUNDAKİ TESCİL DIŞI ALANA İLİŞKİN 1/1000 ÖLÇEKLİ UYGULAMA İMAR PLANI DEĞİŞİKLİĞİ",
            "kategori": "Uygulama İmar Planı",
            "alt_kategori": "İstanbul / Küçükçekmece",
            "tarih": "2026-04-16",
            "url": null,
            "kaynak": "e-Plan",
            "url_text": null,
            "c": 2
        }
    ],
    "meta": {
        "request_id": "req_a94cb095884a0e820033",
        "product": "layers.plans",
        "credits_charged": 3,
        "credits_remaining": 1499238,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 88,
        "version": "1.3.0"
    }
}

Bölge analizi

Etki alanı (catchment) analizi: halkalar içinde nüfus, ilan yoğunluğu, tapu satışları.

GET/public/api/v1/catchment5 kredi

Etki alanı analizi catchment

Merkez etrafında en çok 3 halkada nüfus, ilan yoğunluğu ya da tapu satışı (yıl × tür adetleri).

ParametreTürAçıklamaÖrnek
dataset zorunlu seçenek: nufus, ilan_bolge, tkgm_satis, poi, haber_sikayet, eplan, imar_parselVeri seti: nufus (nüfus), ilan_bolge (ilan yoğunluğu), tkgm_satis (tapu satışları), poi (donatılar), haber_sikayet (haber / şikâyet adedi), eplan (imar planları), imar_parsel (1/1000 plan fonksiyonu).nufus
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
radii zorunlu tamsayı listesi (100–20000)Halka yarıçapları (m), artan, en çok 3 (tkgm_satis için en çok 5.000).500,1000,2000
year_from tamsayı (2000–2030)Başlangıç yılı (yıllı veri setlerinde).2022
year_to tamsayı (2000–2030)Bitiş yılı.2025
categories tamsayı listesi (0–999)Tür kodları (veri setine göre; boşsa hepsi).1,2
subcategories seçenek: 0, 1poi için alt kategori kırılımı (1 = ekle). Varsayılan: 0.1
curl -s "https://www.ai.tapusor.com/public/api/v1/catchment?dataset=nufus&lat=41.0369&lng=28.985&radii=500%2C1000%2C2000" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/catchment?lat=41.04768437505737&lng=28.760775996083126&dataset=nufus&radii=500%2C1000%2C2000
{
    "data": {
        "ds": "nufus",
        "lat": 41.047684375057,
        "lng": 28.760775996083,
        "r": [
            500,
            1000,
            2000
        ],
        "rmax": 20000,
        "rings": [
            {
                "ring": 1,
                "n_area": 2,
                "v": {
                    "erkek": 4076,
                    "kadin": 4369,
                    "toplam": 8445
                },
                "areas": [
                    {
                        "f": 0.078,
                        "ad": "Küçükçekmece / Atakent Mh.",
                        "id": 20227,
                        "erkek": 51700,
                        "kadin": 55566,
                        "toplam": 107266
                    },
                    {
                        "f": 0.014,
                        "ad": "Küçükçekmece / Yarımburgaz Mh.",
                        "id": 20245,
                        "erkek": 4603,
                        "kadin": 4171,
                        "toplam": 8774
                    }
                ]
            },
            {
                "ring": 2,
                "n_area": 2,
                "v": {
                    "erkek": 13090,
                    "kadin": 13977,
                    "toplam": 27066
                },
                "areas": [
                    {
                        "f": 0.243,
                        "ad": "Küçükçekmece / Atakent Mh.",
                        "id": 20227,
                        "erkek": 51700,
                        "kadin": 55566,
                        "toplam": 107266
                    },
                    {
                        "f": 0.118,
                        "ad": "Küçükçekmece / Yarımburgaz Mh.",
                        "id": 20245,
                        "erkek": 4603,
                        "kadin": 4171,
                        "toplam": 8774
                    }
                ]
            },
            {
                "ring": 3,
                "n_area": 8,
                "v": {
                    "erkek": 47105,
                    "kadin": 49286,
                    "toplam": 96391
                },
                "areas": [
                    {
                        "f": 0.695,
                        "ad": "Küçükçekmece / Atakent Mh.",
                        "id": 20227,
                        "erkek": 51700,
                        "kadin": 55566,
                        "toplam": 107266
                    },
                    {
                        "f": 0.548,
                        "ad": "Küçükçekmece / Yarımburgaz Mh.",
                        "id": 20245,
                        "erkek": 4603,
                        "kadin": 4171,
                        "toplam": 8774
                    },
                    {
                        "f": 0.217,
                        "ad": "Başakşehir / Altınşehir Mh.",
                        "id": 19786,
                        "erkek": 15022,
                        "kadin": 14345,
                        "toplam": 29367
                    },
                    "… (5 öğe daha)"
                ]
            }
        ]
    },
    "meta": {
        "request_id": "req_db4d1df076c154b7c3d0",
        "product": "catchment",
        "credits_charged": 5,
        "credits_remaining": 1499271,
        "period_end": "2026-11-01",
        "environment": "live",
        "took_ms": 125,
        "version": "1.3.0"
    }
}

Tapusor veri servisleri

Tapusor uygulamasının veri servisleri: emsalli değer, EDI konum skoru, TÜİK sosyoekonomik veri, deprem riski, TKGM satış serileri, halka bazlı aylık m² medyanı, en yakın donatılar, KFE endeksi ve TCMB / GYODER makro serileri.

GET/public/api/v1/valuation/comparables10 kredi

Emsalli değer sorgusu valuation.comparables

Tapusor değer sorgusu: mesafe (HÇ1–HÇ5) × emsal yaşı basamağıyla emsal seçimi, KFE düzeltmesi, akıllı ortalama; m² değeri, aralık, toplam değer, trend ve emsal listesi (ilan numarası yok, konum ~10 m'ye yuvarlı).

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
status seçenek: 1, 21 satılık, 2 kiralık. Varsayılan: 1.1
category seçenek: 1, 2, 31 konut, 2 işyeri, 3 arsa. Varsayılan: 1.1
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (boşsa kategorinin tümü).10010
rooms seçenek: 1+0, 1+1, 2+0, 2+1, 2+2, 3+0, 3+1, 3+2, 4+0, 4+1, 4+2+Oda sayısı (konut; ör. 2+1).2+1
m2 tamsayı (10–1000000)Brüt m² (boşsa emsal medyanı).110
curl -s "https://www.ai.tapusor.com/public/api/v1/valuation/comparables?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 · rooms 2+1 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/valuation/comparables?lat=41.04768437505737&lng=28.760775996083126&status=1&category=1&subcategory=10010&rooms=2%2B1&m2=110
{
    "data": {
        "sufficient": true,
        "source": "emsal",
        "unit_price_m2": 81089,
        "unit_price_range": [
            76195,
            86408
        ],
        "m2_used": 110,
        "total": 8919737,
        "total_range": [
            8381450,
            9504880
        ],
        "trend": {
            "degisim_yuzde": 6.7,
            "durum": "Yatay",
            "n_son": 33,
            "n_onceki": 48
        },
        "step": {
            "ring": 1,
            "max_age_days": 90,
            "step_no": 1
        },
        "candidates": 5,
        "selected_count": 4,
        "kfe": {
            "kaynak": "il",
            "son_ay": "2026-06"
        },
        "comparables": [
            {
                "date": "2026-08-16",
                "age_days": 74,
                "distance_m": 162,
                "ring": 1,
                "price": 8800000,
                "m2": 103,
                "unit_price": 85437,
                "kfe_factor": 1,
                "adjusted_unit_price": 85437,
                "rooms": 1650,
                "building_age": 13,
                "floor": 1666,
                "subcategory": 10010,
                "lat": 41.0463,
                "lng": 28.7602,
                "selected": true
            },
            {
                "date": "2026-07-31",
                "age_days": 90,
                "distance_m": 165,
                "ring": 1,
                "price": 9000000,
                "m2": 128,
                "unit_price": 70313,
                "kfe_factor": 1,
                "adjusted_unit_price": 70313,
                "rooms": 1650,
                "building_age": 13,
                "floor": 1656,
                "subcategory": 10010,
                "lat": 41.0463,
                "lng": 28.7603,
                "selected": true
            },
            {
                "date": "2026-08-13",
                "age_days": 77,
                "distance_m": 166,
                "ring": 1,
                "price": 9200000,
                "m2": 103,
                "unit_price": 89320,
                "kfe_factor": 1,
                "adjusted_unit_price": 89320,
                "rooms": 1650,
                "building_age": 13,
                "floor": 1656,
                "subcategory": 10010,
                "lat": 41.0462,
                "lng": 28.7602,
                "selected": true
            },
            "… (2 öğe daha)"
        ]
    },
    "meta": {
        "request_id": "req_ornek",
        "product": "valuation.comparables",
        "credits_charged": 10,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}
GET/public/api/v1/scores/edi3 kredi

EDI yapay zekâ konum skoru score.edi

Noktanın arz / talep, değer, ulaşım, projeler ve plan başlıklarında 0–100 puanları ve ortalaması (Tapusor EDI skoru).

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
curl -s "https://www.ai.tapusor.com/public/api/v1/scores/edi?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/scores/edi?lat=41.04768437505737&lng=28.760775996083126
{
    "data": {
        "scores": [
            {
                "id": 1,
                "indicator": "Arz/Talep (Hızlı nakide dönebilme Performansı)",
                "score": 84
            },
            {
                "id": 2,
                "indicator": "Değer (Fiyat Performansı)",
                "score": 80
            },
            {
                "id": 3,
                "indicator": "Ulaşım (Ulaşım İmkanları)",
                "score": 75
            },
            "… (3 öğe daha)"
        ],
        "average": 79.8,
        "scale": "0-100 (yüksek = iyi)"
    },
    "meta": {
        "request_id": "req_ornek",
        "product": "score.edi",
        "credits_charged": 3,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}
GET/public/api/v1/socioeconomics3 kredi

TÜİK sosyoekonomik veriler socio.tuik

Noktanın il, ilçe ve mahallesi için TÜİK dağılımları: eğitim, hane halkı, medeni durum, konut / işyeri, cinsiyet, yaş grupları … (her konu için kategori, yüzde, kişi sayısı).

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
topics tamsayı listesi (1–99)Konu numaraları (boşsa hepsi; yanıttaki id alanı).1,2,3
curl -s "https://www.ai.tapusor.com/public/api/v1/socioeconomics?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/socioeconomics?lat=41.04768437505737&lng=28.760775996083126&topics=1%2C2%2C3
{
    "data": [
        {
            "id": 1,
            "topic": "İl Bazında Eğitim Dağılımı",
            "place": "İstanbul İli",
            "data": [
                {
                    "kategori": "İlkogretim",
                    "yuzde": 21.9,
                    "sayi": 3442177
                },
                {
                    "kategori": "Ortaokul",
                    "yuzde": 14.7,
                    "sayi": 2308369
                },
                {
                    "kategori": "Lise",
                    "yuzde": 22.5,
                    "sayi": 3526136
                },
                "… (6 öğe daha)"
            ]
        },
        {
            "id": 2,
            "topic": "İlçe Bazında Eğitim Dağılımı",
            "place": "İstanbul İli Küçükçekmece İlçesi",
            "data": [
                {
                    "kategori": "İlkogretim",
                    "yuzde": 22.9,
                    "sayi": 180861
                },
                {
                    "kategori": "Ortaokul",
                    "yuzde": 14.9,
                    "sayi": 117839
                },
                {
                    "kategori": "Lise",
                    "yuzde": 22,
                    "sayi": 173697
                },
                "… (6 öğe daha)"
            ]
        },
        {
            "id": 3,
            "topic": "Mahalle Bazında Eğitim Dağılımı",
            "place": "İstanbul İli Küçükçekmece İlçesi Atakent Mh. Mahallesi",
            "data": [
                {
                    "kategori": "Bilinmeyen",
                    "yuzde": 9.6,
                    "sayi": 10127
                },
                {
                    "kategori": "Doktora",
                    "yuzde": 1,
                    "sayi": 1358
                },
                {
                    "kategori": "İlkogretim",
                    "yuzde": 11,
                    "sayi": 12206
                },
                "… (6 öğe daha)"
            ]
        }
    ],
    "meta": {
        "request_id": "req_ornek",
        "product": "socio.tuik",
        "credits_charged": 3,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}
GET/public/api/v1/risk/earthquake3 kredi

Deprem risk puanı risk.earthquake

Deprem tehlikesi (PGA ivmesi), zemin ve yapı puanı, heyelan durumu ve bunların birleşik 0–100 sonucu ile risk sınıfı.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
curl -s "https://www.ai.tapusor.com/public/api/v1/risk/earthquake?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/risk/earthquake?lat=41.04768437505737&lng=28.760775996083126
{
    "data": {
        "pga_acceleration_g": 0.4,
        "pga_score": 20,
        "pga_comment": "Deprem tehlike durumuna göre Çok Yüksek Risk grubundadır.",
        "ground_score": 5,
        "ground_comment": "Bölge zemin durumuna göre Çok Yüksek Risk grubundadır.",
        "building_score": 1,
        "building_comment": "Yapı durumuna göre Çok Yüksek Risk grubundadır.",
        "landslide": "Heyelan Riski yoktur.",
        "result_score": 6,
        "result_level": "Çok Yüksek Risk",
        "result_comment": "Zemin, yapı ve deprem tehlike durumu(pga) birlikte incelendiğinde 100 üzerinden 6 puan alarak Çok Yüksek Risk grubuna girmektedir.",
        "scale": "0-100 (yüksek = düşük risk)"
    },
    "meta": {
        "request_id": "req_ornek",
        "product": "risk.earthquake",
        "credits_charged": 3,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}
GET/public/api/v1/sales/admin2 kredi

İdari birimde TKGM satışları sales.admin

İl, ilçe ya da mahallenin yıllara göre resmî (TKGM) satış adetleri. Kimlik: il plaka kodu (1–81), ilçe ya da mahalle kimliği (/v1/sales/trend yanıtındaki *_id).

ParametreTürAçıklamaÖrnek
admin_id zorunlu tamsayı (1–999999999)İl (<100), ilçe (<2500) ya da mahalle kimliği.1886
analysis seçenek: 0, 2, 3, 4, 50 tümü, 2 ana taşınmaz, 3 ana taşınmaz ipotekli, 4 bağımsız bölüm, 5 bağımsız bölüm ipotekli. Varsayılan: 0.4
curl -s "https://www.ai.tapusor.com/public/api/v1/sales/admin?admin_id=1886" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — admin_id 1823 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/sales/admin?admin_id=1823&analysis=4
{
    "data": {
        "level": "ilce",
        "province": "İstanbul",
        "district": "Küçükçekmece",
        "neighborhood": null,
        "analysis": 4,
        "years": [
            {
                "year": 2010,
                "count": 3951
            },
            {
                "year": 2011,
                "count": 4253
            },
            {
                "year": 2012,
                "count": 4371
            },
            "… (12 öğe daha)"
        ]
    },
    "meta": {
        "request_id": "req_ornek",
        "product": "sales.admin",
        "credits_charged": 2,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}
GET/public/api/v1/sales/trend2 kredi

TKGM satış serileri sales.trend

Noktanın çevresinde (yarıçap) ya da il / ilçe / mahallesinde işlem türüne göre (alım-satım yoğunluğu, ana taşınmaz, bağımsız bölüm, ipotekli) yıllık TKGM satış adetleri.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
level seçenek: yaricap, il, ilce, mahalleKapsam. Varsayılan: yaricap.ilce
radius tamsayı (100–2000)Yarıçap (m; level=yaricap). Varsayılan: 500.500
curl -s "https://www.ai.tapusor.com/public/api/v1/sales/trend?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · level ilce (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/sales/trend?lat=41.04768437505737&lng=28.760775996083126&level=ilce
{
    "data": {
        "level": "ilce",
        "radius_m": null,
        "series": [
            {
                "analysis": 2,
                "type": "Ana Taşınmaz Satış",
                "years": [
                    {
                        "year": 2010,
                        "count": 3386
                    },
                    {
                        "year": 2011,
                        "count": 3926
                    },
                    {
                        "year": 2012,
                        "count": 3560
                    },
                    "… (13 öğe daha)"
                ]
            },
            {
                "analysis": 3,
                "type": "Ana Taşınmaz İpotekli Satış",
                "years": [
                    {
                        "year": 2010,
                        "count": 21
                    },
                    {
                        "year": 2011,
                        "count": 16
                    },
                    {
                        "year": 2012,
                        "count": 0
                    },
                    "… (13 öğe daha)"
                ]
            },
            {
                "analysis": 5,
                "type": "Bağımsız Bölüm İpotekli Satış",
                "years": [
                    {
                        "year": 2010,
                        "count": 4844
                    },
                    {
                        "year": 2011,
                        "count": 5016
                    },
                    {
                        "year": 2012,
                        "count": 5528
                    },
                    "… (13 öğe daha)"
                ]
            },
            "… (2 öğe daha)"
        ],
        "province": "İstanbul",
        "district": "Küçükçekmece",
        "province_id": 34,
        "district_id": 1823
    },
    "meta": {
        "request_id": "req_ornek",
        "product": "sales.trend",
        "credits_charged": 2,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}
GET/public/api/v1/market/ring-monthly2 kredi

Halka bazlı aylık m² medyanı market.ring_monthly

Noktanın hexagonu ve çevresindeki halkalarda aylık ilan medyan m² değeri, yumuşatılmış seri ve ilan adedi.

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
subcategory seçenek: 10010, 10176, 10033, 10026, 10056, 10216, 10143, 10125, 10113, 10135İlan alt kategorisi (boşsa tümü).10010
curl -s "https://www.ai.tapusor.com/public/api/v1/market/ring-monthly?lat=41.0369&lng=28.985&subcategory=10010" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 · subcategory 10010 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/market/ring-monthly?lat=41.04768437505737&lng=28.760775996083126&subcategory=10010
{
    "data": {
        "province": 34,
        "hex": 202272340,
        "subcategory": 10010,
        "rings": [
            {
                "ring": 1,
                "months": [
                    {
                        "month": "2020-01",
                        "listings": 465,
                        "median_m2": 4844,
                        "median_m2_smooth": 4844
                    },
                    {
                        "month": "2020-02",
                        "listings": 435,
                        "median_m2": 4929,
                        "median_m2_smooth": 4886
                    },
                    {
                        "month": "2020-03",
                        "listings": 488,
                        "median_m2": 5090,
                        "median_m2_smooth": 4954
                    },
                    "… (79 öğe daha)"
                ]
            }
        ]
    },
    "meta": {
        "request_id": "req_ornek",
        "product": "market.ring_monthly",
        "credits_charged": 2,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}
GET/public/api/v1/poi/nearest2 kredi

En yakın donatılar poi.nearest

500 m içinde her donatı türünün en yakın mesafesi ve adedi (işletme adı / konumu dönmez).

ParametreTürAçıklamaÖrnek
lat zorunlu sayı (35.5–42.5)Enlem (WGS84, Türkiye).41.0369
lng zorunlu sayı (25.5–45)Boylam (WGS84, Türkiye).28.985
mode seçenek: 1, 2, 31 ana kategori, 2 kategori ve tür, 3 gürültü / etki analizi. Varsayılan: 2.2
curl -s "https://www.ai.tapusor.com/public/api/v1/poi/nearest?lat=41.0369&lng=28.985" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — 41.04768, 28.76078 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/poi/nearest?lat=41.04768437505737&lng=28.760775996083126&mode=2
{
    "data": {
        "radius_m": 500,
        "mode": 2,
        "items": [
            {
                "main_category": "Sağlık",
                "category": "Eczane",
                "type": "Eczaneler",
                "nearest_m": 25,
                "count_500m": 260
            },
            {
                "main_category": "Alışveriş",
                "category": "Market",
                "type": "Hipermarket",
                "nearest_m": 37,
                "count_500m": 802
            },
            {
                "main_category": "Yeme - İçme",
                "category": "Restoran",
                "type": "Restoran",
                "nearest_m": 46,
                "count_500m": 740
            },
            "… (12 öğe daha)"
        ]
    },
    "meta": {
        "request_id": "req_ornek",
        "product": "poi.nearest",
        "credits_charged": 2,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}
GET/public/api/v1/index/kfe1 kredi

Konut Fiyat Endeksi (KFE) index.kfe

TCMB Konut Fiyat Endeksi aylık serisi; Türkiye ya da il.

ParametreTürAçıklamaÖrnek
province tamsayı (1–81)İl plaka kodu (boşsa Türkiye).34
from tarih (YYYY-AA-GG)Başlangıç (YYYY-AA-GG).2024-01-01
curl -s "https://www.ai.tapusor.com/public/api/v1/index/kfe" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — province 34 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/index/kfe?province=34&from=2025-01-01
{
    "data": {
        "province": "İstanbul",
        "province_id": 34,
        "source": "TCMB Konut Fiyat Endeksi (aylık)",
        "base": "2023=100 (2024 öncesi aylar 2017=100 serisinden zincirlendi)",
        "data": [
            {
                "month": "2025-01",
                "index": 153.01
            },
            {
                "month": "2025-02",
                "index": 157.12
            },
            {
                "month": "2025-03",
                "index": 160.77
            },
            "… (15 öğe daha)"
        ]
    },
    "meta": {
        "request_id": "req_ornek",
        "product": "index.kfe",
        "credits_charged": 1,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}
GET/public/api/v1/index/kfe/adjust1 kredi

Fiyatı bugüne taşıma (KFE) index.kfe_adjust

Geçmiş bir tarihteki fiyatı KFE ile son endeks ayına taşır (Tapusor alternatif fiyat).

ParametreTürAçıklamaÖrnek
price zorunlu sayı (1–1000000000000)Fiyat (₺).2500000
date zorunlu tarih (YYYY-AA-GG)Fiyatın tarihi (YYYY-AA-GG).2022-06-01
province tamsayı (1–81)İl plaka kodu (boşsa Türkiye endeksi).34
curl -s "https://www.ai.tapusor.com/public/api/v1/index/kfe/adjust?price=2500000&date=2022-06-01" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — province 34 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/index/kfe/adjust?price=2500000&date=2022-06-01&province=34
{
    "data": {
        "province": "İstanbul",
        "province_id": 34,
        "price": 2500000,
        "price_month": "2022-06",
        "index_then": 52.0968,
        "index_latest_month": "2026-06",
        "index_latest": 216.92,
        "ratio": 4.1638,
        "price_today": 10409469,
        "note": null
    },
    "meta": {
        "request_id": "req_ornek",
        "product": "index.kfe_adjust",
        "credits_charged": 1,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}
GET/public/api/v1/macro/sourcesücretsiz

Makro veri kaynakları macro.sources

TCMB / GYODER makro serilerinin listesi (konut satışları, kredi faizi, KFE, birim kiralar …): kimlik, periyot, değer kolonları. Ücretsizdir.

ParametreTürAçıklamaÖrnek
curl -s "https://www.ai.tapusor.com/public/api/v1/macro/sources" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/macro/sources
{
    "data": [
        {
            "id": 1,
            "kod": "konut_satis_aylik",
            "baslik": "Konut Satış İstatistikleri (Aylık)",
            "periyot": "aylik",
            "aciklama": "Türkiye geneli aylık toplam konut satışı, ipotekli satış, ilk el ve ikinci el satış adetleri. 2013 - 2026/06 arası, 162 kayıt.",
            "grafik_onerisi": "line",
            "boyut_kolonlari": null,
            "value_kolonlari": [
                "toplam_satis",
                "ipotekli_satis",
                "ilk_el_satis",
                "… (1 öğe daha)"
            ]
        },
        {
            "id": 2,
            "kod": "konut_kredisi_haftalik",
            "baslik": "Konut Kredisi Faiz Oranları (Haftalık)",
            "periyot": "haftalik",
            "aciklama": "Türkiye geneli haftalık konut kredisi faiz oranı verisi. 2010 - 2026/07 arası, 863 kayıt.",
            "grafik_onerisi": "line",
            "boyut_kolonlari": null,
            "value_kolonlari": [
                "konut_kredisi_faiz_orani"
            ]
        },
        {
            "id": 3,
            "kod": "kfe_yeni_yeniolmayan",
            "baslik": "Yeni ve Yeni Olmayan Konut Fiyat Endeksi (KFE)",
            "periyot": "aylik",
            "aciklama": "Aylık yeni ve yeni olmayan konut fiyat endeksi. Tabloda tarih metin olarak (ör. 2026-06) tutulur, servis bunu 2026-06-01 tarihine çevirir. 78 kayıt.",
            "grafik_onerisi": "line",
            "boyut_kolonlari": null,
            "value_kolonlari": [
                "yeni_kfe",
                "yeni_olmayan_kfe"
            ]
        },
        "… (5 öğe daha)"
    ],
    "meta": {
        "request_id": "req_ornek",
        "product": "macro.sources",
        "credits_charged": 0,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}
GET/public/api/v1/macro/series1 kredi

Makro veri serisi macro.series

Seçilen TCMB / GYODER serisinin tarih aralığındaki değerleri (kimlikler: /v1/macro/sources).

ParametreTürAçıklamaÖrnek
id zorunlu tamsayı (1–999)Seri kimliği.1
from tarih (YYYY-AA-GG)Başlangıç (YYYY-AA-GG).2024-01-01
to tarih (YYYY-AA-GG)Bitiş (YYYY-AA-GG).2026-06-01
order seçenek: asc, descSıralama. Varsayılan: asc.desc
limit tamsayı (1–2000)En çok satır. Varsayılan: 500.24
curl -s "https://www.ai.tapusor.com/public/api/v1/macro/series?id=1" -H "Authorization: Bearer $TAPUSOR_API_KEY"
Örnek yanıt — id 1 (HTTP 200)
GET https://www.ai.tapusor.com/public/api/v1/macro/series?id=1&from=2025-01-01&order=desc&limit=12
{
    "data": {
        "id": 1,
        "code": "konut_satis_aylik",
        "title": "Konut Satış İstatistikleri (Aylık)",
        "period": "aylik",
        "description": "Türkiye geneli aylık toplam konut satışı, ipotekli satış, ilk el ve ikinci el satış adetleri. 2013 - 2026/06 arası, 162 kayıt.",
        "data": [
            {
                "tarih": "2026-06-01",
                "ilk_el_satis": 43406,
                "toplam_satis": 129979,
                "ipotekli_satis": 25993,
                "ikinci_el_satis": 86573,
                "tarih_normalize": "2026-06-01"
            },
            {
                "tarih": "2026-05-01",
                "ilk_el_satis": 30196,
                "toplam_satis": 93333,
                "ipotekli_satis": 19754,
                "ikinci_el_satis": 63137,
                "tarih_normalize": "2026-05-01"
            },
            {
                "tarih": "2026-04-01",
                "ilk_el_satis": 40306,
                "toplam_satis": 126808,
                "ipotekli_satis": 25771,
                "ikinci_el_satis": 86502,
                "tarih_normalize": "2026-04-01"
            },
            "… (9 öğe daha)"
        ]
    },
    "meta": {
        "request_id": "req_ornek",
        "product": "macro.series",
        "credits_charged": 1,
        "credits_remaining": null,
        "period_end": null,
        "environment": "live",
        "took_ms": null,
        "version": "1.4.0",
        "format": "json"
    }
}

Test anahtarı isteyin

Test anahtarı (tsk_test_…) ücretsizdir ve gerçek veri döndürür; günde 200, dakikada 10 istek. Nasıl alınır:

  1. Aşağıdaki formu doldurun.
  2. Ekibimiz başvurunuzu inceleyip anahtarınızı e-posta adresinize iletir. Anahtar yalnız bir kez gösterilir; güvenli bir yerde saklayın.
  3. Anahtarı aşağıdaki deneme konsoluna yapıştırıp istediğiniz ürünü deneyin ya da kendi kodunuzda Authorization: Bearer <anahtar> başlığıyla kullanın.
  4. Entegrasyon bitince canlı anahtar ve plan için aynı formla ya da ekibimize yazarak geçin (Fiyatlar).

Deneme konsolu

İstek sunucumuz üzerinden API'ye gider; anahtarınız kaydedilmez. Anahtarınız yoksa önce ücretsiz test anahtarı isteyin; test anahtarıyla istekler ücretsizdir.

Alt kategori kodları

KodAnlamı
10010Satılık · Konut · Daire
10176Kiralık · Konut · Daire
10033Satılık · Konut · Villa
10026Satılık · Konut · Müstakil Ev
10056Satılık · İşyeri · Dükkan & Mağaza
10216Kiralık · İşyeri · Dükkan & Mağaza
10143Satılık · Arsa · Tarla
10125Satılık · Arsa · İmarlı Konut
10113Satılık · Arsa · Bağ & Bahçe
10135Satılık · Arsa · Muhtelif Arsa

Kimlikler: il parametreleri plaka kodudur (İstanbul 34). /v1/locations ve /v1/parcels/search TKGM kimlikleri kullanır (İstanbul TKGM kodu 56). Koordinatlar WGS84 (EPSG:4326), geometriler GeoJSON'dur.

Sürüm ve değişiklikler

Yol öneki sürümdür (/v1). v1 içinde alan silinmez ve anlamı değişmez; yalnız yeni alan / uç eklenir. Kırıcı değişiklik /v2 ile gelir ve en az 6 ay önceden duyurulur.

SürümTarihDeğişiklik
1.4.022.10.2026İlk yayın: 121 uç nokta, kredi ve dönem ölçümü, test anahtarları, OpenAPI 3.1.

Kullanım koşulları (özet)

Veriler bilgilendirme amaçlıdır; değerleme sonuçları resmî ekspertiz raporu yerine geçmez. Ham veriyi toplu çekip yeniden satmak, anahtarı üçüncü kişilerle paylaşmak ve hız sınırını aşmaya yönelik dağıtık kullanım yasaktır. Ayrıntılar sözleşmenizdedir.