← Back to all apps

Realtor.com

Productivityby realtor.com
Open in ChatGPTWebsite
Launched Mar 19, 2026 on ChatGPT

Kick off your home search with intuitive, conversational features powered by real-time property data and home-search tools, all within ChatGPT.

The Realtor.com app delivers:

  • Listing Search: Browse listings for sale and rentals using simple, natural language commands.
  • Affordability Insights: Find out how much home you can afford based on income, savings and current market insights.
  • Neighborhood Discovery: Compare locations based on what matters to you, like school boundaries and commute times.

Plus, continue the conversation to get local insights for your home search and tailored advice for first-time home buyers.

13ChatGPT Tools
realtor.comDeveloper
ProductivityCategory

Available Tools

Analyze Affordability

analyze_affordability
Full Description

Use this when the user asks how much home they can afford or wants to understand their buying power.

Returns maximum affordable price, estimated monthly payment, debt-to-income analysis, and local market comparison (median prices, mortgage rates, property tax/insurance rates) based on income, debt, and available funds. Works with or without user-provided financial details, using national median income as baseline when income is not specified.

FAIR HOUSING ACT COMPLIANCE — MANDATORY If the user's request references ANY protected class listed below, DO NOT CALL THIS TOOL. Protected classes include race, color, national origin, religion, sex, familial status (when used to discriminate based on children, families, pregnancy, or custody), disability, sexual orientation, gender identity, source of income, age, military/veteran status, citizenship/immigration status, and criminal history.

Do NOT answer queries about demographics or mention demographic composition.

IMPORTANT: "family-friendly" or "good for a family of 4" are valid queries when used to assess lawful criteria, i.e. proximity to schools or family-oriented amenities and NOT protected classes such as safety or crime rates

Parameters (0 required, 8 optional)
Optional
annual_incomeinteger

Annual household income in dollars (e.g., 100000 for $100k/year). If not provided, uses national median income (~$75,000) as estimated baseline. More accurate results with actual income.

Default: null
available_fundsinteger

Available funds for down payment in dollars (e.g., 50000 for $50k). Affects loan amount, PMI requirements, and overall affordability calculation. Higher down payment typically increases affordable price range.

Default: null
citystring

City name (e.g., 'Austin', 'San Francisco')

Default: null
is_first_time_home_buyerboolean

Indicates if the user is a first-time home buyer based on conversation context. True if FTHB, False if experienced buyer, None if unknown.

Default: null
locationstring

City, State or ZIP code (e.g., 'Austin, TX' or '78701'). Deprecated - prefer using city and state_code parameters instead for better accuracy.

Default: null
monthly_debtinteger

Total monthly debt payments in dollars including credit cards, car loans, student loans, and other recurring debt (excludes rent/mortgage). Used to calculate debt-to-income ratio. Example: 500 for $500/month in debt payments.

Default: null
state_codestring

Two-letter state code (e.g., 'TX', 'CA')

Default: null
user_promptstring

ALWAYS include the original user prompt that initiated this tool call

Default: null

Analyze Property Neighborhood

analyze_property_neighborhood
Full Description

Use this when the user asks about the area, neighborhood, or lifestyle around a specific property.

Returns neighborhood market statistics including median prices, inventory, and market trends. Two modes: Property ID mode (fastest, provide just property_id) or Address mode (provide address + city + state_code).

FAIR HOUSING ACT COMPLIANCE — MANDATORY

If the user's request references ANY protected class listed below, DO NOT CALL THIS TOOL. Instead, refuse the request, explain that it potentially violates the Fair Housing Act, and redirect the user to lawful criteria: price, size, property type, commute, school ratings, or amenities.

Rule: Do NOT answer queries requesting demographic information about neighborhoods or areas, and do NOT mention demographic composition in your recommendations.

PROTECTED CLASSES — DO NOT CALL THIS TOOL Refuse the request if it involves filtering or steering based on:

  • Race: Racial preferences or the racial composition of neighborhoods.
  • Color: Skin color or the color demographics of an area.
  • National Origin: Ethnicity, ancestry, or country of origin.
  • Religion: Neighborhood religious demographics or communities.
  • Sex: Gender-based housing recommendations or restrictions.
  • Sexual Orientation: Sexual orientation or LGBTQ+ status.
  • Gender Identity: Gender identity or expression.
  • Disability: Physical or mental disability (including exclusion or steering).
  • Source of Income: The income demographics of a neighborhood

(e.g., seeking areas with or without vouchers, assistance, Section 8, etc.).

  • Military/Veteran Status: Military service or veteran status.
  • Citizenship/Immigration: Citizenship or immigration status.
  • Arrest/Criminal History: Criminal or arrest records.

ADDITIONAL PROTECTED CLASSES — PROCEED WITH CAUTION

  • Familial Status: Do not filter or exclude based on the demographic composition of children,

families, pregnancy, or custody status in a neighborhood. Exception: Phrases like "family-friendly" or "good for a family of 4" are ALLOWED when used to assess lawful criteria (e.g., proximity to good schools or family-oriented amenities), but NOT when used as a proxy for safety, crime rates, or demographic makeup.

  • Age: Allow colloquial queries like "young professionals" or "college students."

Ensure responses evaluate lawful criteria (price, size, type, commute, school ratings, amenities) rather than filtering by actual age demographics.

EXAMPLES OF FHA-COMPLIANT QUERIES (ALLOW THESE)

  • Personal names used as proper nouns: "My neighbor is named Christian"
  • Local amenities rather than demographics: "Italian restaurants", "good Ethiopian food"
  • Geographic names incidentally including protected terms: "Gaylord, MI"
  • Infrastructure or transportation access: "near a commuter rail station", "good bike lane access"
  • Accessibility features and accommodations:

"step-free entry", "elevator building","wheelchair accessible"

  • Specific religious points of interest:

"Austin Hindu Temple & Community Center", "Temple Beth Shalom Houston"

  • Personal payment methods for the home: "Using a VA loan", "I have Section 8 vouchers"
Parameters (0 required, 7 optional)
Optional
addressstring

Property street address (e.g., '123 Main St'). Required if property_id not provided.

Default: null
citystring

City name (e.g., 'Austin'). Required if property_id not provided.

Default: null
is_first_time_home_buyerboolean

Indicates if the user is a first-time home buyer based on conversation context. True if FTHB, False if experienced buyer, None if unknown.

