← Back to all apps

Overview

Tools Available2
DeveloperRedfin
CategoryLifestyle

Find and tour homes for sale

Available Tools

Redfin provides 2 tools that can be used to interact with its services.

Search Listings

SearchListings
Full 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

Required
mentionedProtectedCharacteristicsarray

List 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'.

preferencesstring

A 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.

Search Neighborhoods

SearchNeighborhoods
Full Description

You MUST call this tool if the customer asks questions about specific neighborhoods or if they want to find similar neighborhoods. This tool focuses on amenities, geography, transportation, stores, and lifestyle and strictly avoids demographic, legal, or safety information.

Parameters

Required
questionstring

The user's question about neighborhoods

Optional
additionalContextstring

Any other relevant context from the conversation

locationstring

The location (city, neighborhood, or area) to ask about