Voxhouses (Portugal)

Search current residential, rural and commercial real-estate listings for sale or rent in Portugal. Use this whenever the user wants to find, compare or explore properties — by location, budget, typology, property type, condition or energy rating. Returns price, price per m², typology, areas, neighbourhood, source and a citable listing URL, plus `total`: the exact number of listings matching the filters, which makes this tool usable to answer 'how many' questions. Listings are aggregated from portals and agency sites and refreshed continuously; each result carries the date it was last checked at the source. Sources publish uneven detail: filtering on an attribute silently excludes listings that omit it, so prefer the broadest filters that answer the question and report `total` as a floor, not a census.

{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "buy",
        "rent"
      ],
      "description": "buy = for sale, rent = to let. Defaults to buy; a listing is one or the other, so call twice to cover both."
    },
    "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."
    },
    "priceMin": {
      "type": "number",
      "description": "Minimum price, in the market currency."
    },
    "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."
    },
    "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."
    },
    "propertyType": {
      "type": [
        "string",
        "array"
      ],
      "items": {
        "type": "string",
        "enum": [
          "apartment",
          "house",
          "land",
          "shop",
          "office",
          "warehouse",
          "garage",
          "farm",
          "building"
        ]
      },
      "description": "Property type, or an array of types. Omit to search all types. `farm` covers rural estates (quintas); `building` is a whole apartment block."
    },
    "minBathrooms": {
      "type": "number",
      "description": "Minimum number of bathrooms. Only matches listings whose source published a bathroom count."
    },
    "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."
    },
    "condition": {
      "type": [
        "string",
        "array"
      ],
      "items": {
        "type": "string",
        "enum": [
          "new",
          "used",
          "to_renovate",
          "under_construction"
        ]
      },
      "description": "State of repair, or an array of states. Only matches listings whose source published it."
    },
    "energyClass": {
      "type": "string",
      "enum": [
        "A+",
        "A",
        "B",
        "B-",
        "C",
        "D",
        "E",
        "F"
      ],
      "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."
    },
    "sort": {
      "type": "string",
      "enum": [
        "recent",
        "price_asc",
        "price_desc"
      ],
      "description": "Result order. Default `recent` (most recently published first)."
    },
    "limit": {
      "type": "number",
      "description": "Results per page (default 10, max 20)."
    },
    "page": {
      "type": "number",
      "description": "1-based page number. Use it with `total` to walk through a large result set."
    }
  }
}

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "description": "ISO country code of this market."
    },
    "currency": {
      "type": "string"
    },
    "operation": {
      "type": "string",
      "enum": [
        "comprar",
        "arrendar"
      ],
      "description": "The operation actually searched (comprar = for sale, arrendar = to let)."
    },
    "total": {
      "type": "number",
      "description": "Exact number of listings in this market matching the filters, across all pages."
    },
    "page": {
      "type": "number"
    },
    "pageSize": {
      "type": "number"
    },
    "shown": {
      "type": "number",
      "description": "Listings returned on this page."
    },
    "hasMore": {
      "type": "boolean",
      "description": "true when further pages are available."
    },
    "properties": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "Stable identifier; use it in get_property_detail."
          },
          "url": {
            "type": "string",
            "description": "Canonical listing page on this market's domain."
          },
          "title": {
            "type": "string"
          },
          "operation": {
            "type": "string",
            "enum": [
              "comprar",
              "arrendar"
            ],
            "description": "comprar = for sale, arrendar = to let."
          },
          "propertyType": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "apartment",
              "house",
              "land",
              "shop",
              "office",
              "warehouse",
              "garage",
              "farm",
              "building",
              null
            ],
            "description": "Property type; the same token accepted by the propertyType filter."
          },
          "typology": {
            "type": "string",
            "description": "T-notation typology (T0…T6+); empty when unknown."
          },
          "bedrooms": {
            "type": "number"
          },
          "bathrooms": {
            "type": "number"
          },
          "price": {
            "type": [
              "number",
              "null"
            ],
            "description": "null means the source does not publish a price (on request)."
          },
          "priceLabel": {
            "type": "string",
            "description": "Formatted price for display; empty when price is null."
          },
          "currency": {
            "type": "string",
            "description": "ISO 4217 code of this market."
          },
          "pricePerM2": {
            "type": [
              "number",
              "null"
            ]
          },
          "houseArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Gross floor area in m²."
          },
          "usefulArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Net/usable floor area in m²."
          },
          "landArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Plot area in m²; relevant for houses, land and farms."
          },
          "neighbourhood": {
            "type": [
              "string",
              "null"
            ],
            "description": "Neighbourhood, when the source located the listing precisely enough."
          },
          "municipality": {
            "type": [
              "string",
              "null"
            ],
            "description": "Municipality (LAU) name."
          },
          "district": {
            "type": "string",
            "description": "District or region."
          },
          "energyClass": {
            "type": [
              "string",
              "null"
            ]
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Amenities as published by the source (Portuguese labels)."
          },
          "verified": {
            "type": "boolean",
            "description": "Advertiser identity verified by us."
          },
          "source": {
            "type": [
              "string",
              "null"
            ],
            "description": "Portal or agency site the listing came from; null when published directly with us."
          },
          "sourceUrl": {
            "type": [
              "string",
              "null"
            ],
            "description": "Original listing URL at the source. Cite this alongside url."
          },
          "firstSeen": {
            "type": "string",
            "description": "ISO 8601 date the listing was first published."
          },
          "lastSeen": {
            "type": "string",
            "description": "ISO 8601 date we last confirmed the listing at the source."
          },
          "updatedAt": {
            "type": "string",
            "description": "ISO 8601 date the record last changed on our side."
          }
        },
        "required": [
          "slug",
          "url",
          "title",
          "operation",
          "sourceUrl",
          "firstSeen",
          "lastSeen"
        ]
      }
    }
  },
  "required": [
    "market",
    "total",
    "page",
    "hasMore",
    "properties"
  ]
}