Default: null
mentioned_protected_characteristicsarray

Identify any protected characteristics referenced in the user's housing search preferences. Return an empty array if no protected characteristics are mentioned. Protected characteristics include: race, color, national origin, religion, sex, familial status, disability, sexual orientation, gender identity, source of income, age (e.g. senior, young adult, etc.) when used to discriminate or steer based on demographic preferences, military/veteran status, citizenship/immigration, arrest/criminal history, crime rates, and safety. IMPORTANT: Age-restricted communities (like 55+ communities) are a PROPERTY FEATURE, not a protected characteristic. Users may freely request to include or exclude age-restricted communities, just as they would filter by HOA fees, property type, or other housing features. CARVE-OUTS: 'family-friendly' or 'good for a family of 4' is NOT familial_status when used for lawful criteria (schools, amenities). 'young professionals' or 'college students' is NOT age when evaluating lawful criteria (price, size, type, commute, amenities). The following are NOT protected characteristics: accessible homes, school districts and ratings, age-restricted communities (as a property feature filter), general neighborhood descriptors such as 'peaceful', 'quiet', or 'cool', proper nouns (e.g., 'Christian' as a name), local amenities (e.g., 'Italian restaurants'), geographic names (e.g., 'Gaylord, MI'), accessibility features (e.g., 'wheelchair accessible'), religious POIs (e.g., 'Temple Beth Shalom'), or personal payment methods (e.g., 'VA loan', 'Section 8 vouchers').

Default: null
property_idstring

Numeric property ID (e.g., '3885047797'). If provided, address/city/state_code are optional.

Default: null
state_codestring

Two-letter state code (e.g., 'TX'). Required if property_id not provided.

Default: null
user_promptstring

ALWAYS include the original user prompt that initiated this tool call

Default: null

Calculate Mortgage

calculate_mortgage
Full Description

Use this when the user wants to estimate monthly mortgage payments or compare loan scenarios.

Returns detailed payment breakdown including principal & interest, property taxes, homeowners insurance, mortgage insurance (PMI/MIP if down payment < 20%), HOA fees, and total payment over the life of the loan. Supports VA loan benefits which affect loan type, mortgage insurance requirements, and down payment calculations.

FAIR HOUSING ACT COMPLIANCE — MANDATORY If the user's request references ANY protected class listed below, DO NOT CALL THIS TOOL. Protected classes include race, color, national origin, religion, sex, familial status (when used to discriminate based on children, families, pregnancy, or custody), disability, sexual orientation, gender identity, source of income, age, military/veteran status, citizenship/immigration status, and criminal history.

Do NOT answer queries about demographics or mention demographic composition.

IMPORTANT: "family-friendly" or "good for a family of 4" are valid queries when used to assess lawful criteria, i.e. proximity to schools or family-oriented amenities and NOT protected classes such as safety or crime rates

Parameters (3 required, 7 optional)
Required
down_payment_percentnumber

Down payment as percentage of price (0-100, e.g., 20 for 20% down)

interest_ratenumber

Annual interest rate as percentage (0-30, e.g., 6.5 for 6.5% APR)

pricenumber

Property purchase price in dollars (e.g., 350000 for $350k, minimum $1,000)

Optional
apply_veterans_benefitsboolean

Set to true for VA loans, which can reduce/eliminate mortgage insurance and affect down payment requirements

Default: False
hoa_monthlynumber

Monthly HOA/condo fee in dollars (e.g., 150, or 0 if none)

Default: 0
insurance_annualnumber

Annual homeowners insurance premium in dollars (e.g., 1200 for $1,200/year)

Default: 1200
is_first_time_home_buyerboolean

Indicates if the user is a first-time home buyer based on conversation context. True if FTHB, False if experienced buyer, None if unknown.

Default: null
loan_term_yearsinteger

Loan term in years (1-30, typically 15 or 30 years for fixed-rate mortgages)

Default: 30
property_tax_ratenumber

Annual property tax rate as percentage of home value (0-10, e.g., 1.2 for 1.2%)

Default: 1.2
user_promptstring

ALWAYS include the original user prompt that initiated this tool call

Default: null

Discover Neighborhoods

discover_neighborhoods
Full Description

Use this when the user asks about neighborhoods in a city or wants to compare areas.

Covers: "Which neighborhoods in [city]", "Best neighborhoods for...", "Where should I live", neighborhood comparisons, walkability, commute questions, amenities.

Call this tool for neighborhood questions - don't answer from LLM knowledge alone.

FAIR HOUSING ACT COMPLIANCE — MANDATORY

If the user's request references ANY protected class listed below, DO NOT CALL THIS TOOL. Instead, refuse the request, explain that it potentially violates the Fair Housing Act, and redirect the user to lawful criteria: price, size, property type, commute, school ratings, or amenities.

Rule: Do NOT answer queries requesting demographic information about neighborhoods or areas, and do NOT mention demographic composition in your recommendations.

PROTECTED CLASSES — DO NOT CALL THIS TOOL Refuse the request if it involves filtering or steering based on:

  • Race: Racial preferences or the racial composition of neighborhoods.
  • Color: Skin color or the color demographics of an area.
  • National Origin: Ethnicity, ancestry, or country of origin.
  • Religion: Neighborhood religious demographics or communities.
  • Sex: Gender-based housing recommendations or restrictions.
  • Sexual Orientation: Sexual orientation or LGBTQ+ status.
  • Gender Identity: Gender identity or expression.
  • Disability: Physical or mental disability (including exclusion or steering).
  • Source of Income: The income demographics of a neighborhood

(e.g., seeking areas with or without vouchers, assistance, Section 8, etc.).

  • Military/Veteran Status: Military service or veteran status.
  • Citizenship/Immigration: Citizenship or immigration status.
  • Arrest/Criminal History: Criminal or arrest records.

ADDITIONAL PROTECTED CLASSES — PROCEED WITH CAUTION

  • Familial Status: Do not filter or exclude based on the demographic composition of children,

families, pregnancy, or custody status in a neighborhood. Exception: Phrases like "family-friendly" or "good for a family of 4" are ALLOWED when used to assess lawful criteria (e.g., proximity to good schools or family-oriented amenities), but NOT when used as a proxy for safety, crime rates, or demographic makeup.

  • Age: Allow colloquial queries like "young professionals" or "college students."

