hemmabo_search_similar
Find similar vacation rentals to a chosen property, matching region, type, and capacity, with live pricing for specific dates.
Instructions
Find vacation rental properties similar to a given property on specific dates. Use this tool after the user has selected a property (via hemmabo_search_properties) and wants to see alternatives — same region, same property type, same or larger capacity. Do NOT use for the initial search; use hemmabo_search_properties instead. Returns a list of similar available properties with live pricing, excluding the source property. Matches are anchored to the source propertyId over the given checkIn/checkOut range; omit guests to inherit the source property's capacity, and raise limit to widen the alternative set (default 5).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of similar properties to return (integer 1–20). Omit to use server default 5. Increase when the guest wants more alternatives. | |
| guests | No | Optional guest count (e.g. 4). Omit to use the source property's maxGuests for matching and pricing. When provided, filters alternatives that cannot accommodate this count. | |
| checkIn | Yes | Arrival date in ISO 8601 calendar format YYYY-MM-DD (e.g. '2026-07-15'). Must be today or later in the property's timezone. Must be strictly before checkOut; together they define the stay length used for pricing and availability. | |
| checkOut | Yes | Departure date in ISO 8601 calendar format YYYY-MM-DD (e.g. '2026-07-22'). Must be strictly after checkIn on the same calendar. The guest does not stay the departure night. | |
| propertyId | Yes | Stable property UUID from hemmabo_search_properties (e.g. '550e8400-e29b-41d4-a716-446655440000'). Pass the exact UUID string — never a property name, host domain, or booking URL. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of similar properties returned. | |
| error | No | Present only when isError=true. | |
| guests | No | Effective guest count used for matching and pricing. | |
| checkIn | No | ||
| checkOut | No | ||
| sourcePropertyId | No | The property similar listings were found for. | |
| similarProperties | No | Similar available properties (same region, same type, same/larger capacity), sorted by direct host-source total. |