Search Portugal listings by describing the property in plain language, matched against listing text by meaning rather than keywords. Use this for wants that are not filter fields — 'a renovated loft with exposed brick', 'quiet, lots of natural light, close to a school', 'a ruin to restore with a sea view'. Prefer search_properties when the request is entirely structural (typology, budget, location), and this tool when it is descriptive; combine both by passing structural filters here too, which are applied as hard constraints while the description only ranks. Results are ordered by relevance, so `total` is the number matching the structural filters, not the number that fit the description.

{
  "type": "object",
  "properties": {
    "description": {
      "type": "string",
      "description": "What the user is looking for, in their own words. Full phrases work better than keywords. Pass the qualities here and the hard limits in the other arguments."
    },
    "operation": {
      "type": "string",
      "enum": [
        "buy",
        "rent"
      ],
      "description": "buy = for sale, rent = to let. Defaults to buy; a listing is one or the other, so call twice to cover both."
    },
    "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."
    },
    "priceMin": {
      "type": "number",
      "description": "Minimum price, in the market currency."
    },
    "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."
    },
    "propertyType": {
      "type": "string",
      "enum": [
        "apartment",
        "house",
        "land",
        "shop",
        "office",
        "warehouse",
        "garage",
        "farm",
        "building"
      ],
      "description": "A single property type. Unlike search_properties, this tool takes one, not a list."
    },
    "typology": {
      "type": "string",
      "description": "A single exact typology code (T0, T1, T2…), where the number is the count of bedrooms. Buckets are not accepted here."
    },
    "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."
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of results (default 10, max 20)."
    }
  },
  "required": [
    "description"
  ]
}

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "total": {
      "type": "number",
      "description": "Listings matching the structural filters. The description narrows the ranking, not this count."
    },
    "shown": {
      "type": "number"
    },
    "properties": {
      "type": "array",
      "description": "Ordered by relevance to the description, most relevant first.",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "Stable identifier; use it in get_property_detail."
          },
          "url": {
            "type": "string",
            "description": "Canonical listing page on this market's domain."
          },
          "title": {
            "type": "string"
          },
          "operation": {
            "type": "string",
            "enum": [
              "comprar",
              "arrendar"
            ],
            "description": "comprar = for sale, arrendar = to let."
          },
          "propertyType": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "apartment",
              "house",
              "land",
              "shop",
              "office",
              "warehouse",
              "garage",
              "farm",
              "building",
              null
            ],
            "description": "Property type; the same token accepted by the propertyType filter."
          },
          "typology": {
            "type": "string",
            "description": "T-notation typology (T0…T6+); empty when unknown."
          },
          "bedrooms": {
            "type": "number"
          },
          "bathrooms": {
            "type": "number"
          },
          "price": {
            "type": [
              "number",
              "null"
            ],
            "description": "null means the source does not publish a price (on request)."
          },
          "priceLabel": {
            "type": "string",
            "description": "Formatted price for display; empty when price is null."
          },
          "currency": {
            "type": "string",
            "description": "ISO 4217 code of this market."
          },
          "pricePerM2": {
            "type": [
              "number",
              "null"
            ]
          },
          "houseArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Gross floor area in m²."
          },
          "usefulArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Net/usable floor area in m²."
          },
          "landArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Plot area in m²; relevant for houses, land and farms."
          },
          "neighbourhood": {
            "type": [
              "string",
              "null"
            ],
            "description": "Neighbourhood, when the source located the listing precisely enough."
          },
          "municipality": {
            "type": [
              "string",
              "null"
            ],
            "description": "Municipality (LAU) name."
          },
          "district": {
            "type": "string",
            "description": "District or region."
          },
          "energyClass": {
            "type": [
              "string",
              "null"
            ]
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Amenities as published by the source (Portuguese labels)."
          },
          "verified": {
            "type": "boolean",
            "description": "Advertiser identity verified by us."
          },
          "source": {
            "type": [
              "string",
              "null"
            ],
            "description": "Portal or agency site the listing came from; null when published directly with us."
          },
          "sourceUrl": {
            "type": [
              "string",
              "null"
            ],
            "description": "Original listing URL at the source. Cite this alongside url."
          },
          "firstSeen": {
            "type": "string",
            "description": "ISO 8601 date the listing was first published."
          },
          "lastSeen": {
            "type": "string",
            "description": "ISO 8601 date we last confirmed the listing at the source."
          },
          "updatedAt": {
            "type": "string",
            "description": "ISO 8601 date the record last changed on our side."
          }
        },
        "required": [
          "slug",
          "url",
          "title",
          "operation",
          "sourceUrl",
          "firstSeen",
          "lastSeen"
        ]
      }
    }
  },
  "required": [
    "market",
    "total",
    "shown",
    "properties"
  ]
}