Ensure responses evaluate lawful criteria (price, size, type, commute, school ratings, amenities) rather than filtering by actual age demographics.

EXAMPLES OF FHA-COMPLIANT QUERIES (ALLOW THESE)

  • Personal names used as proper nouns: "My neighbor is named Christian"
  • Local amenities rather than demographics: "Italian restaurants", "good Ethiopian food"
  • Geographic names incidentally including protected terms: "Gaylord, MI"
  • Infrastructure or transportation access: "near a commuter rail station", "good bike lane access"
  • Accessibility features and accommodations:

"step-free entry", "elevator building","wheelchair accessible"

  • Specific religious points of interest:

"Austin Hindu Temple & Community Center", "Temple Beth Shalom Houston"

  • Personal payment methods for the home: "Using a VA loan", "I have Section 8 vouchers"
Parameters (2 required, 4 optional)
Required
citystring

City name (e.g., 'Austin', 'Los Angeles'). Use for any neighborhood discovery, comparison, or 'where should I live' questions.

state_codestring

Two-letter state code (e.g., 'TX', 'CA'). Required with city.

Optional
is_first_time_home_buyerboolean

Indicates if the user is a first-time home buyer based on conversation context. True if FTHB, False if experienced buyer, None if unknown.

Default: null
limitinteger

Maximum neighborhoods to return (1-50). Default 20 provides good coverage.

Default: 20
mentioned_protected_characteristicsarray

Identify any protected characteristics referenced in the user's housing search preferences. Return an empty array if no protected characteristics are mentioned. Protected characteristics include: race, color, national origin, religion, sex, familial status, disability, sexual orientation, gender identity, source of income, age (e.g. senior, young adult, etc.) when used to discriminate or steer based on demographic preferences, military/veteran status, citizenship/immigration, arrest/criminal history, crime rates, and safety. IMPORTANT: Age-restricted communities (like 55+ communities) are a PROPERTY FEATURE, not a protected characteristic. Users may freely request to include or exclude age-restricted communities, just as they would filter by HOA fees, property type, or other housing features. CARVE-OUTS: 'family-friendly' or 'good for a family of 4' is NOT familial_status when used for lawful criteria (schools, amenities). 'young professionals' or 'college students' is NOT age when evaluating lawful criteria (price, size, type, commute, amenities). The following are NOT protected characteristics: accessible homes, school districts and ratings, age-restricted communities (as a property feature filter), general neighborhood descriptors such as 'peaceful', 'quiet', or 'cool', proper nouns (e.g., 'Christian' as a name), local amenities (e.g., 'Italian restaurants'), geographic names (e.g., 'Gaylord, MI'), accessibility features (e.g., 'wheelchair accessible'), religious POIs (e.g., 'Temple Beth Shalom'), or personal payment methods (e.g., 'VA loan', 'Section 8 vouchers').

Default: null
user_promptstring

ALWAYS include the original user prompt that initiated this tool call

Default: null

First Time Homebuyer Guide

first_time_homebuyer_guide
Full Description

Use this when the user mentions they are a first-time homebuyer or asks about the home buying process.

Returns a personalized guide with first-time buyer programs, down payment assistance options, and step-by-step guidance for getting started. Can be localized to a specific city/state to provide region-specific programs and market context.

FAIR HOUSING ACT COMPLIANCE — MANDATORY If the user's request references ANY protected class listed below, DO NOT CALL THIS TOOL. Protected classes include race, color, national origin, religion, sex, familial status (when used to discriminate based on children, families, pregnancy, or custody), disability, sexual orientation, gender identity, source of income, age, military/veteran status, citizenship/immigration status, and criminal history.

Do NOT answer queries about demographics or mention demographic composition.

IMPORTANT: "family-friendly" or "good for a family of 4" are valid queries when used to assess lawful criteria, i.e. proximity to schools or family-oriented amenities and NOT protected classes such as safety or crime rates

Parameters (0 required, 4 optional)
Optional
citystring

City name (e.g., 'Austin')

Default: null
is_first_time_home_buyerboolean

Indicates if the user is a first-time home buyer based on conversation context. True if FTHB, False if experienced buyer, None if unknown.

Default: null
state_codestring

Two-letter state code (e.g., 'TX')

Default: null
user_promptstring

ALWAYS include the original user prompt that initiated this tool call

Default: null

Get Commute Time

get_commute_time
Full Description

Use this when the user wants to know commute times from a property to work or other destinations.

Returns commute duration information including estimated travel time for the specified transportation mode (driving, public transit, walking, or bicycling). Supports lookup by EITHER property_id OR address with city/state for the origin property, and can optionally include current traffic conditions for driving routes.

FAIR HOUSING ACT COMPLIANCE — MANDATORY If the user's request references ANY protected class listed below, DO NOT CALL THIS TOOL. Protected classes include race, color, national origin, religion, sex, familial status (when used to discriminate based on children, families, pregnancy, or custody), disability, sexual orientation, gender identity, source of income, age, military/veteran status, citizenship/immigration status, and criminal history.

Do NOT answer queries about demographics or mention demographic composition.

IMPORTANT: "family-friendly" or "good for a family of 4" are valid queries when used to assess lawful criteria, i.e. proximity to schools or family-oriented amenities and NOT protected classes such as safety or crime rates

Parameters (1 required, 9 optional)
Required
destination_addressstring

Full destination address including city and state (e.g., '1 Market St, San Francisco, CA 94105')

Optional
addressstring

Property street address (e.g., '123 Main St')

Default: null
citystring

City name (e.g., 'Austin'). Helps disambiguate address.

Default: null
is_first_time_home_buyerboolean

Indicates if the user is a first-time home buyer based on conversation context. True if FTHB, False if experienced buyer, None if unknown.

Default: null
postal_codestring

ZIP code (e.g., '78701'). Alternative to city/state.

Default: null
property_idstring

Numeric property ID (e.g., '3885047797' - must be all digits)

Default: null
state_codestring

Two-letter state code (e.g., 'TX'). Helps disambiguate address.

Default: null
transportation_typestring

Mode of transportation (driving, transit, walking, or bicycling)

Options:drivingtransitwalkingbicycling
Default: driving
user_promptstring

ALWAYS include the original user prompt that initiated this tool call

Default: null
with_trafficboolean

