A SiftMap filter definition (filter_data) describes which properties a search returns and which properties a saved filter feeds into your account. This page lists every criteria key in use, with its type and allowed values. It is derived from the filters customers have saved in SiftMap.
The same criteria object is used in three places:
| Where | Field |
|---|---|
| Property search | filters in the body of POST /properties/search/ (and grid/, add-properties-by-query/) |
| Saved filter | filter_data.filters on /filters/ |
| Locations of a saved filter | filter_data.addresses on /filters/ |
- All keys are optional and combine with AND. A property must match every key you send.
- Unknown keys are ignored, not rejected. A misspelled key silently widens your search. Check spelling against this page, and compare
total_resultswith and without a new key. _min/_maxpairs are inclusive. Send one or both._unknownbooleans widen a range. For examplebeds_min: 3plusbeds_unknown: truereturns properties with 3+ bedrooms and properties with no bedroom data.- Dates are
YYYY-MM-DDstrings. Money values are USD numbers; percentages are 0-100. - Some list values are strings, not arrays.
distressors_includeanddistressors_excludeare comma-separated strings;zip_codes,cities,neighborhoodsandmunicipalitiesare JSON-encoded strings. Other list keys (for exampleextra_mls_status) are real JSON arrays.
Single-family, off-market, valued up to $700,000, built 1940-2010, with at least one of two distress signals, in Franklin County, OH:
{
"addresses": [{"type": "county", "search": "Franklin", "state": "OH"}],
"filters": {
"type_single_family": true,
"value_type": "est_value",
"value_min": 1,
"value_max": 700000,
"extra_year_built_min": 1940,
"extra_year_built_max": 2010,
"extra_mls_status": ["not_listed"],
"distressors_method": "custom",
"distressors_include": "is_vacant_property,is_probate_properties",
"distressors_include_min_match": 1
},
"size": 25,
"result_index": 0
}Send it to POST https://map.reisift.io/properties/search/. To save it as a filter, put the same filters object in filter_data.filters (see Saved filter locations for addresses).
Boolean flags; set the types you want to true. Several types combine with OR.
| Key | Type | Description |
|---|---|---|
type_single_family | boolean | Single-family residences. |
type_multi_family | boolean | Multi-family residential (2-4 units). |
type_multi_family_commercial | boolean | Multi-family commercial (5+ units). |
type_townhouse | boolean | Townhouses. |
type_condo | boolean | Condominiums. |
type_mobile_home | boolean | Mobile and manufactured homes. |
type_land | boolean | Vacant land. |
type_trailer_rv_parks | boolean | Trailer and RV parks. |
type_warehouse | boolean | Warehouses. |
| Key | Type | Description |
|---|---|---|
value_type | string | Which price value_min / value_max apply to: estimated value, last sold price, or current listing price. Values: est_value, sold, for_sale. |
value_min | number | Minimum value in USD (see value_type). |
value_max | number | Maximum value in USD (see value_type). |
extra_equity_percent_min | number | Minimum estimated equity percent (0-100). |
extra_equity_percent_max | number | Maximum estimated equity percent. |
extra_equity_percent_unknown | boolean | Also include properties whose equity is unknown. |
extra_estimated_equity_min | number | Minimum estimated equity in USD. |
extra_estimated_equity_max | number | Maximum estimated equity in USD. |
extra_value_min | number | Minimum estimated market value in USD. |
extra_value_max | number | Maximum estimated market value in USD. |
extra_assessed_value_min | number | Minimum tax-assessed value in USD. |
extra_assessed_value_max | number | Maximum tax-assessed value in USD. |
extra_suggested_rent_min | number | Minimum estimated monthly rent in USD. |
extra_suggested_rent_max | number | Maximum estimated monthly rent in USD. |
| Key | Type | Description |
|---|---|---|
beds_min | number | Minimum bedrooms. |
beds_max | number | Maximum bedrooms. |
beds_unknown | boolean | Also include properties with unknown bedroom count. |
bath_min | number | Minimum bathrooms. |
bath_max | number | Maximum bathrooms. |
baths_unknown | boolean | Also include properties with unknown bathroom count. |
extra_building_sqft_min | number | Minimum building area (sq ft). |
extra_building_sqft_max | number | Maximum building area (sq ft). |
extra_sqft_min | number | Minimum living area (sq ft). |
extra_sqft_max | number | Maximum living area (sq ft). |
extra_acres_value_min | number | Minimum lot size in acres. |
extra_acres_value_max | number | Maximum lot size in acres. |
extra_year_built_min | integer | Earliest year built. |
extra_year_built_max | integer | Latest year built. |
year_built_min | integer | Earliest year built (alias of extra_year_built_min; prefer the extra_ key). |
year_built_max | integer | Latest year built (alias of extra_year_built_max; prefer the extra_ key). |
extra_units_min | integer | Minimum number of units. |
extra_units_max | integer | Maximum number of units. |
extra_flood_zone | boolean | Only properties in a flood zone. |
extra_flood_zone_type | array of string | FEMA flood zone codes, e.g. ["X"]. |
| Key | Type | Description |
|---|---|---|
extra_owner_type | array of string | Owner entity type. Values: individual, trust_owned, business. |
extra_owner_absentee | boolean | Owner does not live at the property. |
extra_absentee_in_state | boolean | With extra_owner_absentee: limit to owners who live in the same state. |
extra_owner_is_investor | boolean | Owner is identified as an investor. |
extra_owners_with_multiple_properties | boolean | Owner owns more than one property. |
extra_properties_owned_min | integer | Minimum number of properties the owner holds. |
extra_properties_owned_max | integer | Maximum number of properties the owner holds. |
extra_multiple_owners | boolean | Property has more than one owner on title. |
extra_owner_age_min | integer | Minimum owner age. |
extra_owner_age_max | integer | Maximum owner age. |
extra_years_owned_min | number | Minimum years since the owner acquired the property. |
extra_years_owned_max | number | Maximum years owned. |
extra_is_po_box | boolean | Owner mailing address is a PO box. |
extra_cash_buyer | boolean | Owner bought the property with cash. |
has_first_last_name | boolean | Owner record has both a first and a last name (filters out entities and incomplete records). |
first_name_no_numbers | boolean | Owner first name contains no digits. |
last_name_no_numbers | boolean | Owner last name contains no digits. |
has_property_address | boolean | Property has a deliverable street address. |
extra_collapse_by_owner | boolean | Return one property per owner. |
extra_collapse_rank_by | string | With extra_collapse_by_owner: which of the owner's properties to keep. Values: ai_score, distressor_count, equity_percent. |
| Key | Type | Description |
|---|---|---|
extra_mls_status | array of string | MLS status. Values: not_listed, listed, pending, sold, cancelled. |
extra_days_on_market | string | Days on market window, e.g. 30d, 90d, 365d. |
extra_mls_listing_price_max | number | Maximum MLS listing price in USD. |
extra_last_sale_date_min | string (date) | Last sale on or after this date (YYYY-MM-DD). |
extra_last_sale_date_max | string (date) | Last sale on or before this date. |
extra_last_sale_date_unknown | boolean | Also include properties with no known sale date. |
extra_last_sale_value_min | number | Minimum last sale price in USD. |
extra_last_sale_value_max | number | Maximum last sale price in USD. |
extra_last_sale_price_unknown | boolean | Also include properties with no known sale price. |
extra_sold_date_min | string (date) | MLS sold on or after this date. |
extra_sold_date_max | string (date) | MLS sold on or before this date. |
extra_is_last_sale_interfamily | boolean | Last transfer was between family members. |
extra_last_sale_investor_transaction_type | array of string | Investor transaction type of the last sale. Values: flip, rental, wholesale, wholetail, pending. |
extra_private_lender | boolean | Financed by a private lender. |
| Key | Type | Description |
|---|---|---|
extra_foreclosure_status | array of string | Foreclosure stage. Values: pre_foreclosure, foreclosure, auction. |
extra_foreclosure_notice_type | array of string | Recorded notice type: LP lis pendens, ND notice of default, NF notice of foreclosure, NS notice of sale, NT notice of trustee sale, FJ final judgment, CO court order. Values: LP, ND, NF, NS, NT, FJ, CO. |
extra_notice_date_min | string (date) | Notice recorded on or after this date. |
extra_notice_date_max | string (date) | Notice recorded on or before this date. |
extra_auction_date_min | string (date) | Auction on or after this date. |
extra_auction_date_max | string (date) | Auction on or before this date. |
extra_last_obituary_date_min | string (date) | Owner obituary published on or after this date. |
extra_last_obituary_date_max | string (date) | Owner obituary published on or before this date. |
extra_vacant | boolean | Property is flagged vacant. |
extra_document_type | array of string | Recorded document type codes. |
Distressors are data signals attached to a property. Pick them with distressors_include / distressors_exclude (comma-separated string, not an array) and set how many must match.
| Key | Type | Description |
|---|---|---|
distressors_method | string | custom: you choose the distressors in distressors_include. stacked: the app's stacked-list mode, used with the same keys. Values: custom, stacked. |
distressors_include | string | Comma-separated distressor codes, e.g. is_vacant_property,is_probate_properties. |
distressors_include_min_match | integer | Minimum number of the included distressors a property must have. |
distressors_exclude | string | Comma-separated distressor codes to exclude. |
Distressor codes:
| Code | Code | Code |
|---|---|---|
is_senior_homeowners | is_recent_deliquent | is_vacant_property |
is_lis_pendens | is_notice_of_default | is_notice_of_foreclosure |
is_probate_properties | is_pre_probate | is_low_income |
is_final_judgment | is_bad_credit | is_court_order |
is_other_lien | is_inheritance_property | is_judgment_liens |
is_estate_sales | is_bankruptcy_property | is_hoa_lien |
is_state_tax | is_federal_lien | is_divorce_property |
is_eviction | is_criminal_felony | is_obituary_property |
is_short_term_loan | is_tired_landlord | is_heirs_property |
is_free_and_clear | is_oos_owners | is_absentee_owners |
is_high_equity | is_zombie_property |
Codes are spelled exactly as listed, including is_recent_deliquent.
| Key | Type | Description |
|---|---|---|
investor_off_market_score_min | number | Minimum AI off-market investor score (0-100). Requires the AI score add-on for the county. |
investor_off_market_score_max | number | Maximum AI off-market investor score. |
investor_on_market_score_min | number | Minimum on-market investor score. |
investor_on_market_score_max | number | Maximum on-market investor score. |
realtor_score_min | number | Minimum realtor score. |
realtor_score_max | number | Maximum realtor score. |
One-click presets that mirror the app's quick filters. Set to true.
| Key | Preset |
|---|---|
preset_absentee_owners | Absentee owners |
preset_owner_occupied | Owner occupied |
preset_free_clear | Free clear |
preset_high_equity | High equity |
preset_low_equity | Low equity |
preset_negative_equity | Negative equity |
preset_vacant | Vacant |
preset_land | Land |
preset_deceased | Deceased |
preset_foreclosure | Foreclosure |
preset_pre_foreclosure | Pre foreclosure |
preset_auction | Auction |
preset_tax_lien | Tax lien |
preset_judgment | Judgment |
preset_cash_buyer | Cash buyer |
preset_quick_resale | Quick resale |
preset_adjustable_loans | Adjustable loans |
preset_assumable_loan | Assumable loan |
preset_private_lender | Private lender |
preset_bank_owned_reo | Bank owned reo |
preset_intra_family_transfer | Intra family transfer |
preset_zombie | Zombie |
Narrow the area chosen in addresses. The list values are a JSON-encoded string (for example "[\"33610, FL\"]"), paired with a _mode key.
| Key | Type | Description |
|---|---|---|
zip_codes | string | JSON-encoded list of "ZIP, ST" strings. |
zip_codes_mode | string | Include or exclude the listed ZIP codes. Values: include, exclude. |
cities | string | JSON-encoded list of "City, ST" strings. |
cities_mode | string | Values: include, exclude. |
neighborhoods | string | JSON-encoded list of "Neighborhood, ST" strings. |
neighborhoods_mode | string | Values: include, exclude. |
has_neighborhood | boolean | Only properties with a known neighborhood. |
municipalities | string | JSON-encoded list of "Municipality, ST" strings. |
municipalities_mode | string | Values: include, exclude. |
Compare nationwide results with the records already in your DataSift account.
| Key | Type | Description |
|---|---|---|
in_my_account_mode | string | not_in: only properties not yet in your account. in: only properties already in it. Values: in, not_in. |
in_my_account_tags_include | array of string | Tag UUIDs from your account records that a property must have. |
in_my_account_tags_exclude | array of string | Tag UUIDs the account record must not have. |
in_my_account_lists_include | array of string | List UUIDs the account record must be on. |
in_my_account_lists_exclude | array of string | List UUIDs the account record must not be on. |
in_my_account_property_status_include | array of string | Status slugs, e.g. new_lead, under_contract, closed. |
in_my_account_property_status_exclude | array of string | Status slugs to exclude. |
In a property search, addresses is a list of locations. Each needs type and search:
type | search | Also send |
|---|---|---|
state | Two-letter code: OH | |
county | County name without "County": Franklin | state |
city | City name: Tampa | state |
zip | Five-digit ZIP: 33610 | |
address | A street address |
Or search a map area with polygon: a closed ring of {"lat": ..., "lon": ...} points (repeat the first point at the end).
{"polygon": [{"lat": 39.95, "lon": -83.00}, {"lat": 39.95, "lon": -82.98}, {"lat": 39.97, "lon": -82.98}, {"lat": 39.97, "lon": -83.00}, {"lat": 39.95, "lon": -83.00}],
"filters": {"type_single_family": true}, "size": 25}Saved filters store locations in the richer format produced by the app's location picker. When you create a filter through the API, use this shape:
{"searchType": "county", "state": "OH", "title": "Franklin County, OH", "value": "Franklin County, OH",
"county": "Franklin", "counties": [{"fips": "39049", "county_name": "Franklin"}]}searchType | Extra fields |
|---|---|
state | state, title ("Wisconsin, USA") |
county | county, counties (FIPS) |
city | municipality, counties |
zip | zip, counties |
The easiest way to get a valid location object is to build one filter in the app and read it back with GET /filters/{id}/.
- Start from a working filter: build it in SiftMap, then
GET /filters/{id}/and reuse itsfilter_data. - Validate every key name against this page before sending; unknown keys are not errors.
- Check
total_resultswithsize: 1before paging through results or enabling auto-add. - Before adding properties to your account, call the matching
quote/endpoint to see how many are new and billable.