Get price statistics for a slice of the Portugal property market: how many listings match, the median price, the p25–p75 range, the median price per m² and a breakdown by typology. Use this when the user asks what something costs, whether an asking price is fair, or how two areas compare — instead of listing individual properties. Takes the same filters as search_properties and describes exactly the set that tool would return, so the two never disagree. Reports medians and quartiles rather than averages, because property prices have a long right tail and a single luxury listing moves an average. Call once per area to compare areas.

{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "buy",
        "rent"
      ],
      "description": "buy = for sale, rent = to let. Defaults to buy; a listing is one or the other, so call twice to cover both."
    },
    "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."
    },
    "priceMin": {
      "type": "number",
      "description": "Minimum price, in the market currency."
    },
    "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."
    },
    "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."
    },
    "propertyType": {
      "type": [
        "string",
        "array"
      ],
      "items": {
        "type": "string",
        "enum": [
          "apartment",
          "house",
          "land",
          "shop",
          "office",
          "warehouse",
          "garage",
          "farm",
          "building"
        ]
      },
      "description": "Property type, or an array of types. Omit to search all types. `farm` covers rural estates (quintas); `building` is a whole apartment block."
    },
    "minBathrooms": {
      "type": "number",
      "description": "Minimum number of bathrooms. Only matches listings whose source published a bathroom count."
    },
    "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."
    },
    "condition": {
      "type": [
        "string",
        "array"
      ],
      "items": {
        "type": "string",
        "enum": [
          "new",
          "used",
          "to_renovate",
          "under_construction"
        ]
      },
      "description": "State of repair, or an array of states. Only matches listings whose source published it."
    },
    "energyClass": {
      "type": "string",
      "enum": [
        "A+",
        "A",
        "B",
        "B-",
        "C",
        "D",
        "E",
        "F"
      ],
      "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."
    }
  }
}

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "operation": {
      "type": "string",
      "enum": [
        "comprar",
        "arrendar"
      ]
    },
    "count": {
      "type": "number",
      "description": "Listings matching the filters, with or without a published price."
    },
    "priced": {
      "type": "number",
      "description": "Subset with a published price — the base of every figure below. A large gap to `count` means many listings in this slice are 'price on request'."
    },
    "price": {
      "type": [
        "object",
        "null"
      ],
      "description": "Price distribution, in percentiles. null when no matching listing publishes a price. There is deliberately no min or max: listings come from third-party sources and the extremes are set by data errors, not by the market.",
      "properties": {
        "p10": {
          "type": "number",
          "description": "The bottom of the market: 10% of listings are cheaper."
        },
        "p25": {
          "type": "number",
          "description": "A quarter of listings are priced below this."
        },
        "median": {
          "type": "number",
          "description": "The typical price — use this one to answer 'how much'."
        },
        "p75": {
          "type": "number",
          "description": "A quarter of listings are priced above this."
        },
        "p90": {
          "type": "number",
          "description": "The top of the market: 10% of listings are dearer."
        }
      }
    },
    "pricePerM2Median": {
      "type": [
        "number",
        "null"
      ],
      "description": "Median price per m² among listings that published both a price and an area. Best figure for comparing areas."
    },
    "byTypology": {
      "type": "array",
      "description": "Up to 6 most represented typologies, each with its own median.",
      "items": {
        "type": "object",
        "properties": {
          "typology": {
            "type": "string"
          },
          "count": {
            "type": "number"
          },
          "medianPrice": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "typology",
          "count"
        ]
      }
    }
  },
  "required": [
    "market",
    "currency",
    "operation",
    "count",
    "priced",
    "byTypology"
  ]
}