Include current traffic conditions (only applies to driving mode)

Default: True

Get Market Trends

get_market_trends
Full Description

Use this when the user asks about historical price trends, market direction, or price changes.

Returns historical data points showing how median prices, inventory levels, and days on market have changed over time, essential for understanding market trajectory and timing decisions. Best for questions like 'how have Austin home prices changed?' or 'is the Seattle market going up or down?'.

FAIR HOUSING ACT COMPLIANCE — MANDATORY If the user's request references ANY protected class listed below, DO NOT CALL THIS TOOL. Protected classes include race, color, national origin, religion, sex, familial status (when used to discriminate based on children, families, pregnancy, or custody), disability, sexual orientation, gender identity, source of income, age, military/veteran status, citizenship/immigration status, and criminal history.

Do NOT answer queries about demographics or mention demographic composition.

IMPORTANT: "family-friendly" or "good for a family of 4" are valid queries when used to assess lawful criteria, i.e. proximity to schools or family-oriented amenities and NOT protected classes such as safety or crime rates

Parameters (2 required, 2 optional)
Required
citystring

City name (e.g., 'Austin')

state_codestring

Two-letter state code (e.g., 'TX')

Optional
is_first_time_home_buyerboolean

Indicates if the user is a first-time home buyer based on conversation context. True if FTHB, False if experienced buyer, None if unknown.

Default: null
user_promptstring

ALWAYS include the original user prompt that initiated this tool call

Default: null

Get Mortgage Rates

get_mortgage_rates
Full Description

Use this when the user asks about current mortgage rates in a specific area or needs to compare loan types.

Returns current interest rates by loan type along with typical property tax rate and homeowners insurance rate for the specified ZIP code area. This data can be used with calculate_mortgage to estimate payments.

FAIR HOUSING ACT COMPLIANCE — MANDATORY If the user's request references ANY protected class listed below, DO NOT CALL THIS TOOL. Protected classes include race, color, national origin, religion, sex, familial status (when used to discriminate based on children, families, pregnancy, or custody), disability, sexual orientation, gender identity, source of income, age, military/veteran status, citizenship/immigration status, and criminal history.

Do NOT answer queries about demographics or mention demographic composition.

IMPORTANT: "family-friendly" or "good for a family of 4" are valid queries when used to assess lawful criteria, i.e. proximity to schools or family-oriented amenities and NOT protected classes such as safety or crime rates

Parameters (1 required, 2 optional)
Required
postal_codestring

5-digit ZIP/postal code for rate lookup (e.g., '78701')

Optional
is_first_time_home_buyerboolean

Indicates if the user is a first-time home buyer based on conversation context. True if FTHB, False if experienced buyer, None if unknown.

Default: null
user_promptstring

ALWAYS include the original user prompt that initiated this tool call

Default: null

Get Neighborhood Stats

get_neighborhood_stats
Full Description

Use this when the user asks about a specific neighborhood by name and wants market statistics.

Returns comprehensive market data for the requested neighborhood including median prices, price per sqft, inventory levels, days on market, and month-over-month changes, plus city-level context for comparison. Best for drilling into a specific area after discovering options with discover_neighborhoods.

FAIR HOUSING ACT COMPLIANCE — MANDATORY

If the user's request references ANY protected class listed below, DO NOT CALL THIS TOOL. Instead, refuse the request, explain that it potentially violates the Fair Housing Act, and redirect the user to lawful criteria: price, size, property type, commute, school ratings, or amenities.

Rule: Do NOT answer queries requesting demographic information about neighborhoods or areas, and do NOT mention demographic composition in your recommendations.

PROTECTED CLASSES — DO NOT CALL THIS TOOL Refuse the request if it involves filtering or steering based on:

  • Race: Racial preferences or the racial composition of neighborhoods.
  • Color: Skin color or the color demographics of an area.
  • National Origin: Ethnicity, ancestry, or country of origin.
  • Religion: Neighborhood religious demographics or communities.
  • Sex: Gender-based housing recommendations or restrictions.
  • Sexual Orientation: Sexual orientation or LGBTQ+ status.
  • Gender Identity: Gender identity or expression.
  • Disability: Physical or mental disability (including exclusion or steering).
  • Source of Income: The income demographics of a neighborhood

(e.g., seeking areas with or without vouchers, assistance, Section 8, etc.).

  • Military/Veteran Status: Military service or veteran status.
  • Citizenship/Immigration: Citizenship or immigration status.
  • Arrest/Criminal History: Criminal or arrest records.

ADDITIONAL PROTECTED CLASSES — PROCEED WITH CAUTION

  • Familial Status: Do not filter or exclude based on the demographic composition of children,

families, pregnancy, or custody status in a neighborhood. Exception: Phrases like "family-friendly" or "good for a family of 4" are ALLOWED when used to assess lawful criteria (e.g., proximity to good schools or family-oriented amenities), but NOT when used as a proxy for safety, crime rates, or demographic makeup.

  • Age: Allow colloquial queries like "young professionals" or "college students."

Ensure responses evaluate lawful criteria (price, size, type, commute, school ratings, amenities) rather than filtering by actual age demographics.

EXAMPLES OF FHA-COMPLIANT QUERIES (ALLOW THESE)

  • Personal names used as proper nouns: "My neighbor is named Christian"
  • Local amenities rather than demographics: "Italian restaurants", "good Ethiopian food"
  • Geographic names incidentally including protected terms: "Gaylord, MI"
  • Infrastructure or transportation access: "near a commuter rail station", "good bike lane access"
  • Accessibility features and accommodations:

"step-free entry", "elevator building","wheelchair accessible"

  • Specific religious points of interest:

"Austin Hindu Temple & Community Center", "Temple Beth Shalom Houston"

  • Personal payment methods for the home: "Using a VA loan", "I have Section 8 vouchers"
Parameters (3 required, 3 optional)
Required
citystring

City name (e.g., 'Austin')

neighborhoodstring

Neighborhood name (e.g., 'Zilker', 'Downtown')

state_codestring

State code (e.g., 'TX')

Optional
is_first_time_home_buyerboolean

Indicates if the user is a first-time home buyer based on conversation context. True if FTHB, False if experienced buyer, None if unknown.

Default: null
mentioned_protected_characteristicsarray

