Input schema (JSON)
{
"type": "object",
"title": "search_listingsArguments",
"properties": {
"deal": {
"anyOf": [
{
"enum": [
"Sale",
"Rent"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Deal",
"default": null,
"description": "Sale or Rent"
},
"kind": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"apartment",
"villa",
"house",
"townhouse",
"penthouse"
],
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Kind",
"default": null,
"description": "Property type(s), e.g. ['villa', 'house']"
},
"sort": {
"enum": [
"recommended",
"price_asc",
"price_desc",
"newest"
],
"type": "string",
"title": "Sort",
"default": "recommended",
"description": "recommended = featured first, then newest"
},
"type": {
"anyOf": [
{
"enum": [
"Residential",
"Commercial"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Type",
"default": null,
"description": "Property type"
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"maximum": 10,
"minimum": 1,
"description": "How many listings to return, 1–10"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Cursor",
"default": null,
"description": "next_cursor from a previous call, for more results"
},
"layout": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Layout",
"default": null,
"description": "'studio', '1+1', '2+1', '3+1', or '4+' for 4 or more bedrooms"
},
"poster": {
"anyOf": [
{
"enum": [
"owner",
"agent",
"developer"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Poster",
"default": null,
"description": "Only listings where the author says they are the owner / an agent / the developer"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Region",
"default": null,
"description": "girne (Kyrenia), iskele, famagusta, lefkosha (Nicosia), guzelyurt, lefke"
},
"area_min": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Area Min",
"default": null,
"description": "Minimum area in m²"
},
"currency": {
"anyOf": [
{
"enum": [
"GBP",
"EUR",
"USD"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Currency",
"default": null,
"description": "Currency of price_min/max, default GBP"
},
"features": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"pool",
"private_pool",
"sea_view",
"beach",
"garden",
"pets",
"furnished",
"land"
],
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Features",
"default": null,
"description": "Amenities mentioned in the listing; all must match"
},
"has_photo": {
"type": "boolean",
"title": "Has Photo",
"default": false,
"description": "Only listings with photos"
},
"price_max": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Price Max",
"default": null,
"description": "Maximum price in `currency`"
},
"price_min": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Price Min",
"default": null,
"description": "Minimum price in `currency`"
},
"sub_region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Sub Region",
"default": null,
"description": "Area within a region, e.g. 'Long Beach', 'Bogaz', 'Esentepe', 'Alsancak' (see list_regions)"
},
"deposit_max": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Deposit Max",
"default": null,
"description": "Rent: max number of deposits; 0 = no deposit only"
},
"price_period": {
"anyOf": [
{
"enum": [
"month",
"day",
"total"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Price Period",
"default": null,
"description": "month = monthly rent, day = daily/holiday rent, total = sale price"
}
}
}