Search properties
search_propertiesFind active U.S. homes for sale or rent in a city+state, ZIP codes, a radius around a point, or a polygon. Hard requirements (max_price, min_bedrooms, min_bathrooms, property_types, must_have) filter; soft preferences (ideal_max_price, preferred_bedrooms, nice_to_have, styles) rank; avoid and exclude_property_types exclude. Each result has a 0-100 match score with reasons and uncertainties, the features the listing states (with evidence class), source details and when it was last confirmed active. Features a listing does not mention are UNKNOWN, never assumed. Reuses data fetched in the last 12 hours; otherwise makes a live request if the daily allowance permits. Source: Realtor.com (via RapidAPI) with RentCast as fallback; each result names its source. Never present results beyond what is returned.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | match | |
| avoid | No | Features that exclude a listing when the listing states them, e.g. fixer-upper, pool. | |
| limit | No | ||
| notes | No | The user's own words, kept for reference; terms in it that match the feature list become soft preferences. | |
| offset | No | ||
| styles | No | Architectural styles, e.g. Craftsman, Victorian, mid-century modern. | |
| location | Yes | ||
| max_price | No | Hard ceiling: listings above it are excluded. | |
| min_price | No | ||
| must_have | No | Mandatory features, e.g. garage, fireplace. Unmentioned = unverified, not excluded (unless strict_unknowns). | |
| investment | No | ||
| max_hoa_fee | No | ||
| listing_type | Yes | ||
| max_distance | No | Straight-line distance from a place the user names (e.g. work). Not driving time. | |
| min_bedrooms | No | ||
| min_lot_area | No | ||
| nice_to_have | No | Soft features that improve ranking. | |
| min_bathrooms | No | ||
| min_year_built | No | ||
| property_types | No | ||
| ideal_max_price | No | Soft target: listings above it rank lower but stay in. | |
| min_living_area | No | ||
| strict_unknowns | No | Exclude listings that do not state a must_have feature (default false: keep and flag). | |
| allow_live_request | No | false = stored data only (no provider request). | |
| bedrooms_exception | No | e.g. 'three bedrooms, but two is fine with an office': min_bedrooms 3 plus {min_bedrooms: 2, requires: ['home office']} | |
| preferred_bedrooms | No | ||
| include_non_matching | No | true = also return listings that fail a hard requirement, with the reason. | |
| exclude_property_types | No |