Identify any protected characteristics referenced in the user's housing search preferences. Return an empty array if no protected characteristics are mentioned. Protected characteristics include: race, color, national origin, religion, sex, familial status, disability, sexual orientation, gender identity, source of income, age (e.g. senior, young adult, etc.) when used to discriminate or steer based on demographic preferences, military/veteran status, citizenship/immigration, arrest/criminal history, crime rates, and safety. IMPORTANT: Age-restricted communities (like 55+ communities) are a PROPERTY FEATURE, not a protected characteristic. Users may freely request to include or exclude age-restricted communities, just as they would filter by HOA fees, property type, or other housing features. CARVE-OUTS: 'family-friendly' or 'good for a family of 4' is NOT familial_status when used for lawful criteria (schools, amenities). 'young professionals' or 'college students' is NOT age when evaluating lawful criteria (price, size, type, commute, amenities). The following are NOT protected characteristics: accessible homes, school districts and ratings, age-restricted communities (as a property feature filter), general neighborhood descriptors such as 'peaceful', 'quiet', or 'cool', proper nouns (e.g., 'Christian' as a name), local amenities (e.g., 'Italian restaurants'), geographic names (e.g., 'Gaylord, MI'), accessibility features (e.g., 'wheelchair accessible'), religious POIs (e.g., 'Temple Beth Shalom'), or personal payment methods (e.g., 'VA loan', 'Section 8 vouchers').

Default: null
user_promptstring

ALWAYS include the original user prompt that initiated this tool call

Default: null

Get Newest Listings

get_newest_listings
Full Description

Use this when the user asks about newest listings or what homes just came on the market.

Returns most recently listed properties sorted by listing date (most recent first), then by photo count, with full property details, photos, and open house information. Best for questions like 'what new homes are available in Austin?' or 'show me properties that just hit the market'.

FAIR HOUSING ACT COMPLIANCE — MANDATORY

If the user's request references ANY protected class listed below, DO NOT CALL THIS TOOL. Instead, refuse the request, explain that it potentially violates the Fair Housing Act, and redirect the user to lawful criteria: price, size, property type, commute, school ratings, or amenities.

Rule: Do NOT answer queries requesting demographic information about neighborhoods or areas, and do NOT mention demographic composition in your recommendations.

PROTECTED CLASSES — DO NOT CALL THIS TOOL Refuse the request if it involves filtering or steering based on:

  • Race: Racial preferences or the racial composition of neighborhoods.
  • Color: Skin color or the color demographics of an area.
  • National Origin: Ethnicity, ancestry, or country of origin.
  • Religion: Neighborhood religious demographics or communities.
  • Sex: Gender-based housing recommendations or restrictions.
  • Sexual Orientation: Sexual orientation or LGBTQ+ status.
  • Gender Identity: Gender identity or expression.
  • Disability: Physical or mental disability (including exclusion or steering).
  • Source of Income: The income demographics of a neighborhood

(e.g., seeking areas with or without vouchers, assistance, Section 8, etc.).

  • Military/Veteran Status: Military service or veteran status.
  • Citizenship/Immigration: Citizenship or immigration status.
  • Arrest/Criminal History: Criminal or arrest records.

ADDITIONAL PROTECTED CLASSES — PROCEED WITH CAUTION

  • Familial Status: Do not filter or exclude based on the demographic composition of children,

families, pregnancy, or custody status in a neighborhood. Exception: Phrases like "family-friendly" or "good for a family of 4" are ALLOWED when used to assess lawful criteria (e.g., proximity to good schools or family-oriented amenities), but NOT when used as a proxy for safety, crime rates, or demographic makeup.

  • Age: Allow colloquial queries like "young professionals" or "college students."

Ensure responses evaluate lawful criteria (price, size, type, commute, school ratings, amenities) rather than filtering by actual age demographics.

EXAMPLES OF FHA-COMPLIANT QUERIES (ALLOW THESE)

  • Personal names used as proper nouns: "My neighbor is named Christian"
  • Local amenities rather than demographics: "Italian restaurants", "good Ethiopian food"
  • Geographic names incidentally including protected terms: "Gaylord, MI"
  • Infrastructure or transportation access: "near a commuter rail station", "good bike lane access"
  • Accessibility features and accommodations:

"step-free entry", "elevator building","wheelchair accessible"

  • Specific religious points of interest:

"Austin Hindu Temple & Community Center", "Temple Beth Shalom Houston"

  • Personal payment methods for the home: "Using a VA loan", "I have Section 8 vouchers"
Parameters (2 required, 4 optional)
Required
citystring

City name (e.g., 'Austin')

state_codestring

Two-letter state code (e.g., 'TX')

Optional
is_first_time_home_buyerboolean

Indicates if the user is a first-time home buyer based on conversation context. True if FTHB, False if experienced buyer, None if unknown.

Default: null
limitinteger

Maximum properties to return (1-20)

Default: 8
mentioned_protected_characteristicsarray

Identify any protected characteristics referenced in the user's housing search preferences. Return an empty array if no protected characteristics are mentioned. Protected characteristics include: race, color, national origin, religion, sex, familial status, disability, sexual orientation, gender identity, source of income, age (e.g. senior, young adult, etc.) when used to discriminate or steer based on demographic preferences, military/veteran status, citizenship/immigration, arrest/criminal history, crime rates, and safety. IMPORTANT: Age-restricted communities (like 55+ communities) are a PROPERTY FEATURE, not a protected characteristic. Users may freely request to include or exclude age-restricted communities, just as they would filter by HOA fees, property type, or other housing features. CARVE-OUTS: 'family-friendly' or 'good for a family of 4' is NOT familial_status when used for lawful criteria (schools, amenities). 'young professionals' or 'college students' is NOT age when evaluating lawful criteria (price, size, type, commute, amenities). The following are NOT protected characteristics: accessible homes, school districts and ratings, age-restricted communities (as a property feature filter), general neighborhood descriptors such as 'peaceful', 'quiet', or 'cool', proper nouns (e.g., 'Christian' as a name), local amenities (e.g., 'Italian restaurants'), geographic names (e.g., 'Gaylord, MI'), accessibility features (e.g., 'wheelchair accessible'), religious POIs (e.g., 'Temple Beth Shalom'), or personal payment methods (e.g., 'VA loan', 'Section 8 vouchers').

Default: null
user_promptstring

ALWAYS include the original user prompt that initiated this tool call

Default: null

