Search properties (deprecated)
spur_search_propertiesDEPRECATED: use spur_parse_data_search to preview and spur_data_search to run searches. This tool stays for existing prompts and the property explorer cards, and now runs on Data Search: the same filters, mapped by Spur, with each value labeled by its provider.
listing_status (forRent / forSale / sold) searches current listings on ZHomes; without it the search covers off-market and owner records with automatic provider routing. Costs 1 search credit plus data credits per record returned (limit caps it); an empty page is free. Listing event filters (price drops, back on market, ...) are not available here: use spur_create_search_automation for those.
Follow up with spur_save_properties (pass the cards' listing objects) or spur_save_data_results. Saving is free.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"confirm": "<confirm>"
},
"name": "spur_search_properties"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum results (also caps the credits charged) | |
| query | No | Free-text request; Spur turns it into filters | |
| views | No | Only listings with any of these view types | |
| events | No | Only listings where any of these events happened; see the tool description | |
| confirm | Yes | Set to true ONLY after the user explicitly approved this exact action in the conversation. Never assume approval. | |
| max_age | No | At most this many years since built | |
| max_zip | No | Highest ZIP code in a numeric ZIP range (with min_zip) | |
| min_age | No | Years since built | |
| min_zip | No | Lowest ZIP code in a numeric ZIP range (with max_zip); prefer zip_list for specific ZIPs | |
| has_pool | No | true = only listings with a pool | |
| has_view | No | true = only listings with any view (use views on live search for a specific kind) | |
| keywords | No | Comma-separated listing keywords, e.g. "pool, granite" | |
| location | No | City and state ("Dallas, TX") or ZIP code | |
| max_beds | No | Maximum bedrooms | |
| max_sqft | No | Maximum living area in square feet | |
| min_beds | No | Minimum bedrooms | |
| min_sqft | No | Minimum living area in square feet | |
| zip_list | No | Keep only these ZIPs; set location to the city that contains them | |
| home_type | No | Zillow home type code | |
| max_baths | No | Maximum bathrooms | |
| max_price | No | Maximum price (monthly rent for rentals), USD | |
| min_baths | No | Minimum bathrooms (half baths count as 0.5) | |
| min_price | No | Minimum price (monthly rent for rentals), USD | |
| center_lat | No | Radius search centre (with center_lng and radius_miles) | |
| center_lng | No | Radius search centre longitude (with center_lat and radius_miles) | |
| has_garage | No | true = only listings with a garage | |
| min_equity | No | Estimated equity in USD (Zestimate or price minus assessed value; rough) | |
| days_posted | No | Only listings posted within this many days | |
| has_3d_tour | No | true = only listings with a 3D virtual tour | |
| only_vacant | No | Likely vacant (heuristic: description keywords + long days on market) | |
| listing_type | No | Seller / listing kind; for catching NEW entries into a distress stage prefer events | |
| max_lot_size | No | Square feet | |
| min_lot_size | No | Square feet (1 acre = 43,560) | |
| radius_miles | No | Keep only listings within this many miles of center_lat / center_lng | |
| is_waterfront | No | true = only waterfront listings | |
| neighborhoods | No | Neighborhood / area names matched against address and description | |
| only_absentee | No | Absentee-owned (owner mails elsewhere) | |
| has_open_house | No | true = only listings with an upcoming open house | |
| listing_status | No | Set for a listing search; omit for off-market and owner records | |
| max_year_built | No | Built in or before this year | |
| min_year_built | No | Built in or after this year | |
| ownership_type | No | business = LLC / corp / trust owners (heuristic) | |
| is_single_story | No | true = only single-story homes | |
| event_stale_days | No | Days on market that counts as stale (default 90) | |
| is_price_reduced | No | true = only listings whose asking price has been cut | |
| event_within_days | No | Lookback window for events, in days (default 7) | |
| max_days_on_market | No | Listed at most this many days | |
| min_days_on_market | No | Listed at least this many days (higher suggests a motivated seller) | |
| max_ownership_years | No | Owner has held the property at most this long | |
| min_ownership_years | No | Owner has held the property at least this long | |
| event_min_change_pct | No | Minimum % move for price / rent / Zestimate / assessment events | |
| has_air_conditioning | No | true = only listings with air conditioning | |
| only_pre_foreclosure | No | Distressed / pre-foreclosure (heuristic, includes description keywords) | |
| event_min_equity_gap_pct | No | Minimum % Zestimate above last sale price for equity_gap (default 30) |