{"openapi":"3.1.0","info":{"title":"Tapusor Veri API'si","version":"1.4.0","description":"Türkiye gayrimenkul verisi: parsel, imar, piyasa, değerleme ve bölge analizi. Ayrıntılı belge: https://www.ai.tapusor.com/public/api/"},"servers":[{"url":"https://www.ai.tapusor.com/public/api/v1"}],"security":[{"bearer":[]},{"apiKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Authorization: Bearer tsk_live_… (API anahtarı) ya da Bearer <JWT> (POST /v1/token ile, 24 saat; RS256, açık anahtar GET /v1/jwks)"},"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"Basari":{"type":"object","properties":{"data":{"description":"Ürüne göre nesne ya da dizi"},"meta":{"$ref":"#/components/schemas/Meta"}}},"Meta":{"type":"object","properties":{"request_id":{"type":"string"},"product":{"type":"string"},"credits_charged":{"type":"integer"},"credits_remaining":{"type":["integer","null"]},"period_end":{"type":"string","format":"date"},"took_ms":{"type":"integer"},"version":{"type":"string"}}},"Hata":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","key_revoked","token_invalid","account_no_user","account_suspended","ip_not_allowed","product_not_in_plan","not_found","method_not_allowed","invalid_parameter","rate_limited","quota_exceeded","daily_limit","no_data","internal_error","upstream_error","maintenance","busy"]},"message":{"type":"string"},"param":{"type":"string"},"request_id":{"type":"string"}}}}}},"responses":{"Hata":{"description":"Hata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"paths":{"/parcels/at":{"get":{"operationId":"parcel_at","tags":["Konum ve kadastro"],"summary":"Koordinattaki parsel","description":"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.\n\n**Kredi:** 1 / başarılı istek.","x-credits":1,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/parcels/search":{"get":{"operationId":"parcel_search","tags":["Konum ve kadastro"],"summary":"Ada / parsel araması","description":"TKGM mahalle kimliği + ada (+ parsel) ile parsel bilgisi ve merkez koordinatı. Mahalle kimliği /v1/locations ile bulunur.\n\n**Kredi:** 1 / başarılı istek.","x-credits":1,"parameters":[{"name":"neighborhood_id","in":"query","required":true,"description":"TKGM mahalle kimliği.","schema":{"type":"integer","minimum":1,"maximum":999999999},"example":40213},{"name":"block","in":"query","required":true,"description":"Ada numarası.","schema":{"type":"string","pattern":"^[0-9A-Za-z/-]{1,12}$"},"example":"105"},{"name":"parcel","in":"query","required":false,"description":"Parsel numarası (boşsa adanın ilk parseli).","schema":{"type":"string","pattern":"^[0-9A-Za-z/-]{1,12}$"},"example":"12"},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/locations":{"get":{"operationId":"location_list","tags":["Konum ve kadastro"],"summary":"İl / ilçe / mahalle listesi","description":"TKGM idari birim listesi. Ücretsizdir (kredi düşmez, istek sayılır).\n\n**Kredi:** 0 / başarılı istek.","x-credits":0,"parameters":[{"name":"kind","in":"query","required":true,"description":"Liste türü.","schema":{"enum":["il","ilce","mahalle"]},"example":"ilce"},{"name":"parent_id","in":"query","required":false,"description":"Üst birim kimliği (ilçe için il, mahalle için ilçe).","schema":{"type":"integer","minimum":1,"maximum":999999999},"example":56},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/locations/resolve":{"get":{"operationId":"location_resolve","tags":["Konum ve kadastro"],"summary":"Koordinattan idari kimlikler","description":"Noktanın idari (il / ilçe / mahalle), TKGM ve hexagon (1–8) kimlikleri; diğer uçlara girdi olarak kullanılır.\n\n**Kredi:** 1 / başarılı istek.","x-credits":1,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/boundaries":{"get":{"operationId":"boundary_at","tags":["Konum ve kadastro"],"summary":"Sınır geometrisi","description":"Noktayı içeren il / ilçe / mahalle / ada sınırı (GeoJSON).\n\n**Kredi:** 1 / başarılı istek.","x-credits":1,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"level","in":"query","required":true,"description":"Sınır düzeyi.","schema":{"enum":["il","ilce","mah","ada"]},"example":"mah"},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/risk/ground":{"get":{"operationId":"ground_risk","tags":["İmar ve risk"],"summary":"Zemin ve heyelan","description":"Jeolojik birim (formasyon, yaş, puan) ve yakın heyelan envanteri.\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/zoning/plans":{"get":{"operationId":"zoning_plans","tags":["İmar ve risk"],"summary":"e-Plan imar planları","description":"Noktayı kapsayan onaylı imar planları (ad, tür, tarih, e-Plan bağlantısı).\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/zoning/parcel":{"get":{"operationId":"zoning_parcel","tags":["İmar ve risk"],"summary":"Parsel imar durumu","description":"1/1000 uygulama imar planındaki fonksiyon, TAKS / KAKS ve plan tadilatları.\n\n**Kredi:** 3 / başarılı istek.","x-credits":3,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/parcels/frontage":{"get":{"operationId":"parcel_frontage","tags":["İmar ve risk"],"summary":"Parsel açık cephe","description":"Parselin yola / boşluğa bakan cepheleri.\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/buildings/at":{"get":{"operationId":"building_at","tags":["İmar ve risk"],"summary":"Bina bilgisi","description":"Noktadaki bina: kat adedi, bağımsız bölüm sayıları, taban alanı, geometri (İstanbul envanteri; diğer illerde bina izi).\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/market/hexagons":{"get":{"operationId":"market_hexagons","tags":["Piyasa verisi"],"summary":"Hexagon piyasa haritası","description":"Alandaki hexagonlar için seçilen ölçü (medyan m² değeri, ilan sayısı, kira getirisi …) ve geometri. En çok 2.000 hücre.\n\n**Kredi:** 3 / başarılı istek.","x-credits":3,"parameters":[{"name":"bbox","in":"query","required":true,"description":"Alan: batı,güney,doğu,kuzey (derece).","schema":{"type":"string","pattern":"^-?[\\d.]+,-?[\\d.]+,-?[\\d.]+,-?[\\d.]+$"},"example":"28.95,41.00,29.02,41.05"},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (2 en ince; ince çözünürlükte alan dar tutulmalı).","schema":{"enum":[2,3,4,5,6,7],"default":3},"example":4},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"metric","in":"query","required":false,"description":"Ölçü.","schema":{"enum":["med_rayic","ilan_sayisi","med_fiyat","med_m2","kira_getirisi","amortisman","ceyrek_degisim","komsu_fark","avg_med_fark","mod_med_fark"],"default":"med_rayic"},"example":"med_rayic"},{"name":"rooms","in":"query","required":false,"description":"Oda sayısı süzgeci (ör. 2+1). Boşsa tüm oda tipleri.","schema":{"enum":["1+0","1+1","2+0","2+1","2+2","3+0","3+1","3+2","4+0","4+1","4+2+"]},"example":"2+1"},{"name":"quarter","in":"query","required":false,"description":"Çeyrek, YYYYQ (ör. 20262 = 2026 2. çeyrek). Boşsa son çeyrek.","schema":{"type":"string","pattern":"^202[1-6][1-4]$"},"example":20262},{"name":"province","in":"query","required":false,"description":"İl plaka kodu (İstanbul 34).","schema":{"type":"integer","minimum":1,"maximum":81,"default":34},"example":34},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/market/hexagons/{id}":{"get":{"operationId":"market_hexagon","tags":["Piyasa verisi"],"summary":"Tek hexagon istatistiği","description":"Bir hexagonun çeyrek istatistiği: ilan sayısı, medyan / ortalama / mod değer, fiyat, m², oda / yaş / kat dağılımı.\n\n**Kredi:** 1 / başarılı istek.","x-credits":1,"parameters":[{"name":"id","in":"path","required":true,"description":"Hexagon kimliği (/v1/market/hexagons ya da /v1/locations/resolve).","schema":{"type":"integer","minimum":1},"example":123456},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü.","schema":{"enum":[2,3,4,5,6,7],"default":3},"example":4},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"rooms","in":"query","required":false,"description":"Oda sayısı süzgeci (ör. 2+1). Boşsa tüm oda tipleri.","schema":{"enum":["1+0","1+1","2+0","2+1","2+2","3+0","3+1","3+2","4+0","4+1","4+2+"]},"example":"2+1"},{"name":"quarter","in":"query","required":false,"description":"Çeyrek, YYYYQ (ör. 20262 = 2026 2. çeyrek). Boşsa son çeyrek.","schema":{"type":"string","pattern":"^202[1-6][1-4]$"},"example":20262},{"name":"province","in":"query","required":false,"description":"İl plaka kodu (İstanbul 34).","schema":{"type":"integer","minimum":1,"maximum":81,"default":34},"example":34},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/market/areas":{"get":{"operationId":"market_areas","tags":["Piyasa verisi"],"summary":"İlçe / mahalle piyasa haritası","description":"Alandaki ilçe ya da mahalleler için seçilen ölçü, ad ve geometri.\n\n**Kredi:** 3 / başarılı istek.","x-credits":3,"parameters":[{"name":"bbox","in":"query","required":true,"description":"Alan: batı,güney,doğu,kuzey (derece).","schema":{"type":"string","pattern":"^-?[\\d.]+,-?[\\d.]+,-?[\\d.]+,-?[\\d.]+$"},"example":"28.95,41.00,29.02,41.05"},{"name":"level","in":"query","required":true,"description":"Düzey.","schema":{"enum":["ilce","mahalle"]},"example":"mahalle"},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"metric","in":"query","required":false,"description":"Ölçü.","schema":{"enum":["med_rayic","ilan_sayisi","med_fiyat","med_m2","kira_getirisi","amortisman","ceyrek_degisim","komsu_fark","avg_med_fark","mod_med_fark","ilan_kapi"],"default":"med_rayic"},"example":"med_rayic"},{"name":"zoom","in":"query","required":false,"description":"Harita yakınlığı (alan genişliği sınırını belirler).","schema":{"type":"integer","minimum":0,"maximum":21,"default":12},"example":13},{"name":"rooms","in":"query","required":false,"description":"Oda sayısı süzgeci (ör. 2+1). Boşsa tüm oda tipleri.","schema":{"enum":["1+0","1+1","2+0","2+1","2+2","3+0","3+1","3+2","4+0","4+1","4+2+"]},"example":"2+1"},{"name":"quarter","in":"query","required":false,"description":"Çeyrek, YYYYQ (ör. 20262 = 2026 2. çeyrek). Boşsa son çeyrek.","schema":{"type":"string","pattern":"^202[1-6][1-4]$"},"example":20262},{"name":"province","in":"query","required":false,"description":"İl plaka kodu (İstanbul 34).","schema":{"type":"integer","minimum":1,"maximum":81,"default":34},"example":34},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/market/areas/{id}":{"get":{"operationId":"market_area","tags":["Piyasa verisi"],"summary":"Tek ilçe / mahalle istatistiği","description":"İlçe ya da mahallenin çeyrek istatistiği (ilan sayısı, medyan değer, fiyat, m², alt / üst kırılım).\n\n**Kredi:** 1 / başarılı istek.","x-credits":1,"parameters":[{"name":"id","in":"path","required":true,"description":"İ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).","schema":{"type":"integer","minimum":1},"example":1186},{"name":"level","in":"query","required":true,"description":"Düzey.","schema":{"enum":["ilce","mahalle"]},"example":"ilce"},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"rooms","in":"query","required":false,"description":"Oda sayısı süzgeci (ör. 2+1). Boşsa tüm oda tipleri.","schema":{"enum":["1+0","1+1","2+0","2+1","2+2","3+0","3+1","3+2","4+0","4+1","4+2+"]},"example":"2+1"},{"name":"quarter","in":"query","required":false,"description":"Çeyrek, YYYYQ (ör. 20262 = 2026 2. çeyrek). Boşsa son çeyrek.","schema":{"type":"string","pattern":"^202[1-6][1-4]$"},"example":20262},{"name":"province","in":"query","required":false,"description":"İl plaka kodu (İstanbul 34).","schema":{"type":"integer","minimum":1,"maximum":81,"default":34},"example":34},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/market/trend":{"get":{"operationId":"market_trend","tags":["Piyasa verisi"],"summary":"Çeyreklik m² trendi","description":"Bölgenin çeyrek çeyrek medyan m² değeri ve ilan adedi.\n\n**Kredi:** 1 / başarılı istek.","x-credits":1,"parameters":[{"name":"id","in":"query","required":true,"description":"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).","schema":{"type":"integer","minimum":1},"example":1186},{"name":"level","in":"query","required":true,"description":"Düzey: hexagon çözünürlüğü (2–7), ilce ya da mahalle.","schema":{"enum":["2","3","4","5","6","7","ilce","mahalle"]},"example":"ilce"},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"province","in":"query","required":false,"description":"İl plaka kodu (İstanbul 34).","schema":{"type":"integer","minimum":1,"maximum":81,"default":34},"example":34},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/market/rental-yield":{"get":{"operationId":"market_rental_yield","tags":["Piyasa verisi"],"summary":"Oda sayısına göre kira getirisi","description":"Oda tipine göre satılık / kiralık medyan değer, brüt kira getirisi (%) ve amortisman (yıl).\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"id","in":"query","required":true,"description":"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).","schema":{"type":"integer","minimum":1},"example":1186},{"name":"level","in":"query","required":true,"description":"Düzey.","schema":{"enum":["2","3","4","5","6","7","ilce","mahalle"]},"example":"ilce"},{"name":"subcategory","in":"query","required":false,"description":"Konut 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ı).","schema":{"enum":[10010,10176,10056,10216],"default":10010},"example":10010},{"name":"quarter","in":"query","required":false,"description":"Çeyrek, YYYYQ (ör. 20262 = 2026 2. çeyrek). Boşsa son çeyrek.","schema":{"type":"string","pattern":"^202[1-6][1-4]$"},"example":20262},{"name":"province","in":"query","required":false,"description":"İl plaka kodu (İstanbul 34).","schema":{"type":"integer","minimum":1,"maximum":81,"default":34},"example":34},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/market/indicators":{"get":{"operationId":"market_indicators","tags":["Piyasa verisi"],"summary":"Piyasa göstergeleri","description":"Noktanın mahalle / ilçe / il bağlamında çeyreklik değer ve arz değişimi, TKGM satış / ilan oranı.\n\n**Kredi:** 3 / başarılı istek.","x-credits":3,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"scope","in":"query","required":false,"description":"Kapsam.","schema":{"enum":["auto","parsel","hex","mah","ilce","il"],"default":"auto"},"example":"auto"},{"name":"resolution","in":"query","required":false,"description":"scope=hex için hexagon çözünürlüğü.","schema":{"enum":[2,3,4,5,6],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/market/competition":{"get":{"operationId":"market_competition","tags":["Piyasa verisi"],"summary":"Finansal derinlik ve rekabet","description":"İ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ı).\n\n**Kredi:** 3 / başarılı istek.","x-credits":3,"parameters":[{"name":"level","in":"query","required":true,"description":"Düzey.","schema":{"enum":["ilce","mahalle"]},"example":"ilce"},{"name":"province","in":"query","required":false,"description":"İl plaka kodu (İstanbul 34).","schema":{"type":"integer","minimum":1,"maximum":81,"default":34},"example":34},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/market/time-on-market":{"get":{"operationId":"market_time_on_market","tags":["Piyasa verisi"],"summary":"Pazarda kalma süresi","description":"Yarıçap içindeki ilanların gözlenen yayın süresi, aktif stok yaşı, fiyat indirimi oranı, yıllık trend.\n\n**Kredi:** 3 / başarılı istek.","x-credits":3,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"radius","in":"query","required":false,"description":"Yarıçap (m).","schema":{"type":"integer","minimum":200,"maximum":3000,"default":1000},"example":1000},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/sales/official":{"get":{"operationId":"sales_official","tags":["Piyasa verisi"],"summary":"Resmi (TKGM) satış adetleri","description":"İlçe / mahalle bazında yıllık gerçekleşen tapu satış adetleri, işlem tipine göre (a1–a5).\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"level","in":"query","required":true,"description":"Düzey.","schema":{"enum":["ilce","mahalle"]},"example":"ilce"},{"name":"ids","in":"query","required":true,"description":"Virgü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).","schema":{"type":"string","pattern":"^\\d+(,\\d+)*$"},"example":"1186,1183"},{"name":"year_from","in":"query","required":false,"description":"Başlangıç yılı.","schema":{"type":"integer","minimum":2018,"maximum":2025,"default":2018},"example":2022},{"name":"year_to","in":"query","required":false,"description":"Bitiş yılı.","schema":{"type":"integer","minimum":2018,"maximum":2025,"default":2025},"example":2025},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/scores/location":{"get":{"operationId":"score_location","tags":["Piyasa verisi"],"summary":"Bölge değer skoru","description":"Konut ve arsa için bölge puanı, açıklaması ve yüzdelik dilimi.\n\n**Kredi:** 1 / başarılı istek.","x-credits":1,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/valuation/estimate":{"get":{"operationId":"valuation_estimate","tags":["Değerleme"],"summary":"Otomatik değerleme","description":"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.\n\n**Kredi:** 10 / başarılı istek.","x-credits":10,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"area_m2","in":"query","required":false,"description":"Brüt alan (m²). Boşsa parsel / bölge medyanı.","schema":{"type":"number","minimum":10,"maximum":100000},"example":120},{"name":"building_age","in":"query","required":false,"description":"Bina yaşı (yıl).","schema":{"type":"integer","minimum":0,"maximum":100},"example":10},{"name":"as_of_days","in":"query","required":false,"description":"Kaç gün önceki piyasaya göre (0 = bugün).","schema":{"enum":[0,30,90,270,365,730,1095],"default":0},"example":0},{"name":"rooms","in":"query","required":false,"description":"Oda sayısı süzgeci (ör. 2+1). Boşsa tüm oda tipleri.","schema":{"enum":["1+0","1+1","2+0","2+1","2+2","3+0","3+1","3+2","4+0","4+1","4+2+"]},"example":"2+1"},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/catchment":{"get":{"operationId":"catchment","tags":["Bölge analizi"],"summary":"Etki alanı analizi","description":"Merkez etrafında en çok 3 halkada nüfus, ilan yoğunluğu ya da tapu satışı (yıl × tür adetleri).\n\n**Kredi:** 5 / başarılı istek.","x-credits":5,"parameters":[{"name":"dataset","in":"query","required":true,"description":"Veri 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).","schema":{"enum":["nufus","ilan_bolge","tkgm_satis","poi","haber_sikayet","eplan","imar_parsel"]},"example":"nufus"},{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"radii","in":"query","required":true,"description":"Halka yarıçapları (m), artan, en çok 3 (tkgm_satis için en çok 5.000).","schema":{"type":"string","pattern":"^\\d+(,\\d+)*$"},"example":"500,1000,2000"},{"name":"year_from","in":"query","required":false,"description":"Başlangıç yılı (yıllı veri setlerinde).","schema":{"type":"integer","minimum":2000,"maximum":2030},"example":2022},{"name":"year_to","in":"query","required":false,"description":"Bitiş yılı.","schema":{"type":"integer","minimum":2000,"maximum":2030},"example":2025},{"name":"categories","in":"query","required":false,"description":"Tür kodları (veri setine göre; boşsa hepsi).","schema":{"type":"string","pattern":"^\\d+(,\\d+)*$"},"example":"1,2"},{"name":"subcategories","in":"query","required":false,"description":"poi için alt kategori kırılımı (1 = ekle).","schema":{"enum":["0","1"],"default":"0"},"example":"1"},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/records":{"get":{"operationId":"records_search","tags":["Resmî kayıtlar"],"summary":"Kayıt arama","description":"Resmî Gazete, Yargıtay ve icra / ihale kayıtlarında alan, bölge, tarih ve metinle arama; en yeni kayıtlar ve kaynak başına toplam.\n\n**Kredi:** 3 / başarılı istek.","x-credits":3,"parameters":[{"name":"sources","in":"query","required":false,"description":"Kaynaklar: rg (Resmî Gazete), yg (Yargıtay), ic (icra / ihale).","schema":{"type":"string","description":"Virgülle ayrılmış: rg, yg, ic","default":"rg,yg,ic"},"example":"rg,ic"},{"name":"bbox","in":"query","required":false,"description":"Alan: batı,güney,doğu,kuzey (isteğe bağlı).","schema":{"type":"string","pattern":"^-?[\\d.]+,-?[\\d.]+,-?[\\d.]+,-?[\\d.]+$"},"example":"28.95,41.00,29.02,41.05"},{"name":"region_level","in":"query","required":false,"description":"TKGM bölge düzeyi (region_id ile).","schema":{"enum":["il","ilce","mahalle"]},"example":"ilce"},{"name":"region_id","in":"query","required":false,"description":"TKGM bölge kimliği (/v1/locations).","schema":{"type":"integer","minimum":1,"maximum":999999999},"example":504},{"name":"date_from","in":"query","required":false,"description":"Başlangıç tarihi (YYYY-AA-GG).","schema":{"type":"string","format":"date"},"example":"2025-01-01"},{"name":"date_to","in":"query","required":false,"description":"Bitiş tarihi.","schema":{"type":"string","format":"date"},"example":"2026-10-01"},{"name":"q","in":"query","required":false,"description":"Metin araması (en çok 5 kelime, hepsi geçmeli).","schema":{"type":"string","pattern":"^[^\\x00-\\x1f<>]{2,120}$"},"example":"kamulaştırma"},{"name":"gazette_type","in":"query","required":false,"description":"Resmî Gazete karar türü (tam eşleşme).","schema":{"type":"string","pattern":"^[^\\x00-\\x1f<>]{1,120}$"},"example":"Kamulaştırma Kararı"},{"name":"court","in":"query","required":false,"description":"Yargıtay dairesi (tam eşleşme).","schema":{"type":"string","pattern":"^[^\\x00-\\x1f<>]{1,120}$"},"example":"1. Hukuk Dairesi"},{"name":"active_only","in":"query","required":false,"description":"İcra / ihale: yalnız süren ilanlar.","schema":{"enum":["0","1"]},"example":"1"},{"name":"with_parcel","in":"query","required":false,"description":"Yalnız ada / parsel bilgisi olan kayıtlar.","schema":{"enum":["0","1"]},"example":"1"},{"name":"block","in":"query","required":false,"description":"Ada no.","schema":{"type":"string","pattern":"^[0-9A-Za-z/.-]{1,20}$"},"example":"105"},{"name":"parcel","in":"query","required":false,"description":"Parsel no.","schema":{"type":"string","pattern":"^[0-9A-Za-z/.-]{1,20}$"},"example":"12"},{"name":"sort","in":"query","required":false,"description":"Sıralama (tarih).","schema":{"enum":["yeni","eski"],"default":"yeni"},"example":"yeni"},{"name":"page","in":"query","required":false,"description":"Sayfa.","schema":{"type":"integer","minimum":1,"maximum":200,"default":1},"example":1},{"name":"page_size","in":"query","required":false,"description":"Sayfa boyu.","schema":{"type":"integer","minimum":10,"maximum":100,"default":50},"example":50},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/records/detail":{"get":{"operationId":"records_detail","tags":["Resmî kayıtlar"],"summary":"Kayıt ayrıntısı","description":"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.\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"source","in":"query","required":true,"description":"Kaynak.","schema":{"enum":["rg","yg","ic"]},"example":"ic"},{"name":"id","in":"query","required":true,"description":"Kayıt kimliği (/v1/records).","schema":{"type":"integer","minimum":1},"example":123456},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/records/nearby":{"get":{"operationId":"records_nearby","tags":["Resmî kayıtlar"],"summary":"Noktaya yakın kayıtlar","description":"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.\n\n**Kredi:** 3 / başarılı istek.","x-credits":3,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"radius","in":"query","required":false,"description":"Yarıçap (m).","schema":{"type":"integer","minimum":25,"maximum":1000,"default":150},"example":250},{"name":"sources","in":"query","required":false,"description":"Kaynaklar.","schema":{"type":"string","description":"Virgülle ayrılmış: rg, yg, ic","default":"rg,yg,ic"},"example":"rg,yg,ic"},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/risk/score":{"get":{"operationId":"risk_score","tags":["Teknik analiz ve risk"],"summary":"Bileşik risk skoru","description":"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ı.\n\n**Kredi:** 8 / başarılı istek.","x-credits":8,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/summary":{"get":{"operationId":"technical_summary","tags":["Teknik analiz ve risk"],"summary":"Parsel teknik özeti","description":"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.\n\n**Kredi:** 5 / başarılı istek.","x-credits":5,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls":{"get":{"operationId":"technical_controls","tags":["Teknik analiz ve risk"],"summary":"Teknik kontroller","description":"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.\n\n**Kredi:** 10 / başarılı istek.","x-credits":10,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"controls","in":"query","required":true,"description":"Kontrol numaraları (virgülle, en çok 12).","schema":{"type":"string","pattern":"^\\d+(,\\d+)*$"},"example":"1,3,6,7,8"},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü.","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/news/summary":{"get":{"operationId":"news_summary","tags":["Teknik analiz ve risk"],"summary":"Haber ve şikâyet yoğunluğu","description":"1 km içindeki haber / şikâyet kayıtlarının sınıf ve mesafe bandına göre adetleri (metinler dönmez).\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/accessibility":{"get":{"operationId":"accessibility_summary","tags":["Çevre ve erişim"],"summary":"Erişilebilirlik özeti","description":"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.\n\n**Kredi:** 3 / başarılı istek.","x-credits":3,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/poi/area":{"get":{"operationId":"poi_area","tags":["Çevre ve erişim"],"summary":"Bölge donatı özeti","description":"İl / ilçe / mahalle ya da hexagon hücresindeki donatıların kategori ve alt kategori dağılımı, alan (km²) ve nüfus.\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"level","in":"query","required":true,"description":"Düzey.","schema":{"enum":["il","ilce","mah","hex2","hex3","hex4","hex5","hex6","hex7"]},"example":"mah"},{"name":"id","in":"query","required":true,"description":"Bölge / hücre kimliği (/v1/locations/resolve: idari_* ya da hex*).","schema":{"type":"integer","minimum":1},"example":33593},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/sales/nearby":{"get":{"operationId":"sales_nearby","tags":["Çevre ve erişim"],"summary":"Yakındaki tapu satışları","description":"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).\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"radius","in":"query","required":false,"description":"Yarıçap (m).","schema":{"type":"integer","minimum":100,"maximum":2000,"default":500},"example":500},{"name":"years","in":"query","required":false,"description":"Yıllar (virgülle; boşsa hepsi).","schema":{"type":"string","pattern":"^\\d+(,\\d+)*$"},"example":"2023,2024,2025"},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/sales/area":{"get":{"operationId":"sales_area","tags":["Çevre ve erişim"],"summary":"Bölge tapu satış özeti","description":"İl / ilçe / mahalle ya da hexagon hücresinde yıl × işlem türü TKGM satış adetleri, alan ve nüfus.\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"level","in":"query","required":true,"description":"Düzey.","schema":{"enum":["il","ilce","mah","hex2","hex3","hex4","hex5","hex6","hex7"]},"example":"ilce"},{"name":"id","in":"query","required":true,"description":"Bölge / hücre kimliği (/v1/sales/nearby → areas).","schema":{"type":"integer","minimum":1},"example":1186},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/demand/map":{"get":{"operationId":"demand_map","tags":["Çevre ve erişim"],"summary":"Talep yoğunluğu","description":"Platformdaki alım / kiralama / satış / kiraya verme taleplerinin il ya da ilçe bazında adetleri (en az 5 talep olan bölgeler).\n\n**Kredi:** 3 / başarılı istek.","x-credits":3,"parameters":[{"name":"type","in":"query","required":false,"description":"0 hepsi · 1 satılık arıyor · 2 kiralık arıyor · 3 satmak istiyor · 4 kiraya vermek istiyor.","schema":{"enum":["0","1","2","3","4"],"default":"0"},"example":"1"},{"name":"days","in":"query","required":false,"description":"Son kaç gün (0 = tümü).","schema":{"enum":["0","7","30","90","365"],"default":"0"},"example":"90"},{"name":"province","in":"query","required":false,"description":"İl plaka kodu (0 = Türkiye).","schema":{"type":"integer","minimum":0,"maximum":81,"default":0},"example":34},{"name":"level","in":"query","required":false,"description":"Düzey.","schema":{"enum":["il","ilce"],"default":"il"},"example":"ilce"},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/layers/summary":{"get":{"operationId":"layers_summary","tags":["Çevre ve erişim"],"summary":"Katman özeti (alan içi)","description":"Alandaki imar planı, 1/1000 plan fonksiyonu, tapu satışı, donatı ya da haber / şikâyet kayıtlarının yıl × tür adetleri.\n\n**Kredi:** 3 / başarılı istek.","x-credits":3,"parameters":[{"name":"dataset","in":"query","required":true,"description":"Veri seti.","schema":{"enum":["eplan","imar_parsel","tkgm_satis","poi","haber_sikayet"]},"example":"tkgm_satis"},{"name":"bbox","in":"query","required":true,"description":"Alan: batı,güney,doğu,kuzey (derece).","schema":{"type":"string","pattern":"^-?[\\d.]+,-?[\\d.]+,-?[\\d.]+,-?[\\d.]+$"},"example":"28.95,41.00,29.02,41.05"},{"name":"zoom","in":"query","required":false,"description":"Harita yakınlığı (alan genişliği sınırı: 14400 / 2^zoom derece).","schema":{"type":"integer","minimum":9,"maximum":18,"default":13},"example":13},{"name":"categories","in":"query","required":false,"description":"Tür kodları (boşsa hepsi).","schema":{"type":"string","pattern":"^\\d+(,\\d+)*$"},"example":"1,2"},{"name":"year_from","in":"query","required":false,"description":"Başlangıç yılı.","schema":{"type":"integer","minimum":2000,"maximum":2030},"example":2022},{"name":"year_to","in":"query","required":false,"description":"Bitiş yılı.","schema":{"type":"integer","minimum":2000,"maximum":2030},"example":2025},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/layers/plans":{"get":{"operationId":"layers_plans","tags":["Çevre ve erişim"],"summary":"Alandaki imar planları","description":"Alandaki e-Plan imar planları ya da 1/1000 plan fonksiyonlu parseller: başlık, tür, il / ilçe, tarih (en çok 50).\n\n**Kredi:** 3 / başarılı istek.","x-credits":3,"parameters":[{"name":"dataset","in":"query","required":true,"description":"eplan (planlar) ya da imar_parsel (parsel plan fonksiyonu).","schema":{"enum":["eplan","imar_parsel"]},"example":"eplan"},{"name":"bbox","in":"query","required":true,"description":"Alan: batı,güney,doğu,kuzey (derece).","schema":{"type":"string","pattern":"^-?[\\d.]+,-?[\\d.]+,-?[\\d.]+,-?[\\d.]+$"},"example":"28.95,41.00,29.02,41.05"},{"name":"zoom","in":"query","required":false,"description":"Harita yakınlığı.","schema":{"type":"integer","minimum":9,"maximum":18,"default":14},"example":14},{"name":"categories","in":"query","required":false,"description":"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.","schema":{"type":"string","pattern":"^\\d+(,\\d+)*$"},"example":"1,2"},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/market/yoy":{"get":{"operationId":"market_yoy","tags":["Piyasa verisi"],"summary":"Yıllık m² değişimi","description":"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.\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"Alt kategori.","schema":{"enum":[10010,10143,10125,10033,10056,10113,10026,10135],"default":10010},"example":10010},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/valuation/comparables":{"get":{"operationId":"valuation_comparables","tags":["Tapusor veri servisleri"],"summary":"Emsalli değer sorgusu","description":"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ı).\n\n**Kredi:** 10 / başarılı istek.","x-credits":10,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"status","in":"query","required":false,"description":"1 satılık, 2 kiralık.","schema":{"enum":[1,2],"default":1},"example":1},{"name":"category","in":"query","required":false,"description":"1 konut, 2 işyeri, 3 arsa.","schema":{"enum":[1,2,3],"default":1},"example":1},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (boşsa kategorinin tümü).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135]},"example":10010},{"name":"rooms","in":"query","required":false,"description":"Oda sayısı (konut; ör. 2+1).","schema":{"enum":["1+0","1+1","2+0","2+1","2+2","3+0","3+1","3+2","4+0","4+1","4+2+"]},"example":"2+1"},{"name":"m2","in":"query","required":false,"description":"Brüt m² (boşsa emsal medyanı).","schema":{"type":"integer","minimum":10,"maximum":1000000},"example":110},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/scores/edi":{"get":{"operationId":"score_edi","tags":["Tapusor veri servisleri"],"summary":"EDI yapay zekâ konum skoru","description":"Noktanın arz / talep, değer, ulaşım, projeler ve plan başlıklarında 0–100 puanları ve ortalaması (Tapusor EDI skoru).\n\n**Kredi:** 3 / başarılı istek.","x-credits":3,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/socioeconomics":{"get":{"operationId":"socio_tuik","tags":["Tapusor veri servisleri"],"summary":"TÜİK sosyoekonomik veriler","description":"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ı).\n\n**Kredi:** 3 / başarılı istek.","x-credits":3,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"topics","in":"query","required":false,"description":"Konu numaraları (boşsa hepsi; yanıttaki id alanı).","schema":{"type":"string","pattern":"^\\d+(,\\d+)*$"},"example":"1,2,3"},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/risk/earthquake":{"get":{"operationId":"risk_earthquake","tags":["Tapusor veri servisleri"],"summary":"Deprem risk puanı","description":"Deprem tehlikesi (PGA ivmesi), zemin ve yapı puanı, heyelan durumu ve bunların birleşik 0–100 sonucu ile risk sınıfı.\n\n**Kredi:** 3 / başarılı istek.","x-credits":3,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/sales/admin":{"get":{"operationId":"sales_admin","tags":["Tapusor veri servisleri"],"summary":"İdari birimde TKGM satışları","description":"İ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).\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"admin_id","in":"query","required":true,"description":"İl (<100), ilçe (<2500) ya da mahalle kimliği.","schema":{"type":"integer","minimum":1,"maximum":999999999},"example":1886},{"name":"analysis","in":"query","required":false,"description":"0 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.","schema":{"enum":[0,2,3,4,5],"default":0},"example":4},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/sales/trend":{"get":{"operationId":"sales_trend","tags":["Tapusor veri servisleri"],"summary":"TKGM satış serileri","description":"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.\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"level","in":"query","required":false,"description":"Kapsam.","schema":{"enum":["yaricap","il","ilce","mahalle"],"default":"yaricap"},"example":"ilce"},{"name":"radius","in":"query","required":false,"description":"Yarıçap (m; level=yaricap).","schema":{"type":"integer","minimum":100,"maximum":2000,"default":500},"example":500},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/market/ring-monthly":{"get":{"operationId":"market_ring_monthly","tags":["Tapusor veri servisleri"],"summary":"Halka bazlı aylık m² medyanı","description":"Noktanın hexagonu ve çevresindeki halkalarda aylık ilan medyan m² değeri, yumuşatılmış seri ve ilan adedi.\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (boşsa tümü).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135]},"example":10010},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/poi/nearest":{"get":{"operationId":"poi_nearest","tags":["Tapusor veri servisleri"],"summary":"En yakın donatılar","description":"500 m içinde her donatı türünün en yakın mesafesi ve adedi (işletme adı / konumu dönmez).\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"mode","in":"query","required":false,"description":"1 ana kategori, 2 kategori ve tür, 3 gürültü / etki analizi.","schema":{"enum":[1,2,3],"default":2},"example":2},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/index/kfe":{"get":{"operationId":"index_kfe","tags":["Tapusor veri servisleri"],"summary":"Konut Fiyat Endeksi (KFE)","description":"TCMB Konut Fiyat Endeksi aylık serisi; Türkiye ya da il.\n\n**Kredi:** 1 / başarılı istek.","x-credits":1,"parameters":[{"name":"province","in":"query","required":false,"description":"İl plaka kodu (boşsa Türkiye).","schema":{"type":"integer","minimum":1,"maximum":81},"example":34},{"name":"from","in":"query","required":false,"description":"Başlangıç (YYYY-AA-GG).","schema":{"type":"string","format":"date"},"example":"2024-01-01"},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/index/kfe/adjust":{"get":{"operationId":"index_kfe_adjust","tags":["Tapusor veri servisleri"],"summary":"Fiyatı bugüne taşıma (KFE)","description":"Geçmiş bir tarihteki fiyatı KFE ile son endeks ayına taşır (Tapusor alternatif fiyat).\n\n**Kredi:** 1 / başarılı istek.","x-credits":1,"parameters":[{"name":"price","in":"query","required":true,"description":"Fiyat (₺).","schema":{"type":"number","minimum":1,"maximum":1000000000000},"example":2500000},{"name":"date","in":"query","required":true,"description":"Fiyatın tarihi (YYYY-AA-GG).","schema":{"type":"string","format":"date"},"example":"2022-06-01"},{"name":"province","in":"query","required":false,"description":"İl plaka kodu (boşsa Türkiye endeksi).","schema":{"type":"integer","minimum":1,"maximum":81},"example":34},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/macro/sources":{"get":{"operationId":"macro_sources","tags":["Tapusor veri servisleri"],"summary":"Makro veri kaynakları","description":"TCMB / GYODER makro serilerinin listesi (konut satışları, kredi faizi, KFE, birim kiralar …): kimlik, periyot, değer kolonları. Ücretsizdir.\n\n**Kredi:** 0 / başarılı istek.","x-credits":0,"parameters":[{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/macro/series":{"get":{"operationId":"macro_series","tags":["Tapusor veri servisleri"],"summary":"Makro veri serisi","description":"Seçilen TCMB / GYODER serisinin tarih aralığındaki değerleri (kimlikler: /v1/macro/sources).\n\n**Kredi:** 1 / başarılı istek.","x-credits":1,"parameters":[{"name":"id","in":"query","required":true,"description":"Seri kimliği.","schema":{"type":"integer","minimum":1,"maximum":999},"example":1},{"name":"from","in":"query","required":false,"description":"Başlangıç (YYYY-AA-GG).","schema":{"type":"string","format":"date"},"example":"2024-01-01"},{"name":"to","in":"query","required":false,"description":"Bitiş (YYYY-AA-GG).","schema":{"type":"string","format":"date"},"example":"2026-06-01"},{"name":"order","in":"query","required":false,"description":"Sıralama.","schema":{"enum":["asc","desc"],"default":"asc"},"example":"desc"},{"name":"limit","in":"query","required":false,"description":"En çok satır.","schema":{"type":"integer","minimum":1,"maximum":2000,"default":500},"example":24},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/fay-hatti":{"get":{"operationId":"control_fay_hatti","tags":["Kontrol · Kritik risk ve yasal durum"],"summary":"Fay Hattı","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. (Teknik kontrol no 1.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/zemin-deprem-puani":{"get":{"operationId":"control_zemin_deprem_puani","tags":["Kontrol · Kritik risk ve yasal durum"],"summary":"Zemin Deprem Puanı","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. (Teknik kontrol no 2.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/heyelan-alani":{"get":{"operationId":"control_heyelan_alani","tags":["Kontrol · Kritik risk ve yasal durum"],"summary":"Heyelan Alanı","description":"Toprak kayması riski taşıyan bölgeleri gösterir. İnşaat maliyeti ve güvenlik açısından çok kritiktir. (Teknik kontrol no 3.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/su-havzasi-alani":{"get":{"operationId":"control_su_havzasi_alani","tags":["Kontrol · Kritik risk ve yasal durum"],"summary":"Su Havzası Alanı","description":"İç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.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/sulak-alan":{"get":{"operationId":"control_sulak_alan","tags":["Kontrol · Kritik risk ve yasal durum"],"summary":"Sulak Alan","description":"Ekolojik koruma altında olabilecek sulak bölgeleri ifade eder. Geliştirme kabiliyeti düşebilir. (Teknik kontrol no 5.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/sit-alani":{"get":{"operationId":"control_sit_alani","tags":["Kontrol · Kritik risk ve yasal durum"],"summary":"Sit Alanı","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. (Teknik kontrol no 6.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/orman-alani":{"get":{"operationId":"control_orman_alani","tags":["Kontrol · Kritik risk ve yasal durum"],"summary":"Orman Alanı","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. (Teknik kontrol no 7.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/kamulastirma-alani":{"get":{"operationId":"control_kamulastirma_alani","tags":["Kontrol · Kritik risk ve yasal durum"],"summary":"Kamulaştırma Alanı","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. (Teknik kontrol no 8.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/resmi-gazete-karari-kapsamindaki-alan":{"get":{"operationId":"control_resmi_gazete_karari_kapsamindaki_alan","tags":["Kontrol · Kritik risk ve yasal durum"],"summary":"Resmî Gazete Kararı Kapsamındaki Alan","description":"Merkezi idare kararıyla özel hükümlere tabi olabilecek alanları gösterir. Ani statü değişimi yaratabilir. (Teknik kontrol no 9.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/ova-koruma-alani":{"get":{"operationId":"control_ova_koruma_alani","tags":["Kontrol · Kritik risk ve yasal durum"],"summary":"Ova Koruma Alanı","description":"Tarımsal niteliği korunması gereken ovaları gösterir. Amaç dışı kullanım zorlaşabilir. (Teknik kontrol no 10.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/sorgu-disi-alan":{"get":{"operationId":"control_sorgu_disi_alan","tags":["Kontrol · Kritik risk ve yasal durum"],"summary":"Sorgu Dışı Alan","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. (Teknik kontrol no 11.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/imar-plani":{"get":{"operationId":"control_imar_plani","tags":["Kontrol · İmar hakları"],"summary":"İmar Planı","description":"Parselin ne şekilde kullanılabileceğini gösteren temel plan verisidir. Değer üretiminin ana belirleyicisidir. (Teknik kontrol no 12.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/yerlesim-alani":{"get":{"operationId":"control_yerlesim_alani","tags":["Kontrol · İmar hakları"],"summary":"Yerleşim Alanı","description":"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.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/kentsel-donusum-alani":{"get":{"operationId":"control_kentsel_donusum_alani","tags":["Kontrol · İmar hakları"],"summary":"Kentsel Dönüşüm Alanı","description":"Dönüşüm kapsamına alınmış bölgeleri ifade eder. Yüksek potansiyel kadar uygulama riski de içerir. (Teknik kontrol no 14.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/yenileme-alani":{"get":{"operationId":"control_yenileme_alani","tags":["Kontrol · İmar hakları"],"summary":"Yenileme Alanı","description":"Özellikle eski yerleşimlerde yenileme ve yeniden geliştirme odaklı alanlardır. Proje fırsatı yaratabilir. (Teknik kontrol no 15.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/plan-tadilat-alani":{"get":{"operationId":"control_plan_tadilat_alani","tags":["Kontrol · İmar hakları"],"summary":"Plan Tadilat Alanı","description":"Plan değişikliği yapılmış veya yapılmakta olan bölgeleri gösterir. (Teknik kontrol no 16.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/mega-projeler-alani":{"get":{"operationId":"control_mega_projeler_alani","tags":["Kontrol · İmar hakları"],"summary":"Mega Projeler Alanı (İstanbul)","description":"Büyük kamu veya özel ölçekli projelerin etkilediği alanlardır. (Teknik kontrol no 17.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/arazi-toplulastirma-alani":{"get":{"operationId":"control_arazi_toplulastirma_alani","tags":["Kontrol · İmar hakları"],"summary":"Arazi Toplulaştırma Alanı","description":"Tarımsal parsellerin yeniden düzenlendiği alanları gösterir. Özellikle kırsal yatırımda önemlidir. (Teknik kontrol no 18.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/parsel-degisikligi-yapilan-alan":{"get":{"operationId":"control_parsel_degisikligi_yapilan_alan","tags":["Kontrol · İmar hakları"],"summary":"Parsel Değişikliği Yapılan Alan","description":"Parsel yapısı sonradan değişmiş bölgeleri ifade eder. Tapu ve sınır okumalarında dikkat gerektirir. (Teknik kontrol no 19.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/kadastro-alani":{"get":{"operationId":"control_kadastro_alani","tags":["Kontrol · İmar hakları"],"summary":"Kadastro Alanı","description":"Kadastro verisi ve parsel sınırlarıyla ilgili katmandır. Mülkiyet doğrulaması için temel referanstır. (Teknik kontrol no 20.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/belediye-rayic":{"get":{"operationId":"control_belediye_rayic","tags":["Kontrol · Değer ve satış analitiği"],"summary":"Belediye Rayiç","description":"Belediyenin esas aldığı birim değer yaklaşımıdır. Taban referans sağlar. (Teknik kontrol no 21.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/populerlik-analizi":{"get":{"operationId":"control_populerlik_analizi","tags":["Kontrol · Değer ve satış analitiği"],"summary":"Popülerlik Analizi","description":"Bölgeye yönelik ilgi yoğunluğunu gösterir. Talep yönünü okumaya yardımcı olur. (Teknik kontrol no 23.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/tarla-satis-hizi":{"get":{"operationId":"control_tarla_satis_hizi","tags":["Kontrol · Değer ve satış analitiği"],"summary":"Tarla Satış Hızı","description":"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.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/daire-satis-hizi":{"get":{"operationId":"control_daire_satis_hizi","tags":["Kontrol · Değer ve satış analitiği"],"summary":"Daire Satış Hızı","description":"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.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/isyeri-satis-hizi":{"get":{"operationId":"control_isyeri_satis_hizi","tags":["Kontrol · Değer ve satış analitiği"],"summary":"İşyeri Satış Hızı","description":"Ticari taşınmazların satış temposunu gösterir. Yatırımın nakde dönüş hızını etkiler. (Teknik kontrol no 27.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/ana-tasinmaz-ipotekli-satis-skoru":{"get":{"operationId":"control_ana_tasinmaz_ipotekli_satis_skoru","tags":["Kontrol · Değer ve satış analitiği"],"summary":"Ana Taşınmaz İpotekli Satış Skoru","description":"Finansmanlı satış eğilimini ölçer. Krediye bağımlı piyasalarda önemli sinyaldir. (Teknik kontrol no 28.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/ana-tasinmaz-ipoteksiz-satis-skoru":{"get":{"operationId":"control_ana_tasinmaz_ipoteksiz_satis_skoru","tags":["Kontrol · Değer ve satış analitiği"],"summary":"Ana Taşınmaz İpoteksiz Satış Skoru","description":"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.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/bagimsiz-bolum-ipotekli-satis-skoru":{"get":{"operationId":"control_bagimsiz_bolum_ipotekli_satis_skoru","tags":["Kontrol · Değer ve satış analitiği"],"summary":"Bağımsız Bölüm İpotekli Satış Skoru","description":"Daire/ofis gibi bağımsız birimlerde kredi destekli satış davranışını ölçer. Konut piyasasında anlamlıdır. (Teknik kontrol no 30.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/bagimsiz-bolum-ipoteksiz-satis-skoru":{"get":{"operationId":"control_bagimsiz_bolum_ipoteksiz_satis_skoru","tags":["Kontrol · Değer ve satış analitiği"],"summary":"Bağımsız Bölüm İpoteksiz Satış Skoru","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. (Teknik kontrol no 31.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/bina-alan":{"get":{"operationId":"control_bina_alan","tags":["Kontrol · Fiziksel ve mekânsal özellikler"],"summary":"Bina (Fiziki Yapılaşmış) Alan","description":"Yapılaşmış alan bilgisini verir. Yoğunluk ve mevcut kullanım hakkında fikir sağlar. (Teknik kontrol no 32.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/site-alani":{"get":{"operationId":"control_site_alani","tags":["Kontrol · Fiziksel ve mekânsal özellikler"],"summary":"Site Alanı","description":"Toplu konut/site düzeni içindeki bölgeleri gösterir. Güvenlik ve yaşam standardı beklentisini etkiler. (Teknik kontrol no 33.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/ortalama-bina-yasi":{"get":{"operationId":"control_ortalama_bina_yasi","tags":["Kontrol · Fiziksel ve mekânsal özellikler"],"summary":"Ortalama Bina Yaşı","description":"Yapı stokunun yaş ortalamasını gösterir. Dönüşüm potansiyeli ve bakım maliyeti açısından önemlidir. (Teknik kontrol no 34.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/bogaz-gorunum":{"get":{"operationId":"control_bogaz_gorunum","tags":["Kontrol · Fiziksel ve mekânsal özellikler"],"summary":"Boğaz Görünüm","description":"Manzara etkisini gösterir. Prestij ve fiyat primi yaratabilir ama temel yatırım verisi değildir. (Teknik kontrol no 35.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/deniz-gol-alani":{"get":{"operationId":"control_deniz_gol_alani","tags":["Kontrol · Fiziksel ve mekânsal özellikler"],"summary":"Deniz Göl Alanı","description":"Büyük su kütleleriyle ilişkili alan bilgisidir. Çevresel, görsel ve kullanım etkisi olabilir. (Teknik kontrol no 36.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/su-yuzeyi-alani":{"get":{"operationId":"control_su_yuzeyi_alani","tags":["Kontrol · Fiziksel ve mekânsal özellikler"],"summary":"Su Yüzeyi Alanı","description":"Gölet, nehir, kanal veya açık su yüzeylerini ifade eder. Kullanım ve manzara etkisi yaratır. (Teknik kontrol no 37.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/ulasim-agi":{"get":{"operationId":"control_ulasim_agi","tags":["Kontrol · Altyapı ve stratejik konum"],"summary":"Ulaşım Ağı","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. (Teknik kontrol no 38.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/elektrik-sebekesi-alani":{"get":{"operationId":"control_elektrik_sebekesi_alani","tags":["Kontrol · Altyapı ve stratejik konum"],"summary":"Elektrik Şebekesi Alanı","description":"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.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/osb-alani":{"get":{"operationId":"control_osb_alani","tags":["Kontrol · Altyapı ve stratejik konum"],"summary":"OSB Alanı","description":"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.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/havamania-alani":{"get":{"operationId":"control_havamania_alani","tags":["Kontrol · Altyapı ve stratejik konum"],"summary":"Havamania Alanı","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. (Teknik kontrol no 41.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-havalimani":{"get":{"operationId":"control_en_yakin_havalimani","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Havalimanı","description":"Şehrin dış bağlantısına erişim düzeyini ifade eder. Lojistik, turizm ve üst segment projelerde önemlidir. (Teknik kontrol no 42.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-metro-duragi":{"get":{"operationId":"control_en_yakin_metro_duragi","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Metro Durağı","description":"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.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-metrobus-duragi":{"get":{"operationId":"control_en_yakin_metrobus_duragi","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Metrobüs Durağı","description":"Yoğun toplu taşımaya erişimi ölçer. Özellikle İstanbul özelinde çok anlamlıdır. (Teknik kontrol no 44.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-otobus-duragi":{"get":{"operationId":"control_en_yakin_otobus_duragi","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Otobüs Durağı","description":"Temel toplu taşıma erişimini gösterir. Mikro lokasyon kararında destekleyicidir. (Teknik kontrol no 45.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-minibus-duragi":{"get":{"operationId":"control_en_yakin_minibus_duragi","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Minibüs Durağı","description":"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.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-taksi-duragi":{"get":{"operationId":"control_en_yakin_taksi_duragi","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Taksi Durağı","description":"Hızlı bireysel ulaşım erişimini gösterir. Ticari ve konut kullanımında destekleyici veridir. (Teknik kontrol no 47.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-hastane":{"get":{"operationId":"control_en_yakin_hastane","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Hastane","description":"Sağlık hizmetine erişimi gösterir. Konut talebi ve yaşanabilirlik açısından önemlidir. (Teknik kontrol no 48.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-universite":{"get":{"operationId":"control_en_yakin_universite","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Üniversite","description":"Öğrenci ve akademik nüfus etkisini gösterir. Kiralık konut ve ticari talep üretir. (Teknik kontrol no 49.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-karakol":{"get":{"operationId":"control_en_yakin_karakol","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Karakol","description":"Güvenlik hizmetine erişimi gösterir. Bölge algısı üzerinde dolaylı etkisi vardır. (Teknik kontrol no 50.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-egitim-kurumu":{"get":{"operationId":"control_en_yakin_egitim_kurumu","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Eğitim Kurumu","description":"Okul veya eğitim fonksiyonlarıyla ilişkili alanları belirtir. Aile odaklı konut talebinde önemlidir. (Teknik kontrol no 51.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/ekilebilir-alan":{"get":{"operationId":"control_ekilebilir_alan","tags":["Kontrol · Tarım ve doğal kullanım"],"summary":"Ekilebilir Alan","description":"Tarımsal üretime uygun alanları gösterir. Tarla yatırımında temel kriterdir. (Teknik kontrol no 52.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/kalici-mahsul-alan":{"get":{"operationId":"control_kalici_mahsul_alan","tags":["Kontrol · Tarım ve doğal kullanım"],"summary":"Kalıcı Mahsul Alan","description":"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.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/mera-alan":{"get":{"operationId":"control_mera_alan","tags":["Kontrol · Tarım ve doğal kullanım"],"summary":"Mera Alan","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. (Teknik kontrol no 54.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/heterojen-tarim-alani":{"get":{"operationId":"control_heterojen_tarim_alani","tags":["Kontrol · Tarım ve doğal kullanım"],"summary":"Heterojen Tarım Alanı","description":"Karışık tarımsal kullanım yapısına sahip bölgeleri gösterir. Net kullanım analizi gerektirir. (Teknik kontrol no 55.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/altlik-parseller":{"get":{"operationId":"control_altlik_parseller","tags":["Kontrol · Destekleyici veriler"],"summary":"Altlık Parseller","description":"Referans parsel katmanıdır. Komşuluk ve sınır okumasında yardımcı olur. (Teknik kontrol no 56.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/sehir-atlasi-tucbs":{"get":{"operationId":"control_sehir_atlasi_tucbs","tags":["Kontrol · Destekleyici veriler"],"summary":"Şehir Atlası TUCBS","description":"Bölgesel veri ve katmanları bir araya getiren genel analiz ekranıdır. Makro bakış sağlar. (Teknik kontrol no 59.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/sehir-atlasi-tuvimer":{"get":{"operationId":"control_sehir_atlasi_tuvimer","tags":["Kontrol · Destekleyici veriler"],"summary":"Şehir Atlası Tuvimer","description":"Bölgesel veri ve katmanları bir araya getiren genel analiz ekranıdır. Makro bakış sağlar. (Teknik kontrol no 60.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/tkgm-satis-alani":{"get":{"operationId":"control_tkgm_satis_alani","tags":["Kontrol · Destekleyici veriler"],"summary":"TKGM Satış Alanı","description":"Tapu Kadastro satış verisiyle ilişkili alan bilgisidir. Resmî işlem yoğunluğu görmek için destekleyicidir. (Teknik kontrol no 61.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/lokasyon-bilgisi":{"get":{"operationId":"control_lokasyon_bilgisi","tags":["Kontrol · Destekleyici veriler"],"summary":"Lokasyon Bilgisi","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. (Teknik kontrol no 62.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/resmi-gazete-karari":{"get":{"operationId":"control_resmi_gazete_karari","tags":["Kontrol · Destekleyici veriler"],"summary":"Resmî Gazete Kararı (2 km)","description":"Merkezi idare kararıyla özel hükümlere tabi olabilecek alanları gösterir. Ani statü değişimi yaratabilir. (Teknik kontrol no 63.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-starbucks":{"get":{"operationId":"control_en_yakin_starbucks","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Starbucks","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. (Teknik kontrol no 65.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-migros":{"get":{"operationId":"control_en_yakin_migros","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Migros","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. (Teknik kontrol no 66.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-a101":{"get":{"operationId":"control_en_yakin_a101","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın A101","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 noktasıdır. (Teknik kontrol no 67.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-bim":{"get":{"operationId":"control_en_yakin_bim","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın BİM","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. (Teknik kontrol no 68.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-sok":{"get":{"operationId":"control_en_yakin_sok","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Şok","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. (Teknik kontrol no 69.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-avm":{"get":{"operationId":"control_en_yakin_avm","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın AVM","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. (Teknik kontrol no 70.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-sinema":{"get":{"operationId":"control_en_yakin_sinema","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Sinema","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ırsatları açısından önemli bir gösterge sunar. (Teknik kontrol no 71.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-tiyatro":{"get":{"operationId":"control_en_yakin_tiyatro","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Tiyatro","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 ticari birimler için değer artışı potansiyeli sunar. (Teknik kontrol no 72.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-cami":{"get":{"operationId":"control_en_yakin_cami","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Cami","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 sunarak ticari potansiyelin değerlendirilmesine katkı sağlar. (Teknik kontrol no 73.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-plaj":{"get":{"operationId":"control_en_yakin_plaj","tags":["Kontrol · Lokasyon erişimi"],"summary":"En Yakın Plaj","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 ticari potansiyel üzerinde olumlu etki yaratır. (Teknik kontrol no 74.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/en-yakin-noktalar-analizi":{"get":{"operationId":"control_en_yakin_noktalar_analizi","tags":["Kontrol · Destekleyici veriler"],"summary":"En Yakın Noktalar Analizi","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 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.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/technical/controls/askidaki-plan":{"get":{"operationId":"control_askidaki_plan","tags":["Kontrol · İmar hakları"],"summary":"Askıdaki Plan","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. (Teknik kontrol no 77.)\n\n**Kredi:** 2 / başarılı istek.","x-credits":2,"parameters":[{"name":"lat","in":"query","required":true,"description":"Enlem (WGS84, Türkiye).","schema":{"type":"number","minimum":35.5,"maximum":42.5},"example":41.0369},{"name":"lng","in":"query","required":true,"description":"Boylam (WGS84, Türkiye).","schema":{"type":"number","minimum":25.5,"maximum":45},"example":28.985},{"name":"subcategory","in":"query","required":false,"description":"İlan alt kategorisi (bkz. /v1/products → subcategories).","schema":{"enum":[10010,10176,10033,10026,10056,10216,10143,10125,10113,10135],"default":10010},"example":10010},{"name":"resolution","in":"query","required":false,"description":"Hexagon çözünürlüğü (bölgesel kontrollerde).","schema":{"enum":[2,3,4,5,6,7],"default":5},"example":5},{"name":"format","in":"query","required":false,"description":"Çıktı biçimi: json (varsayılan), geojson (FeatureCollection), text (düz metin).","schema":{"enum":["json","geojson","text"],"default":"json"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Basari"}}}},"401":{"$ref":"#/components/responses/Hata"},"403":{"$ref":"#/components/responses/Hata"},"422":{"$ref":"#/components/responses/Hata"},"429":{"$ref":"#/components/responses/Hata"},"5XX":{"$ref":"#/components/responses/Hata"}}}},"/usage":{"get":{"operationId":"usage","tags":["Hesap"],"summary":"Kullanım ve kalan kredi","description":"Geçerli fatura dönemi, plan, kullanılan / kalan kredi, ürün kırılımı. Ücretsiz.","responses":{"200":{"description":"Başarılı"},"401":{"$ref":"#/components/responses/Hata"}}}},"/products":{"get":{"operationId":"products","tags":["Hesap"],"summary":"Ürün ve kredi listesi","security":[],"responses":{"200":{"description":"Başarılı"}}}},"/token":{"post":{"operationId":"token","tags":["Hesap"],"summary":"JWT al (24 saat)","description":"API anahtarıyla (Bearer tsk_… ya da X-API-Key) çağrılır; gövde gerekmez. Dönen access_token Tapusor üyesinin i_user'ını içerir (sub, i_user) ve tüm uçlarda Bearer olarak kullanılır; diğer Tapusor servisleri açık anahtarla (GET /v1/jwks) doğrular. Hesap bir Tapusor üyesine bağlı değilse 403 account_no_user. Kredi düşmez.","responses":{"200":{"description":"access_token, token_type, expires_in, expires_at, i_user, jwks_uri"},"401":{"description":"Anahtar geçersiz"},"403":{"description":"account_no_user / account_suspended / ip_not_allowed"}}}},"/jwks":{"get":{"operationId":"jwks","tags":["Hesap"],"summary":"JWT açık anahtarı (JWKS)","security":[],"responses":{"200":{"description":"RS256 açık anahtar (kid)"}}}}}}