Given one listing, find comparable ones: same operation and area, similar typology, floor area and price. Use this when the user likes a property but wants alternatives — 'find me something similar', 'the same but cheaper', 'what else is there in this area'. Pass `maxPrice` for the cheaper case; without it, comparables are drawn from a band around the reference price. Comparability is by location, typology, area and price, not by text similarity: it answers 'is this well priced for what it is', which a keyword search cannot.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Slug of the reference listing, as returned by search_properties or get_property_detail."
    },
    "maxPrice": {
      "type": "number",
      "description": "Optional budget ceiling, in the market currency. Use it for 'similar but cheaper'; it overrides the default band around the reference price."
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of comparables (default 6, max 20)."
    }
  },
  "required": [
    "slug"
  ]
}

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "reference": {
      "type": "object",
      "description": "The listing the comparables are measured against, echoed back for the comparison.",
      "properties": {
        "slug": {
          "type": "string",
          "description": "Stable identifier; use it in get_property_detail."
        },
        "url": {
          "type": "string",
          "description": "Canonical listing page on this market's domain."
        },
        "title": {
          "type": "string"
        },
        "operation": {
          "type": "string",
          "enum": [
            "comprar",
            "arrendar"
          ],
          "description": "comprar = for sale, arrendar = to let."
        },
        "propertyType": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "apartment",
            "house",
            "land",
            "shop",
            "office",
            "warehouse",
            "garage",
            "farm",
            "building",
            null
          ],
          "description": "Property type; the same token accepted by the propertyType filter."
        },
        "typology": {
          "type": "string",
          "description": "T-notation typology (T0…T6+); empty when unknown."
        },
        "bedrooms": {
          "type": "number"
        },
        "bathrooms": {
          "type": "number"
        },
        "price": {
          "type": [
            "number",
            "null"
          ],
          "description": "null means the source does not publish a price (on request)."
        },
        "priceLabel": {
          "type": "string",
          "description": "Formatted price for display; empty when price is null."
        },
        "currency": {
          "type": "string",
          "description": "ISO 4217 code of this market."
        },
        "pricePerM2": {
          "type": [
            "number",
            "null"
          ]
        },
        "houseArea": {
          "type": [
            "number",
            "null"
          ],
          "description": "Gross floor area in m²."
        },
        "usefulArea": {
          "type": [
            "number",
            "null"
          ],
          "description": "Net/usable floor area in m²."
        },
        "landArea": {
          "type": [
            "number",
            "null"
          ],
          "description": "Plot area in m²; relevant for houses, land and farms."
        },
        "neighbourhood": {
          "type": [
            "string",
            "null"
          ],
          "description": "Neighbourhood, when the source located the listing precisely enough."
        },
        "municipality": {
          "type": [
            "string",
            "null"
          ],
          "description": "Municipality (LAU) name."
        },
        "district": {
          "type": "string",
          "description": "District or region."
        },
        "energyClass": {
          "type": [
            "string",
            "null"
          ]
        },
        "features": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Amenities as published by the source (Portuguese labels)."
        },
        "verified": {
          "type": "boolean",
          "description": "Advertiser identity verified by us."
        },
        "source": {
          "type": [
            "string",
            "null"
          ],
          "description": "Portal or agency site the listing came from; null when published directly with us."
        },
        "sourceUrl": {
          "type": [
            "string",
            "null"
          ],
          "description": "Original listing URL at the source. Cite this alongside url."
        },
        "firstSeen": {
          "type": "string",
          "description": "ISO 8601 date the listing was first published."
        },
        "lastSeen": {
          "type": "string",
          "description": "ISO 8601 date we last confirmed the listing at the source."
        },
        "updatedAt": {
          "type": "string",
          "description": "ISO 8601 date the record last changed on our side."
        }
      }
    },
    "total": {
      "type": "number",
      "description": "Comparables returned."
    },
    "properties": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "Stable identifier; use it in get_property_detail."
          },
          "url": {
            "type": "string",
            "description": "Canonical listing page on this market's domain."
          },
          "title": {
            "type": "string"
          },
          "operation": {
            "type": "string",
            "enum": [
              "comprar",
              "arrendar"
            ],
            "description": "comprar = for sale, arrendar = to let."
          },
          "propertyType": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "apartment",
              "house",
              "land",
              "shop",
              "office",
              "warehouse",
              "garage",
              "farm",
              "building",
              null
            ],
            "description": "Property type; the same token accepted by the propertyType filter."
          },
          "typology": {
            "type": "string",
            "description": "T-notation typology (T0…T6+); empty when unknown."
          },
          "bedrooms": {
            "type": "number"
          },
          "bathrooms": {
            "type": "number"
          },
          "price": {
            "type": [
              "number",
              "null"
            ],
            "description": "null means the source does not publish a price (on request)."
          },
          "priceLabel": {
            "type": "string",
            "description": "Formatted price for display; empty when price is null."
          },
          "currency": {
            "type": "string",
            "description": "ISO 4217 code of this market."
          },
          "pricePerM2": {
            "type": [
              "number",
              "null"
            ]
          },
          "houseArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Gross floor area in m²."
          },
          "usefulArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Net/usable floor area in m²."
          },
          "landArea": {
            "type": [
              "number",
              "null"
            ],
            "description": "Plot area in m²; relevant for houses, land and farms."
          },
          "neighbourhood": {
            "type": [
              "string",
              "null"
            ],
            "description": "Neighbourhood, when the source located the listing precisely enough."
          },
          "municipality": {
            "type": [
              "string",
              "null"
            ],
            "description": "Municipality (LAU) name."
          },
          "district": {
            "type": "string",
            "description": "District or region."
          },
          "energyClass": {
            "type": [
              "string",
              "null"
            ]
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Amenities as published by the source (Portuguese labels)."
          },
          "verified": {
            "type": "boolean",
            "description": "Advertiser identity verified by us."
          },
          "source": {
            "type": [
              "string",
              "null"
            ],
            "description": "Portal or agency site the listing came from; null when published directly with us."
          },
          "sourceUrl": {
            "type": [
              "string",
              "null"
            ],
            "description": "Original listing URL at the source. Cite this alongside url."
          },
          "firstSeen": {
            "type": "string",
            "description": "ISO 8601 date the listing was first published."
          },
          "lastSeen": {
            "type": "string",
            "description": "ISO 8601 date we last confirmed the listing at the source."
          },
          "updatedAt": {
            "type": "string",
            "description": "ISO 8601 date the record last changed on our side."
          }
        },
        "required": [
          "slug",
          "url",
          "title",
          "operation",
          "sourceUrl",
          "firstSeen",
          "lastSeen"
        ]
      }
    }
  },
  "required": [
    "market",
    "reference",
    "total",
    "properties"
  ]
}

