Create search automation
spur_create_search_automationSchedule a recurring property search. Every run uses 1 search credit, or 2 when it makes more than 3 ZHomes calls (several event types, tax/sale-history events, furnished-only or description-based filters). New matches can be saved to a list and enriched automatically (auto_enrich spends skip-trace credits on every run, so confirm with the user).
Examples:
"every Monday 8am Central, Dallas rentals under $2k" -> frequency="weekly", day_of_week=1, run_time="08:00", timezone="America/Chicago", location="Dallas, TX", max_amount=2000
"last Friday of each month" -> frequency="monthly", day_of_week=5, week_of_month=-1
"every morning, new pre-foreclosures and price drops in Houston, save to my Distress list" -> frequency="daily", run_time="07:00", location="Houston, TX", events=["preforeclosure","price_drop"], list_id=…
Accepts the same advanced and event filters as spur_search_properties (min_amount / max_amount instead of min_price / max_price). Run the search once with spur_search_properties first so the user can check the results before scheduling.
In automations each event fires once, on the run that first sees it, so the same property isn't saved twice; change events start reporting from the second run. "delisted" is only available here.
Events (pass in events; a listing matches when ANY selected event fired, and is tagged with each):
Listing lifecycle: new_listing, coming_soon, coming_soon_active, price_drop, price_increase, pending, sold, back_on_market, delisted (automations only), open_house, rental_listed, rent_change, move_in_moved_up
Distress & motivation: preforeclosure, foreclosure, auction, bank_owned, distress_escalated, fsbo, agent_to_fsbo, stale_listing, new_construction
Valuation & tax: tax_assessment_posted, assessed_value_jump, tax_paid_dropped (weak), sale_recorded, zestimate_moved, equity_gap, price_below_assessed Direct events (price_drop, pending, sold, preforeclosure, fsbo, new_listing, …) work on the first search. Change events (price_increase, back_on_market, distress_escalated, agent_to_fsbo, rent_change, zestimate_moved, …) compare against what Spur saw on an earlier search of the same area, so the first search only records a baseline. Motivated-seller research usually combines price_drop, back_on_market, stale_listing, agent_to_fsbo and the distress stages.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Automation name shown in Spur | |
| events | No | Only listings where any of these events happened; see the tool description | |
| enabled | No | false = save it paused | |
| list_id | No | Save new matches into this property list | |
| 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 | |
| ai_query | No | Qualitative intent; each run re-ranks listings by description against it | |
| 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 | Yes | City/state or ZIP, e.g. "Dallas, TX" | |
| 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 | |
| run_time | Yes | 24h local time "HH:MM" | |
| timezone | No | IANA time zone, e.g. "America/Chicago" | UTC |
| zip_list | No | Keep only these ZIPs; set location to the city that contains them | |
| auto_save | No | Save new matches to the user's properties | |
| frequency | Yes | How often the search runs | |
| home_type | No | Zillow home type code | |
| max_baths | No | Maximum bathrooms | |
| min_baths | No | Minimum bathrooms (half baths count as 0.5) | |
| 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 | |
| max_amount | No | Maximum price in USD (rent per month for forRent) | |
| min_amount | No | Minimum price in USD (rent per month for forRent) | |
| min_equity | No | Estimated equity in USD (Zestimate or price minus assessed value; rough) | |
| auto_enrich | No | Skip-trace new matches on every run (spends enrichment credits) | |
| day_of_week | No | 0=Sunday … 6=Saturday; for weekly, biweekly, monthly | |
| days_posted | No | Only listings posted within this many days | |
| 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) | |
| week_of_month | No | Monthly only; -1 = last | |
| listing_status | No | Which listings to search | forRent |
| 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) | |
| 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 | |
| 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) |