Use this when the user wants to find or see property listings; results are shown with real photos in the Evlek widget. Search live Evlek property listings for sale and long-term rent in Northern Cyprus (KKTC/TRNC; prices in GBP unless a currency is given; 2+1 means bedrooms 2) with structured filters: transaction, city, district, property type, bedrooms, price, areas, amenities, nearby university. Pass the user's language as `locale` (tr|en|ru|de|ar): the text, amenity names, number formats and links follow it. Returns at most 10 listings per call, each as one readable line (type, place, price, rooms, area, a deterministic sentence, data notes, canonical link) plus a structured card; continue with the `nextCursor` of a group. Without `transaction`, listings for sale and for rent come as two separate groups, each with its own cursor that is only valid together with that group's transaction. Place names in any language are resolved; an unknown place returns suggestions instead of results. An amenity that cannot be filtered on is reported as not applied. Returns advertised asking-price and listing facts only: not a valuation, verification of property-specific claims, forecast, ranking or recommendation.
View input schema
{
"type": "object",
"properties": {
"transaction": {
"type": "string",
"description": "'sale' or 'rent' (long-term). REQUIRED with priceMin, priceMax, a price sort or cursor. Omit only to browse both together.",
"enum": [
"sale",
"rent"
]
},
"city": {
"type": "array",
"description": "City names in any language, e.g. [\"Girne\"] or [\"Kyrenia\", \"Famagusta\"]; ANY match counts. Towns and villages go in `district`.",
"maxItems": 10,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 60
}
},
"district": {
"type": "array",
"description": "Districts, towns or villages in any language, e.g. [\"Alsancak\"]; ANY match counts. With city [\"Girne\"], [\"Merkez\"] means Girne Merkez.",
"maxItems": 20,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 60
}
},
"propertyType": {
"type": "array",
"description": "Property types, ANY match: single types or groups (house, land, commercial), e.g. [\"apartment\", \"penthouse\"] or [\"house\"].",
"maxItems": 12,
"items": {
"type": "string",
"description": "A property type, or a group: house = villa, detached, bungalow; land = residential_land, commercial_land, farmland; commercial = shop, office, warehouse, whole_building, hotel.",
"enum": [
"apartment",
"residence",
"villa",
"twin",
"detached",
"bungalow",
"penthouse",
"studio",
"duplex",
"shop",
"office",
"warehouse",
"whole_building",
"hotel",
"residential_land",
"commercial_land",
"farmland",
"house",
"land",
"commercial"
]
}
},
"bedrooms": {
"type": "object",
"description": "Bedrooms as an object: {\"exact\": 3}, {\"min\": 2} or {\"min\": 2, \"max\": 4}; integers 0-20. Use exact for \"a 3-bedroom\".",
"properties": {
"min": {
"type": "integer",
"description": "Minimum number of bedrooms, inclusive.",
"minimum": 0,
"maximum": 20
},
"max": {
"type": "integer",
"description": "Maximum number of bedrooms, inclusive.",
"minimum": 0,
"maximum": 20
},
"exact": {
"type": "integer",
"description": "Exact number of bedrooms; 0 means a studio. Cannot be combined with min or max.",
"minimum": 0,
"maximum": 20
}
},
"additionalProperties": false
},
"bathroomsMin": {
"type": "integer",
"description": "Minimum number of bathrooms, inclusive (1-20).",
"minimum": 1,
"maximum": 20
},
"areaMin": {
"type": "number",
"description": "Minimum CLOSED (built, indoor) area in m², inclusive. For plots and gardens use landAreaMin instead.",
"minimum": 0,
"maximum": 10000000
},
"areaMax": {
"type": "number",
"description": "Maximum closed (built, indoor) area in m², inclusive.",
"minimum": 0,
"maximum": 10000000
},
"landAreaMin": {
"type": "number",
"description": "Minimum plot (land) area in m², inclusive: villas, houses, bungalows and land.",
"minimum": 0,
"maximum": 10000000
},
"landAreaMax": {
"type": "number",
"description": "Maximum plot (land) area in m², inclusive.",
"minimum": 0,
"maximum": 10000000
},
"priceMin": {
"type": "number",
"description": "Minimum price, inclusive, in `currency`: the asking price for sale, the monthly rent for rent. Requires `transaction`.",
"minimum": 0,
"maximum": 1000000000000
},
"priceMax": {
"type": "number",
"description": "Maximum price, inclusive, in `currency` (\"under 300000\" → 300000): the asking price for sale, the monthly rent for rent. Requires `transaction`.",
"minimum": 0,
"maximum": 1000000000000
},
"currency": {
"type": "string",
"description": "Currency of priceMin and priceMax: GBP (default), EUR, USD or TRY. Converted to GBP on the server at the current Evlek rate.",
"default": "GBP",
"enum": [
"GBP",
"EUR",
"USD",
"TRY"
]
},
"features": {
"type": "array",
"description": "Amenities the listing must have (ALL must match), any language, e.g. [\"pool\", \"sea view\", \"elevator\"]. Others are reported as not filterable.",
"maxItems": 20,
"items": {
"type": "string",
"description": "An amenity name in any language. Only these can be filtered: Furnished, Fridge, Washing Machine, Dishwasher, Air Conditioning, Television, Bed, Desk, Wi-Fi, Smart Home, Central Heating, Garden, Terrace, Parking, Pool, Elevator, Security/CCTV, Generator, Sea View, Bills Included, Available Now. Any other amenity is reported as not filterable.",
"minLength": 1,
"maxLength": 60
}
},
"furnished": {
"type": "boolean",
"description": "true = furnished listings only, false = unfurnished only. Omit for both."
},
"billsIncluded": {
"type": "boolean",
"description": "Rentals only: true = the rent includes utility bills. Without `transaction` the search is limited to rent."
},
"availableNow": {
"type": "boolean",
"description": "Rentals only: true = can be moved into immediately. Without `transaction` the search is limited to rent."
},
"noDeposit": {
"type": "boolean",
"description": "Rentals only: true = no security deposit is required."
},
"contractType": {
"type": "string",
"description": "Contract type. Rentals: 'monthly', 'semester' or 'yearly'. Sales: 'cash' or 'installment'. Must fit `transaction`.",
"enum": [
"monthly",
"semester",
"yearly",
"cash",
"installment"
]
},
"nearUniversity": {
"type": "object",
"description": "Listings close to one university, e.g. {\"code\": \"NEU\", \"maxMeters\": 1000}. Useful for student housing.",
"properties": {
"code": {
"type": "string",
"description": "University code: NEU = Near East University, DAU = Eastern Mediterranean University, GAU = Girne American University, CIU = Cyprus International University, EUL = European University of Lefke, BAU = BAU Cyprus University, AKU = University of Mediterranean Karpasia.",
"enum": [
"NEU",
"DAU",
"GAU",
"CIU",
"EUL",
"BAU",
"AKU"
]
},
"maxMeters": {
"type": "integer",
"description": "Maximum distance to that university in metres, at least 250 (default 2000; the site offers 500, 1000 and 2000). Listing distances are rounded up to 250 m steps.",
"default": 2000,
"minimum": 250,
"maximum": 50000
}
},
"required": [
"code"
],
"additionalProperties": false
},
"bbox": {
"type": "object",
"description": "Map rectangle in Northern Cyprus, WGS84 degrees: {west, south, east, north}. For \"this map area\" only; otherwise use city and district.",
"properties": {
"west": {
"type": "number",
"description": "Left edge, longitude in decimal degrees (32.7 to 34.65). Must be smaller than east.",
"minimum": 32.7,
"maximum": 34.65
},
"south": {
"type": "number",
"description": "Bottom edge, latitude in decimal degrees (34.95 to 35.78). Must be smaller than north.",
"minimum": 34.95,
"maximum": 35.78
},
"east": {
"type": "number",
"description": "Right edge, longitude in decimal degrees. Must be larger than west.",
"minimum": 32.7,
"maximum": 34.65
},
"north": {
"type": "number",
"description": "Top edge, latitude in decimal degrees. Must be larger than south.",
"minimum": 34.95,
"maximum": 35.78
}
},
"required": [
"west",
"south",
"east",
"north"
],
"additionalProperties": false
},
"sort": {
"type": "string",
"description": "Order, default 'newest'. price-low = cheapest first, price-high = dearest first (both need transaction); others: see schema description.",
"default": "newest",
"enum": [
"newest",
"price-low",
"price-high",
"price-per-sqm-asc",
"area-large",
"area-small",
"nearest-uni"
]
},
"limit": {
"type": "integer",
"description": "Number of listings to return, 1-10 (default 8, maximum 10). Ask for more with `cursor`, never with a larger limit.",
"default": 8,
"minimum": 1,
"maximum": 10
},
"cursor": {
"type": "string",
"description": "Pass the previous `nextCursor` with the SAME filters, sort and transaction. Opaque: never build or edit it. Requires `transaction`.",
"minLength": 16,
"maxLength": 1024,
"pattern": "^[A-Za-z0-9_-]+$"
},
"locale": {
"type": "string",
"description": "Language of the response text, feature names, number formats and links: tr, en, ru, de, ar (default en). Pass the language the user is writing in.",
"default": "en",
"enum": [
"tr",
"en",
"ru",
"de",
"ar"
]
}
},
"description": "Structured search over active Evlek property listings in Northern Cyprus (sale and long-term rent; holiday lets are not offered). Every field is optional; a listing must match ALL the fields you set. `transaction` is required when you filter or sort by price or page with `cursor`. At most 10 listings are returned per call; continue with `cursor`. Sort orders: newest = latest first (default), price-low = cheapest first, price-high = most expensive first, price-per-sqm-asc = lowest price per m², area-large / area-small = largest / smallest closed area, nearest-uni = closest to a university. Pass `locale` in the language the user writes in.",
"additionalProperties": false
}