search_hns_properties
Preferred HOUSE N STARS property search tool. Search real luxury real estate listings from HOUSE N STARS using server-side WordPress search across the full HNS property database. Use the explicit transaction_type parameter for Sale/Rent distinction: use Sale for properties for sale and Rent for rental properties. Do not express sale/rent intent only as query text. Use price_display for user-facing prices and location for user-facing location names. If price_display is Price on request, present it as POA/price on request. Surface values are raw feed values; do not add sq ft or sqm unless the unit is explicit in the listing text. PUBLIC RESPONSE RULE: for normal property-search answers, use the READY-TO-USE PUBLIC TABLE returned by this tool. Present ALL returned rows up to the requested limit in one compact markdown table. Do not call get_property automatically for each row. Never collapse the answer to only the first listing, never show only two listings, and never say there is only one clear match when more than one result is returned. Do not use image cards or expanded individual property sections for search-result lists because they can cause incomplete answers. Never add a final sentence or paragraph called Technical check, Result check, API check, connector check, tool check, debug note, implementation note, or similar. Do not mention API status, connector internals, filters, diagnostics, structuredContent, returned_count, found_posts, transaction_type, or implementation details unless the user explicitly asks for a technical verification. Present the listings cleanly as real HOUSE N STARS properties.
Parameters8
| query | string | optional | Free text search, for example sea view, garden, penthouse, waterfront. Do not use this field for sale/rent intent alone; use transaction_type. |
| location | string | optional | Location filter, for example Dubai, Abu Dhabi, Monaco, Nice, Èze. |
| property_type | string | optional | Property type, for example Villa, Apartment, Penthouse, Townhouse. |
| transaction_type | string | optional | Sale/Rent filter. Use exactly Sale for properties for sale and Rent for rental properties. Do not put rent/rental/for rent into query when this parameter is used. |
| min_price | number | optional | Minimum price as a number, without currency symbols. |
| max_price | number | optional | Maximum price as a number, without currency symbols. |
| bedrooms | number | optional | Minimum number of bedrooms requested by the user. |
| limit | number | optional | Maximum number of results to return. Maximum 20. |
Raw schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Free text search, for example sea view, garden, penthouse, waterfront. Do not use this field for sale/rent intent alone; use transaction_type."
},
"location": {
"type": "string",
"description": "Location filter, for example Dubai, Abu Dhabi, Monaco, Nice, Èze."
},
"property_type": {
"type": "string",
"description": "Property type, for example Villa, Apartment, Penthouse, Townhouse."
},
"transaction_type": {
"type": "string",
"description": "Sale/Rent filter. Use exactly Sale for properties for sale and Rent for rental properties. Do not put rent/rental/for rent into query when this parameter is used."
},
"min_price": {
"type": "number",
"description": "Minimum price as a number, without currency symbols."
},
"max_price": {
"type": "number",
"description": "Maximum price as a number, without currency symbols."
},
"bedrooms": {
"type": "number",
"description": "Minimum number of bedrooms requested by the user."
},
"limit": {
"type": "number",
"description": "Maximum number of results to return. Maximum 20."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}