search_unified_properties
Search legacy property feeds as one normalized, paginated list. Filter by state, county, zip, or address to find matching foreclosure records.
Instructions
Search legacy property feeds as one normalized, paginated list. Include at least one state, county, zip or address filter. Uses the same REST access and row allowances.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_unified_properties"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | Zip code filter. Can specify multiple. | |
| mode | No | ||
| page | No | Page number (default: 1). | |
| limit | No | Total listing rows across all groups: 1–100 paid or 1–10 during a new trial. Defaults to 25 when paid or 10 during a new trial. Choose a value within your remaining allowance. | |
| state | No | State name or abbreviation. Can specify multiple. | |
| county | No | County name filter. Can specify multiple (e.g., county=Cook&county=Lake). | |
| address | No | Property address filter (partial match). Can specify multiple. | |
| page_size | No | Results per page, 1–100 for paid keys or 1–10 for new trials. Defaults to 25 paid or 10 during a trial. Your remaining allowance may lower an omitted first-page size. | |
| sale_days | No | Minimum lead time: sale_date_parsed must be later than today + N days (integer 1-365, unbounded above). ANDs with sale_date_start/sale_date_end. Listings without a parsed sale date stay included — an unscheduled sale cannot violate the bound. Unified mode only. | |
| owner_name | No | Owner name filter (partial match on first or last name). Only applied to sources that expose owner fields. | |
| sale_status | No | Canonical sale-status group: active, coming-soon, for-sale, postponed, cancelled, price-reduced, back-to-bank, new-listing, sold, mortgage-foreclosure, outbid, preview, pending, hard-to-sell, nos, vacant-lot, sale-held, none. Groups merge clearly-equivalent feed statuses — e.g. cancelled covers Cancelled/WITHDRAWN/Sale Invalid, sold covers Sold/Completed/3rd-party variants, postponed covers postpone*/On Hold. none matches listings with no reported status. Unified mode only. | |
| est_value_max | No | Maximum estimated value (Market Valuation). Only applied to sources with an estimated value field. | |
| est_value_min | No | Minimum estimated value (Market Valuation). Only applied to sources with an estimated value field. | |
| sale_date_end | No | Filter by sale date end (YYYY-MM-DD). | |
| pre_foreclosure | No | Set true or 1 for scheduled-sale preforeclosures: sale date today or later (UTC), excluding REO-only feeds and REO asset types. Matches the dashboard filter. Listings without a known sale date, including early-stage defaults, are excluded. false or 0 disables the filter (default); other values return 400. A location filter is still required. | |
| sale_date_start | No | Filter by sale date start (YYYY-MM-DD). |