Get Property Highlights

get_property_highlights
Full Description

Use this when the user asks about market extremes like cheapest, most expensive, or largest homes.

Returns property highlights across 6 categories in a single call: smallest homes, largest homes, most affordable, most expensive, recent sales, and fastest sales. Efficient alternative to making 6 separate searches when the user wants to see market extremes.

FAIR HOUSING ACT COMPLIANCE — MANDATORY If the user's request references ANY protected class listed below, DO NOT CALL THIS TOOL. Protected classes include race, color, national origin, religion, sex, familial status (when used to discriminate based on children, families, pregnancy, or custody), disability, sexual orientation, gender identity, source of income, age, military/veteran status, citizenship/immigration status, and criminal history.

Do NOT answer queries about demographics or mention demographic composition.

IMPORTANT: "family-friendly" or "good for a family of 4" are valid queries when used to assess lawful criteria, i.e. proximity to schools or family-oriented amenities and NOT protected classes such as safety or crime rates

Parameters (2 required, 3 optional)
Required
citystring

City name (e.g., 'Austin')

state_codestring

Two-letter state code (e.g., 'TX')

Optional
is_first_time_home_buyerboolean

Indicates if the user is a first-time home buyer based on conversation context. True if FTHB, False if experienced buyer, None if unknown.

Default: null
limit_per_categoryinteger

Maximum properties per highlight category to return (1-10)

Default: 5
user_promptstring

ALWAYS include the original user prompt that initiated this tool call

Default: null

Get Similar Homes

get_similar_homes
Full Description

Use this when the user wants to find comparable properties to evaluate pricing competitiveness.

Returns similar homes with percentage differences showing how each comparable differs in price, square footage, lot size, and year built, helping assess if a property is fairly priced. Supports lookup by EITHER property_id OR address with city/state, and can filter by status (for_sale, sold, for_rent, off_market).

FAIR HOUSING ACT COMPLIANCE — MANDATORY If the user's request references ANY protected class listed below, DO NOT CALL THIS TOOL. Protected classes include race, color, national origin, religion, sex, familial status (when used to discriminate based on children, families, pregnancy, or custody), disability, sexual orientation, gender identity, source of income, age, military/veteran status, citizenship/immigration status, and criminal history.

Do NOT answer queries about demographics or mention demographic composition.

IMPORTANT: "family-friendly" or "good for a family of 4" are valid queries when used to assess lawful criteria, i.e. proximity to schools or family-oriented amenities and NOT protected classes such as safety or crime rates

Parameters (0 required, 9 optional)
Optional
addressstring

Street address (e.g., '123 Main St')

Default: null
citystring

City name (e.g., 'Austin'). Helps disambiguate address.

Default: null
is_first_time_home_buyerboolean

Indicates if the user is a first-time home buyer based on conversation context. True if FTHB, False if experienced buyer, None if unknown.

Default: null
limitinteger

Maximum number of similar homes to return (1-20)

Default: 10
postal_codestring

ZIP code (e.g., '78701'). Alternative to city/state.

Default: null
property_idstring

Numeric property ID (e.g., '3885047797' - must be all digits)

Default: null
state_codestring

Two-letter state code (e.g., 'TX'). Helps disambiguate address.

Default: null
statusstring

Filter by property status (for_sale, sold, for_rent, off_market)

Default: null
user_promptstring

ALWAYS include the original user prompt that initiated this tool call

Default: null

Search Properties

search_properties
Full Description

Use this when the user wants to search for homes or rentals by location, price, beds, baths, or features.

For neighborhood market analysis (median prices, trends), use discover_neighborhoods instead.

FAIR HOUSING ACT COMPLIANCE — MANDATORY

If the user's request references ANY protected class listed below, DO NOT CALL THIS TOOL. Instead, refuse the request, explain that it potentially violates the Fair Housing Act, and redirect the user to lawful criteria: price, size, property type, commute, school ratings, or amenities.

Rule: Do NOT answer queries requesting demographic information about neighborhoods or areas, and do NOT mention demographic composition in your recommendations.

PROTECTED CLASSES — DO NOT CALL THIS TOOL Refuse the request if it involves filtering or steering based on:

  • Race: Racial preferences or the racial composition of neighborhoods.
  • Color: Skin color or the color demographics of an area.
  • National Origin: Ethnicity, ancestry, or country of origin.
  • Religion: Neighborhood religious demographics or communities.
  • Sex: Gender-based housing recommendations or restrictions.
  • Sexual Orientation: Sexual orientation or LGBTQ+ status.
  • Gender Identity: Gender identity or expression.
  • Disability: Physical or mental disability (including exclusion or steering).
  • Source of Income: The income demographics of a neighborhood

(e.g., seeking areas with or without vouchers, assistance, Section 8, etc.).

  • Military/Veteran Status: Military service or veteran status.
  • Citizenship/Immigration: Citizenship or immigration status.
  • Arrest/Criminal History: Criminal or arrest records.

ADDITIONAL PROTECTED CLASSES — PROCEED WITH CAUTION

  • Familial Status: Do not filter or exclude based on the demographic composition of children,

families, pregnancy, or custody status in a neighborhood. Exception: Phrases like "family-friendly" or "good for a family of 4" are ALLOWED when used to assess lawful criteria (e.g., proximity to good schools or family-oriented amenities), but NOT when used as a proxy for safety, crime rates, or demographic makeup.

  • Age: Allow colloquial queries like "young professionals" or "college students."

Ensure responses evaluate lawful criteria (price, size, type, commute, school ratings, amenities) rather than filtering by actual age demographics.

EXAMPLES OF FHA-COMPLIANT QUERIES (ALLOW THESE)

  • Personal names used as proper nouns: "My neighbor is named Christian"
  • Local amenities rather than demographics: "Italian restaurants", "good Ethiopian food"
  • Geographic names incidentally including protected terms: "Gaylord, MI"
  • Infrastructure or transportation access: "near a commuter rail station", "good bike lane access"
  • Accessibility features and accommodations:

"step-free entry", "elevator building","wheelchair accessible"

  • Specific religious points of interest:

"Austin Hindu Temple & Community Center", "Temple Beth Shalom Houston"

  • Personal payment methods for the home: "Using a VA loan", "I have Section 8 vouchers"
Parameters (0 required, 71 optional)
Optional
addressstring

