Search real estate
search_real_estateFull Description
Searches real estate in Turkey.
city, listingType, and mainCategory are required — the user must specify which city to search in, whether they are looking for a property for sale or for rent, and the main category of the property.
Location hierarchy (from largest to smallest):
- city (İl): Top level, e.g., İstanbul, Ankara (required)
- county (İlçe): Under city, e.g., Şişli is a county in İstanbul
- district (Mahalle): Under county, e.g., Fulya is a district in Şişli
- area: Specific neighborhoods or landmarks within a county
Use the locationQuery parameter to narrow down to a specific county, district, or area within the city. If no locationQuery is provided, searches the entire city. Room / Section count fields – important distinction:
- For residential properties (konut / daire / residence type) — when
mainCategoryis residential: bedroomCount: number of bedrooms (yatak odası)livingRoomCount: number of living rooms / salons (usually the larger "salon" area)isStudio: true = studio apartment (no separate bedroom)
Turkish users very commonly use the "X+Y" notation (salon + yatak odası), e.g.:
- "3+1" → bedroomCount: 3, livingRoomCount: 1
- "2+1" → bedroomCount: 2, livingRoomCount: 1
- "4+2" → bedroomCount: 4, livingRoomCount: 2
- "5+1" → bedroomCount: 5, livingRoomCount: 1
→ Automatically detect and parse this notation when it appears in the user's natural language query and map it to the correct schema fields.
- For commercial properties (işyeri / office / shop / warehouse etc.) — when
mainCategoryis commercial: sectionNumber: number of sections / rooms / compartments (bölüm sayısı)
Commonly used in Turkish commercial listings as "3 bölümlü", "4 odalı ofis", etc. Example mapping: "3 bölümlü" or "3 odalı" → sectionNumber: 3
Summary – which field to use depending on mainCategory:
| mainCategory | Use these fields for room/section count | Turkish example notation | |----------------|------------------------------------------------------|-------------------------------| | Residential | bedroomCount + livingRoomCount (or isStudio) | 3+1, 2+1, 4+2, stüdyo | | Commercial | sectionNumber | 3 bölümlü, 4 odalı |
Recognize and convert this popular notation automatically when the user uses it in their query.
The response may include alternative location suggestions if multiple locations match the query.
Parameters (3 required, 26 optional)
citystringCity to search real estate in.
AdanaAdıyamanAfyonkarahisarAksarayAmasyaAnkaraAntalyaArdahanArtvinAydınAğrıBalıkesirBartınBatmanBayburtBilecikBingölBitlisBoluBurdurBursaDenizliDiyarbakırDüzceEdirneElazığErzincanErzurumEskişehirGaziantepGiresunGümüşhaneHakkariHatayIspartaIğdırKahramanmaraşKarabükKaramanKarsKastamonuKayseriKilisKocaeliKonyaKütahyaKıbrısKırklareliKırıkkaleKırşehirMalatyaManisaMardinMersinMuğlaMuşNevşehirNiğdeOrduOsmaniyeRizeSakaryaSamsunSiirtSinopSivasTekirdağTokatTrabzonTunceliUşakVanYalovaYozgatZonguldakÇanakkaleÇankırıÇorumİstanbulİzmirŞanlıurfaŞırnaklistingTypestringListing type of real estate to search for (rent, sale).
SatılıkKiralıkmainCategorystringMain category of real estate to search for.
KonutArsaİş YeriDevremülkTuristik İşletmeavailableForLoanbooleanWhether real estate should be available for loan — residential and sale only.
bedroomCountnumberNumber of bedrooms — used for residential properties (konut).
buildingAgestringBuilding age category (e.g. New Build, 1-5 Years, etc.) — residential, commercial and timeshare only
New Build1-56-1011-1516-2021+commercialTypestringCommercial type (ofis, dükkan, depo vb.) — only relevant when mainCategory is commercial.
Apartman DairesiAtölyeBenzin İstasyonuBinaBüfeBüroCafe & BarÇiftlikDepoDüğün SalonuDükkan & MağazaFabrikaHastaneİmalathaneİş Hanıİş Hanı KatıKantinKır & Kahvaltı BahçesiKıraathaneMaden OcağıOfisOto Yıkama & KuaförPastane, Fırın & TatlıcıPazar YeriPlazaPlaza KatıRadyo İstasyonu & TV KanalıRestoran & LokantaSağlık MerkeziSinema & Konferans SalonuSPA, Hamam & SaunaSpor TesisiTuristik İşletmeVillaVilla KatıhasAirConditioningbooleanWhether the property has air conditioning (split, central, VRV, etc.)
hasBalconybooleanWhether real estate should have a balcony - residential and timeshare only
hasElevatorbooleanWhether real estate should have an elevator.
hasFurnishedbooleanWhether real estate should be furnished.
hasGarageOrParkingbooleanWhether real estate should have a garage or parking space.
hasGardenbooleanWhether real estate should have a garden.
hasSecuritybooleanWhether the property has security features (24/7 security, security guard, CCTV, etc.)
hasWaterTankbooleanWhether the property has a water tank / water depot
heatingTypestringHeating system type (e.g. Central Heating, Underfloor, Combi Boiler, etc.) — residential, commercial and timeshare only
Güneş EnerjisiKat KaloriferiKlimaKombiMerkeziSobaJeotermal IsıtmaYokBelirtilmemişMerkezi (Pay Ölçer)Yerden IsıtmaDoğalgaz SobasıFancoil ÜnitesiVRVIsı PompasıŞömineisStudiobooleanWhether to search for studio apartments (no separate bedroom) — residential only.
landTypestringLand type — only relevant when mainCategory is land.
BağBahçeÇiftlikDepo, Antrepo İzinliHastane (Sağlık Tesisi)İmarlı - Konutİmarlı - Sanayiİmarlı - TicariKonut+TicaretMaden OcağıMuhtelif ArsaOkul (Eğitim Tesisi)Özel KullanımSit AlanıTarlaToplu Konut için TahsisTuristik ArsaZeytinlikİmarlı VillalivingRoomCountnumberNumber of living rooms — used for residential properties (konut).
locationQuerystringOptional: Search query to find a specific location within the city. Searches counties, districts, and areas. Max 50 characters. Examples: "Şişli", "Kadıköy", "Fulya".
maxAreanumberMaximum area (sqm).
maxPricenumberMaximum price.
minAreanumberMinimum area (sqm).
minPricenumberMinimum price.
residentialTypestringResidential type (konut) — only relevant when mainCategory is residential.
DaireÇiftlik EviDağ EviBinaKooperatifKöşkKöy EviMüstakil EvResidenceVillaYalıYalı DairesiYazlıkLoft DairePrefabrikBungalovsectionNumbernumberNumber of sections/rooms (ör: 3 bölümlü, 3 odalı) — used for commercial properties (işyeri).
timeShareTypestringTimeshare type — only relevant when mainCategory is timeshare.
Apartman DairesiVillaDublexTriplextouristicWorkplaceTypestringTouristic workplace type — only relevant when mainCategory is touristic workplace.
ApartButik OtelKaplıca TesisiMocampMotelOtelPansiyonTatil KöyüwithinHousingEstatebooleanWhether real estate should be within a housing estate — residential only.