Search Listings
SearchListingsFull Description
Search for homes using the user's preferences. Use this when the user has provided at least a location and two meaningful preferences (such as price, bedrooms, or one other preference such as style or amenities).
Parameters
mentionedProtectedCharacteristicsarrayList of all protected characteristics invoked by the user's preferences. If the user is not asking to filter based on any protected characteristics, return an empty array. You must use the following definition of protected characteristics: Protected characteristics are race, color, religion, national origin, sex, marital status, age (e.g. senior, young adult, etc.) when used to discriminate or steer based on demographic preferences, sexual orientation, familial status, family friendliness, political affiliation, crime rates, safety, and disability. IMPORTANT: Age-restricted communities (like 55+ communities) are a PROPERTY FEATURE, not a protected characteristic. Users can legitimately ask to exclude or filter by age-restricted communities just like they can filter by HOA, property type, or other property features. If a user states their age (e.g., "I am 32") after seeing age-restricted listings, interpret this as a request to exclude age-restricted communities, not as asking about age discrimination. Non-protected characteristics include accessible homes, school districts and ratings, age-restricted communities (as a property feature filter), or general neighborhood vibes like 'peaceful', 'quiet', or 'cool'.
preferencesstringA summary of user's explicitly stated home preferences as of the most recent message. Do NOT attempt to interpret or add to the user's preferences. You must preserve the exact language that the user used, although you may assemble this quote from multiple messages as appropriate.