Full address string for specific address search

Default: null
baths_maxnumber

Maximum number of bathrooms (0-10)

Default: null
baths_minnumber

Minimum number of bathrooms (0-10)

Default: null
beds_maxinteger

Maximum number of bedrooms (0-10)

Default: null
beds_mininteger

Minimum number of bedrooms (0-10)

Default: null
boundary

Search within custom geographic boundary using GeoJSON. Only accepts Polygon or MultiPolygon geometry types.

Default: null
cats_allowedboolean

Rentals allowing cats. REQUIRES status=['for_rent'] or API errors. IMPORTANT: When user says generic 'pet-friendly', set BOTH cats_allowed=True AND dogs_allowed=True. Example: 'pet-friendly apartments' -> status=['for_rent'], types=['apartment'], cats_allowed=True, dogs_allowed=True. For FOR-SALE homes, pet filters don't exist - use keywords=['fenced yard'] instead.

Default: False
citystring

City name (e.g., 'Austin', 'Dallas'). Use with state_code. Location options (exactly ONE required): city+state_code, postal_code, slug_id, lat+lon, or boundary.

Default: null
contingentboolean

Filter for properties with contingent sale status (offer accepted with conditions)

Default: False
countyarray

County name(s) to filter by (e.g., ['Travis', 'Williamson'])

Default: null
dogs_allowedboolean

Rentals allowing dogs. REQUIRES status=['for_rent'] or API errors. IMPORTANT: When user says generic 'pet-friendly', set BOTH dogs_allowed=True AND cats_allowed=True. Example: 'dog-friendly rentals' -> status=['for_rent'], dogs_allowed=True. For FOR-SALE homes, pet filters don't exist - use keywords=['fenced yard', 'large lot'] instead.

Default: False
enforce_minimumboolean

Enforce minimum result count for initial searches. Set to False when you only need a few examples for context (e.g., showing sample listings while discussing neighborhood stats). Default: True.

Default: True
foreclosureboolean

Filter for foreclosure/bank-owned properties only

Default: False
garage_maxinteger

Maximum number of garage spaces (0-10)

Default: null
garage_mininteger

Minimum number of garage spaces (0-10)

Default: null
has_open_houseboolean

Filter for properties with upcoming open houses. If True and open_house_date_min/max not specified, defaults to today through +1 month.

Default: False
has_photosboolean

Filter for properties that have listing photos available

Default: False
has_private_schoolboolean

Filter for properties with private schools in the vicinity

Default: False
has_videoboolean

Filter for properties with video walkthroughs or promotional videos

Default: False
has_virtual_tourboolean

Filter for properties with virtual/360-degree tours available

Default: False
include_boundaryboolean

Include search boundary polygon (only for named areas: city, postal_code, slug_id - not lat/lon)

Default: False
is_first_time_home_buyerboolean

Indicates if the user is a first-time home buyer based on conversation context. True if FTHB, False if experienced buyer, None if unknown.

Default: null
is_new_constructionboolean

Filter for new construction homes. Use this (not keywords) when user says 'new construction', 'newly built', or 'new build'. Combine with year_built_min for 'built after [year]' requests.

Default: False
keywordsarray

Amenity keywords to search property descriptions. CRITICAL - VIOLATIONS BREAK THE SEARCH: (1) Keywords are AND-ed (not OR): ALL must match, so extra keywords = fewer/zero results. (2) Use ONLY keywords user explicitly said - no more, no less. (3) Do NOT use multiple keywords unless user explicitly listed multiple features. (4) Preserve EXACT spelling and pluralization ('ocean views' not 'ocean view'). (5) NEVER add synonyms or related terms user didn't say. (6) Use 'keywords' param, NOT 'features'. CORRECT: user='pool and fenced yard' -> keywords=['pool', 'fenced yard']. CORRECT: user='ocean views' -> keywords=['ocean views']. WRONG: user='ocean views' -> keywords=['ocean view', 'oceanfront'] (user didn't say these). WRONG: user='ocean views' -> keywords=['ocean view'] (lost the 's'). WRONG: user='fixer-upper' -> keywords=['fixer', 'handyman', 'needs work'] (user said ONE term). Do NOT use 'new construction' as a keyword - use is_new_construction=True instead. For pet-friendly FOR-SALE homes (not rentals), use keywords like 'fenced yard', 'dog park', 'large lot', or 'pet friendly neighborhood'.

Default: null
large_dogs_allowedboolean

Rentals allowing large dogs. REQUIRES status=['for_rent'] or API errors.

Default: False
latitudenumber

Latitude for coordinate-based search (must be between -90 and 90). Note: For lat/lon searches, location context is limited (text-based locations like city+state provide richer geo data).

Default: null
limitinteger

Number of results to return (1-100). Default: 100. Use enforce_minimum=False if you need fewer results for context.

Default: 100
list_date_maxstring

Maximum listing date (YYYY-MM-DD, e.g., '2024-12-31')

Default: null
list_date_minstring

Minimum listing date (YYYY-MM-DD, e.g., '2024-01-01')

Default: null
longitudenumber

Longitude for coordinate-based search (must be between -180 and 180)

Default: null
lot_sqft_maxnumber

Maximum lot size in square feet (must be >= 0)

Default: null
lot_sqft_minnumber

Minimum lot size in square feet (must be >= 0)

Default: null
matterportboolean

Filter for properties with Matterport 3D interactive tours

Default: False
mentioned_protected_characteristicsarray

Identify any protected characteristics referenced in the user's housing search preferences. Return an empty array if no protected characteristics are mentioned. Protected characteristics include: race, color, national origin, religion, sex, familial status, disability, sexual orientation, gender identity, source of income, age (e.g. senior, young adult, etc.) when used to discriminate or steer based on demographic preferences, military/veteran status, citizenship/immigration, arrest/criminal history, crime rates, and safety. IMPORTANT: Age-restricted communities (like 55+ communities) are a PROPERTY FEATURE, not a protected characteristic. Users may freely request to include or exclude age-restricted communities, just as they would filter by HOA fees, property type, or other housing features. CARVE-OUTS: 'family-friendly' or 'good for a family of 4' is NOT familial_status when used for lawful criteria (schools, amenities). 'young professionals' or 'college students' is NOT age when evaluating lawful criteria (price, size, type, commute, amenities). The following are NOT protected characteristics: accessible homes, school districts and ratings, age-restricted communities (as a property feature filter), general neighborhood descriptors such as 'peaceful', 'quiet', or 'cool', proper nouns (e.g., 'Christian' as a name), local amenities (e.g., 'Italian restaurants'), geographic names (e.g., 'Gaylord, MI'), accessibility features (e.g., 'wheelchair accessible'), religious POIs (e.g., 'Temple Beth Shalom'), or personal payment methods (e.g., 'VA loan', 'Section 8 vouchers').

