Search vacation rentals
search_propertiesFind vacation rentals in a municipality or region (Italy, Germany, Spain, France, Portugal) for a number of guests. Where: municipality, province, (Italy) region, or a radius around an Italian municipality (near) or a point (latitude/longitude), each hit with its straight-line distance; the order stays tier, then name, sort by distance yourself. Criteria: capacity, bedrooms, bathrooms, amenities (a fixed table of names incl. pool facets such as private or heated, otherwise exact), what is rented, pets allowed, highest indicative price and, with from/to, dates not blocked in the operator's synced calendar. A stated fact that contradicts a criterion always leaves the property out. Each hit lists the criteria a stated fact meets in matched and says match (every criterion met) or possible, with the open points in unknown: by default only availability on request and a heated pool's heating on the requested dates; with include_possible also any fact the operator did not state (no current calendar is never read as free). Ask the operator about every point in unknown before relying on it. At most 20 results, ordered by the strongest free tier, then name (with include_possible matches first); the paid tier L5 does not change the order. No ranking by anything else, no fuzzy matching. Each result has priceFrom (indicative, negotiated directly, no booking) and the next window not blocked in the operator's calendar. Availability is a hint, never a booking commitment: a night not blocked in the operator's synced calendar may already be taken, since the calendar is a copy that can lag behind; only the operator confirms availability, and Ospitario holds or books nothing. Prices are indicative, stated by the host (on an unclaimed passport: taken from the official website), negotiated directly with the host; there is no booking through Ospitario. Every result is a property with a proven listing (L2/L2c), a verified operator (L3), a right to manage verified by document review (LA) or, marked L0 and unclaimed, facts from the operator's official website with nothing proven; the result names the tier and the date it was reached, and whether the registration number (Italy: CIN) was checked against the public register. Contact is direct with the operator and commission-free, so the traveler pays no platform fee. No result means nothing proven matches; nothing is inferred, estimated or filled in.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_properties"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Checkout date YYYY-MM-DD; requires from | |
| from | No | Check-in date YYYY-MM-DD; requires to | |
| lang | No | Language of labels in the result; defaults to en | |
| near | No | Italian municipality to search around, by name (e.g. Lecce); with radiusKm. A name several municipalities carry needs nearProvince | |
| pets | No | true: only properties whose operator states that pets are allowed | |
| guests | No | Number of guests; properties with a lower capacity are left out. Optional since 1.14.0: without it, capacity is not a criterion | |
| region | No | Italian region, by its Italian name or slug (Abruzzo, Basilicata, Calabria, Campania, Emilia-Romagna, Friuli-Venezia Giulia, Lazio, Liguria, Lombardia, Marche, Molise, Piemonte, Puglia, Sardegna, Sicilia, Toscana, Trentino-Alto Adige, Umbria, Valle d’Aosta, Veneto); the usual English, German, French, Spanish and Portuguese names are understood too (Apulia, Toskana). Italy only; matches the passport's province | |
| country | No | ISO 3166-1 alpha-2 country code: IT, DE, ES, FR or PT | |
| bedrooms | No | Minimum number of bedrooms | |
| children | No | true: only properties whose operator states that children are welcome | |
| latitude | No | Point to search around, WGS 84 degrees; with longitude and radiusKm, instead of near | |
| maxPrice | No | Highest indicative price per night in EUR: properties whose lowest current or future priceFrom is above it, or that gave no price, are left out | |
| province | No | Region code within the country, ISO 3166-2 without the prefix: IT/ES province (LE), FR département (75), DE Land (HH), PT distrito (11) | |
| radiusKm | No | Radius around near or latitude/longitude in km, straight line, default 20. A passport counts at its published exact location, else at its municipality's centre (computed from Istat's boundaries), so a home just inside a municipality can lie a few km off; every hit names its distance and basis. Municipality centres computed by Ospitario from Istat, Confini delle unità amministrative a fini statistici al 1° gennaio 2026 (CC BY 4.0) | |
| stepFree | No | true: only properties whose operator states step-free access | |
| amenities | No | Every listed amenity must be present. These names match the operator's wording in any of the six languages through a fixed table: pool, wifi, parking, airConditioning (ac), garden, seaView, terrace, kitchen, washingMachine (washerDryer), bbq (outdoorGrill), heating, fireplace, balcony, tv, hotTub, elevator, crib, microwave, workspace. A pool can be asked with its facets: "private pool", "shared pool", "heated pool", "indoor pool", "outdoor pool" (or the same words in Italian, German, Spanish, Portuguese, French); a facet the operator did not state is unknown, not a match. Any other word must match an amenity exactly (case-insensitive). | |
| bathrooms | No | Minimum number of bathrooms; a half bath counts 0.5 | |
| longitude | No | Point to search around, WGS 84 degrees; with latitude | |
| placeKind | No | entire, private_room or shared_room; properties that did not state it are left out | |
| municipality | No | Exact municipality name, e.g. Lecce | |
| nearProvince | No | Province code of near when the name is ambiguous (e.g. LE) | |
| propertyKind | No | Kind of building: apartment, house, villa, farmhouse, trullo, cottage, chalet, other; a property that did not state it is open (unknown: propertyKind), another kind leaves it out | |
| include_possible | No | true: also return possible matches, where a requested fact is not stated (capacity, bedrooms, an amenity or pool facet, pets, price, current calendar) and nothing stated contradicts the request; each hit names the open points in unknown. Default false: only hits that meet every criterion, plus availability on request. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| results | Yes |