Input schema (JSON)
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "1-based page number. Use it with `total` to walk through a large result set."
},
"sort": {
"enum": [
"recent",
"price_asc",
"price_desc"
],
"type": "string",
"description": "Result order. Default `recent` (most recently published first)."
},
"limit": {
"type": "number",
"description": "Results per page (default 10, max 20)."
},
"minArea": {
"type": "number",
"description": "Minimum floor area in m². Matches either the gross or the useful area, whichever the source published. Only matches listings that published an area."
},
"location": {
"type": "string",
"description": "Location: district, municipality, neighbourhood, town or postal-code prefix (e.g. Lisbon, Cascais, Chiado, 2750). Not a free-text keyword search — words that are not places (e.g. 'sea view') will not match."
},
"priceMax": {
"type": "number",
"description": "Maximum price, in the market currency. Note: listings advertised 'price on request' have no price and are excluded by either price bound."
},
"priceMin": {
"type": "number",
"description": "Minimum price, in the market currency."
},
"typology": {
"type": [
"string",
"array"
],
"items": {
"type": "string"
},
"description": "Normalised typology code (T0, T1, T2, T3…), where the number is the count of bedrooms. Used in every market, including the German and Polish ones. Matched exactly; pass an array to match several. The buckets `T0–T1` and `T4+` are also accepted."
},
"condition": {
"type": [
"string",
"array"
],
"items": {
"enum": [
"new",
"used",
"to_renovate",
"under_construction"
],
"type": "string"
},
"description": "State of repair, or an array of states. Only matches listings whose source published it."
},
"operation": {
"enum": [
"buy",
"rent"
],
"type": "string",
"description": "buy = for sale, rent = to let. Defaults to buy; a listing is one or the other, so call twice to cover both."
},
"energyClass": {
"enum": [
"A++",
"A+",
"A",
"B",
"B-",
"C",
"D",
"E",
"F",
"G",
"H"
],
"type": "string",
"description": "Energy certificate class. Selects the whole band the class belongs to: A+/A, B/B-, C, or D-and-below. Only matches listings that carry a certificate."
},
"minBathrooms": {
"type": "number",
"description": "Minimum number of bathrooms. Only matches listings whose source published a bathroom count."
},
"propertyType": {
"type": [
"string",
"array"
],
"items": {
"enum": [
"apartment",
"house",
"land",
"shop",
"office",
"warehouse",
"garage",
"farm",
"building"
],
"type": "string"
},
"description": "Property type, or an array of types. Omit to search all types. `farm` covers rural estates (quintas); `building` is a whole apartment block."
}
}
}