Get the complete record of one listing in Portugal by its slug. Use this after search_properties when the user asks about a specific property: full description, features, photos, energy rating, condition, floor, year built, seller and the original source URL to cite.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Unique listing slug, as returned by search_properties."
    }
  },
  "required": [
    "slug"
  ]
}

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Stable identifier; use it in get_property_detail."
    },
    "url": {
      "type": "string",
      "description": "Canonical listing page on this market's domain."
    },
    "title": {
      "type": "string"
    },
    "operation": {
      "type": "string",
      "enum": [
        "comprar",
        "arrendar"
      ],
      "description": "comprar = for sale, arrendar = to let."
    },
    "propertyType": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "apartment",
        "house",
        "land",
        "shop",
        "office",
        "warehouse",
        "garage",
        "farm",
        "building",
        null
      ],
      "description": "Property type; the same token accepted by the propertyType filter."
    },
    "typology": {
      "type": "string",
      "description": "T-notation typology (T0…T6+); empty when unknown."
    },
    "bedrooms": {
      "type": "number"
    },
    "bathrooms": {
      "type": "number"
    },
    "price": {
      "type": [
        "number",
        "null"
      ],
      "description": "null means the source does not publish a price (on request)."
    },
    "priceLabel": {
      "type": "string",
      "description": "Formatted price for display; empty when price is null."
    },
    "currency": {
      "type": "string",
      "description": "ISO 4217 code of this market."
    },
    "pricePerM2": {
      "type": [
        "number",
        "null"
      ]
    },
    "houseArea": {
      "type": [
        "number",
        "null"
      ],
      "description": "Gross floor area in m²."
    },
    "usefulArea": {
      "type": [
        "number",
        "null"
      ],
      "description": "Net/usable floor area in m²."
    },
    "landArea": {
      "type": [
        "number",
        "null"
      ],
      "description": "Plot area in m²; relevant for houses, land and farms."
    },
    "neighbourhood": {
      "type": [
        "string",
        "null"
      ],
      "description": "Neighbourhood, when the source located the listing precisely enough."
    },
    "municipality": {
      "type": [
        "string",
        "null"
      ],
      "description": "Municipality (LAU) name."
    },
    "district": {
      "type": "string",
      "description": "District or region."
    },
    "energyClass": {
      "type": [
        "string",
        "null"
      ]
    },
    "features": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Amenities as published by the source (Portuguese labels)."
    },
    "verified": {
      "type": "boolean",
      "description": "Advertiser identity verified by us."
    },
    "source": {
      "type": [
        "string",
        "null"
      ],
      "description": "Portal or agency site the listing came from; null when published directly with us."
    },
    "sourceUrl": {
      "type": [
        "string",
        "null"
      ],
      "description": "Original listing URL at the source. Cite this alongside url."
    },
    "firstSeen": {
      "type": "string",
      "description": "ISO 8601 date the listing was first published."
    },
    "lastSeen": {
      "type": "string",
      "description": "ISO 8601 date we last confirmed the listing at the source."
    },
    "updatedAt": {
      "type": "string",
      "description": "ISO 8601 date the record last changed on our side."
    },
    "description": {
      "type": "string"
    },
    "photos": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Up to 5 image URLs."
    },
    "yearBuilt": {
      "type": [
        "string",
        "null"
      ]
    },
    "floor": {
      "type": [
        "string",
        "null"
      ]
    },
    "elevator": {
      "type": [
        "string",
        "null"
      ]
    },
    "orientation": {
      "type": [
        "string",
        "null"
      ]
    },
    "condition": {
      "type": [
        "string",
        "null"
      ]
    },
    "sellerName": {
      "type": [
        "string",
        "null"
      ]
    },
    "phone": {
      "type": [
        "string",
        "null"
      ],
      "description": "Advertiser phone when published at the source."
    }
  },
  "required": [
    "slug",
    "url",
    "title",
    "operation",
    "sourceUrl",
    "firstSeen",
    "lastSeen"
  ]
}