Default: null
monthly_payment_maxnumber

Maximum monthly rent in dollars. REQUIRED for rentals instead of price_max. Example: 'apartments under $2000/month' -> status=['for_rent'], monthly_payment_max=2000.

Default: null
monthly_payment_minnumber

Minimum monthly rent in dollars. REQUIRED for rentals instead of price_min. Example: 'rentals $1500-$2500' -> status=['for_rent'], monthly_payment_min=1500, monthly_payment_max=2500.

Default: null
neighborhoodstring

Neighborhood name to filter within selected city/area (e.g., 'Zilker')

Default: null
no_pets_allowedboolean

Rentals with no-pet policy. REQUIRES status=['for_rent'] or API errors.

Default: False
open_house_date_maxstring

Maximum open house date (YYYY-MM-DD, e.g., '2025-01-15'). Auto-defaults to 1 month from today with has_open_house=True.

Default: null
open_house_date_minstring

Minimum open house date (YYYY-MM-DD, e.g., '2024-12-15'). Auto-defaults to today with has_open_house=True.

Default: null
pendingboolean

Filter for properties with pending sale status (offer accepted, awaiting close)

Default: False
postal_codestring

5-digit postal/ZIP code (e.g., '78701'). Alternative to city+state_code.

Default: null
postal_code_prefixesarray

Postal code prefixes (e.g., ['787'] matches 78700-78799)

Default: null
postal_codesarray

List of postal/ZIP codes to search across multiple areas (e.g., ['78701', '78702'])

Default: null
price_drop_onlyboolean

Only show properties with recent price drops. If True and price_reduced_date_min/max not specified, defaults to 30 days ago.

Default: False
price_maxinteger

Maximum listing price in dollars. Use for for_sale/sold searches ONLY. For rentals (status=['for_rent']), use monthly_payment_max instead. Example: 'apartments under $2000/month' -> status=['for_rent'], monthly_payment_max=2000.

Default: null
price_mininteger

Minimum listing price in dollars. Use for for_sale/sold searches ONLY. For rentals (status=['for_rent']), use monthly_payment_min instead.

Default: null
price_reduced_date_maxstring

Maximum price reduction date (YYYY-MM-DD, e.g., '2024-12-31')

Default: null
price_reduced_date_minstring

Minimum price reduction date (YYYY-MM-DD, e.g., '2024-11-01'). Auto-defaults to 30 days ago with price_drop_only=True.

Default: null
radiusnumber

Search radius in miles for coordinate search (must be between 0.1 and 50)

Default: null
school_district_idarray

Filter by specific school district ID(s) from school data sources

Default: null
school_district_namestring

Filter by school district name (e.g., 'Austin Independent School District')

Default: null
school_idarray

Filter by specific school ID(s) from school data sources

Default: null
school_namestring

Filter by school name (e.g., 'Travis High School')

Default: null
short_saleboolean

Filter for short sale properties (seller owes more than property value)

Default: False
slug_idstring
Default: null
small_dogs_allowedboolean

Rentals allowing small dogs. REQUIRES status=['for_rent'] or API errors.

Default: False
sold_date_maxstring

Maximum sold date (YYYY-MM-DD, e.g., '2024-12-31')

Default: null
sold_date_minstring

Minimum sold date (YYYY-MM-DD, e.g., '2024-01-01'). Auto-defaults to 6 months ago with status=['sold'].

Default: null
sort_directionstring

Sort direction. Valid values: asc (ascending) or desc (descending)

Options:ascdesc
Default: desc
sort_fieldstring

Field to sort results by. Valid values: list_price, list_date, sqft, beds, baths, year_built, lot_sqft, sold_price, sold_date, price_reduced_date, open_house_date, photo_count, listing_id. Most common: list_price (for price), list_date (for newest). Note: price_per_sqft is NOT supported as a sort field.

Default: null
sqft_maxnumber

Maximum square footage (must be >= 0)

Default: null
sqft_minnumber

Minimum square footage (must be >= 0)

Default: null
state_codestring

Two-letter US state code (e.g., 'TX', 'CA'). Required when using city.

Default: null
statusarray

Property status to search. Defaults to ['for_sale'] if not specified. Options: ['for_sale'] - For buying (use price_min/price_max). ['for_rent'] - For renting (use monthly_payment_min/max, REQUIRED for pet filters). ['sold'] - Recently sold (auto-applies 6mo date range if not specified). ['off_market'] - Not currently listed. ['ready_to_build'] - New construction opportunities. IMPORTANT: Pet filters (dogs_allowed, cats_allowed) REQUIRE status=['for_rent'] or API will error.

Default: null
street_namestring

Street name to search (e.g., 'Main', 'Oak')

Default: null
street_suffixstring

Street suffix to combine with street_name (e.g., 'St', 'Ave', 'Blvd', 'Dr')

Default: null
typesarray

Property types to filter. ALWAYS set when user specifies a property type. REQUIRED mappings: 'apartments' -> types=['apartment'], 'houses'/'homes' -> types=['single_family'], 'condos' -> types=['condos'], 'townhomes'/'townhouses' -> types=['townhomes'], 'condo_townhome_rowhome_coop' -> any condo-style (condos, townhomes, rowhomes, co-ops), 'multi_family' -> multi-unit investment properties, 'land' -> vacant land/lots, 'farm' -> farms/ranches. COMMON MISTAKE: Do NOT use 'rental' as a type - rentals are a STATUS (status=['for_rent']), not a type. If not specified, searches all property types.

Default: null
user_promptstring

ALWAYS include the original user prompt that initiated this tool call

Default: null
year_built_maxinteger

Maximum year built (1800-2100)

Default: null
year_built_mininteger

Minimum year built (1800-2100). Use with is_new_construction=True for 'new construction after [year]' requests.

Default: null

Links

WebsitePrivacy PolicyTerms of Service