Create search automation
spur_create_search_automationSchedule a recurring property search. Event automations default to the legacy engine to retain event tracking. Data-platform mode supports recipe_key/params/selections, credit budgets, unknown-result lists, automatic contacts with a credit cap and conditions, and channel outreach routes. Each enabled run spends credits/actions and can contact people; approve the settings before enabling. Use params={source:"data_search",location:{...},filters:{...}} for exact Data Search filters. Legacy listing/event filters remain supported.
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_data_search 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.
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": {
"name": "<name>",
"location": "<location>",
"frequency": "<frequency>",
"run_time": "<run_time>"
},
"name": "spur_create_search_automation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Automation name shown in Spur | |
| engine | No | ||
| events | No | Only listings where any of these events happened; see the tool description | |
| params | No | Recipe parameters including location, or {source:"data_search", location:{...}, filters:{...}} for exact Data Search filters | |
| confirm | No | Required when enabled=true: approve the recurring search, budgets and automatic outreach first | |
| 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) | |
| recipe_key | No | ||
| selections | No | ||
| 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 | |
| auto_contacts | No | ||
| 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 | |
| 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) | |
| unknown_policy | No | ||
| outreach_routes | No | ||
| unknown_list_id | No | ||
| 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) | |
| contacts_condition | No | ||
| 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 | |
| budget_limit_credits | No | ||
| event_min_change_pct | No | Minimum % move for price / rent / Zestimate / assessment events | |
| only_pre_foreclosure | No | Distressed / pre-foreclosure (heuristic, includes description keywords) | |
| contacts_budget_credits | No | ||
| event_min_equity_gap_pct | No | Minimum % Zestimate above last sale price for equity_gap (default 30) |