Search neighbourhood and municipality guides for Portugal, with median price per m² for buying and renting, price trend and an editorial summary. Use this when the user asks where to live or where to buy, or wants to compare areas, instead of asking for individual listings.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Neighbourhood, municipality or district (e.g. Cascais, Príncipe Real). Omit to list all."
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of results (default 8, max 20)."
    }
  }
}

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "total": {
      "type": "number"
    },
    "neighbourhoods": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "concelho": {
            "type": "string",
            "description": "Municipality."
          },
          "distrito": {
            "type": "string",
            "description": "District or region."
          },
          "pricePerM2Buy": {
            "type": [
              "number",
              "null"
            ]
          },
          "pricePerM2Rent": {
            "type": [
              "number",
              "null"
            ]
          },
          "trend": {
            "type": [
              "string",
              "null"
            ],
            "description": "Recent price direction."
          },
          "blurb": {
            "type": "string",
            "description": "Editorial summary of the area."
          }
        },
        "required": [
          "slug",
          "name",
          "url"
        ]
      }
    }
  },
  "required": [
    "market",
    "total",
    "neighbourhoods"
  ]
}

Search editorial articles about the property market in Portugal: buying and renting guides, market analysis and practical advice. Use this when the user asks how something works — mortgages, contracts, taxes, the buying process — rather than asking for listings.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Maximum number of results (default 5, max 10)."
    }
  }
}

{
  "type": "object",
  "properties": {
    "articles": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "excerpt": {
            "type": "string"
          },
          "category": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "title",
          "url"
        ]
      }
    }
  },
  "required": [
    "articles"
  ]
}