Skip to content
Last updated

SiftMap filter reference

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:

WhereField
Property searchfilters in the body of POST /properties/search/ (and grid/, add-properties-by-query/)
Saved filterfilter_data.filters on /filters/
Locations of a saved filterfilter_data.addresses on /filters/

Rules that apply to every key

  • 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_results with and without a new key.
  • _min / _max pairs are inclusive. Send one or both.
  • _unknown booleans widen a range. For example beds_min: 3 plus beds_unknown: true returns properties with 3+ bedrooms and properties with no bedroom data.
  • Dates are YYYY-MM-DD strings. Money values are USD numbers; percentages are 0-100.
  • Some list values are strings, not arrays. distressors_include and distressors_exclude are comma-separated strings; zip_codes, cities, neighborhoods and municipalities are JSON-encoded strings. Other list keys (for example extra_mls_status) are real JSON arrays.

A complete example

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).

Property type

Boolean flags; set the types you want to true. Several types combine with OR.

KeyTypeDescription
type_single_familybooleanSingle-family residences.
type_multi_familybooleanMulti-family residential (2-4 units).
type_multi_family_commercialbooleanMulti-family commercial (5+ units).
type_townhousebooleanTownhouses.
type_condobooleanCondominiums.
type_mobile_homebooleanMobile and manufactured homes.
type_landbooleanVacant land.
type_trailer_rv_parksbooleanTrailer and RV parks.
type_warehousebooleanWarehouses.

Value and equity

KeyTypeDescription
value_typestringWhich price value_min / value_max apply to: estimated value, last sold price, or current listing price. Values: est_value, sold, for_sale.
value_minnumberMinimum value in USD (see value_type).
value_maxnumberMaximum value in USD (see value_type).
extra_equity_percent_minnumberMinimum estimated equity percent (0-100).
extra_equity_percent_maxnumberMaximum estimated equity percent.
extra_equity_percent_unknownbooleanAlso include properties whose equity is unknown.
extra_estimated_equity_minnumberMinimum estimated equity in USD.
extra_estimated_equity_maxnumberMaximum estimated equity in USD.
extra_value_minnumberMinimum estimated market value in USD.
extra_value_maxnumberMaximum estimated market value in USD.
extra_assessed_value_minnumberMinimum tax-assessed value in USD.
extra_assessed_value_maxnumberMaximum tax-assessed value in USD.
extra_suggested_rent_minnumberMinimum estimated monthly rent in USD.
extra_suggested_rent_maxnumberMaximum estimated monthly rent in USD.

Building and lot

KeyTypeDescription
beds_minnumberMinimum bedrooms.
beds_maxnumberMaximum bedrooms.
beds_unknownbooleanAlso include properties with unknown bedroom count.
bath_minnumberMinimum bathrooms.
bath_maxnumberMaximum bathrooms.
baths_unknownbooleanAlso include properties with unknown bathroom count.
extra_building_sqft_minnumberMinimum building area (sq ft).
extra_building_sqft_maxnumberMaximum building area (sq ft).
extra_sqft_minnumberMinimum living area (sq ft).
extra_sqft_maxnumberMaximum living area (sq ft).
extra_acres_value_minnumberMinimum lot size in acres.
extra_acres_value_maxnumberMaximum lot size in acres.
extra_year_built_minintegerEarliest year built.
extra_year_built_maxintegerLatest year built.
year_built_minintegerEarliest year built (alias of extra_year_built_min; prefer the extra_ key).
year_built_maxintegerLatest year built (alias of extra_year_built_max; prefer the extra_ key).
extra_units_minintegerMinimum number of units.
extra_units_maxintegerMaximum number of units.
extra_flood_zonebooleanOnly properties in a flood zone.
extra_flood_zone_typearray of stringFEMA flood zone codes, e.g. ["X"].

Owner

KeyTypeDescription
extra_owner_typearray of stringOwner entity type. Values: individual, trust_owned, business.
extra_owner_absenteebooleanOwner does not live at the property.
extra_absentee_in_statebooleanWith extra_owner_absentee: limit to owners who live in the same state.
extra_owner_is_investorbooleanOwner is identified as an investor.
extra_owners_with_multiple_propertiesbooleanOwner owns more than one property.
extra_properties_owned_minintegerMinimum number of properties the owner holds.
extra_properties_owned_maxintegerMaximum number of properties the owner holds.
extra_multiple_ownersbooleanProperty has more than one owner on title.
extra_owner_age_minintegerMinimum owner age.
extra_owner_age_maxintegerMaximum owner age.
extra_years_owned_minnumberMinimum years since the owner acquired the property.
extra_years_owned_maxnumberMaximum years owned.
extra_is_po_boxbooleanOwner mailing address is a PO box.
extra_cash_buyerbooleanOwner bought the property with cash.
has_first_last_namebooleanOwner record has both a first and a last name (filters out entities and incomplete records).
first_name_no_numbersbooleanOwner first name contains no digits.
last_name_no_numbersbooleanOwner last name contains no digits.
has_property_addressbooleanProperty has a deliverable street address.
extra_collapse_by_ownerbooleanReturn one property per owner.
extra_collapse_rank_bystringWith extra_collapse_by_owner: which of the owner's properties to keep. Values: ai_score, distressor_count, equity_percent.

Sale, listing and loans

KeyTypeDescription
extra_mls_statusarray of stringMLS status. Values: not_listed, listed, pending, sold, cancelled.
extra_days_on_marketstringDays on market window, e.g. 30d, 90d, 365d.
extra_mls_listing_price_maxnumberMaximum MLS listing price in USD.
extra_last_sale_date_minstring (date)Last sale on or after this date (YYYY-MM-DD).
extra_last_sale_date_maxstring (date)Last sale on or before this date.
extra_last_sale_date_unknownbooleanAlso include properties with no known sale date.
extra_last_sale_value_minnumberMinimum last sale price in USD.
extra_last_sale_value_maxnumberMaximum last sale price in USD.
extra_last_sale_price_unknownbooleanAlso include properties with no known sale price.
extra_sold_date_minstring (date)MLS sold on or after this date.
extra_sold_date_maxstring (date)MLS sold on or before this date.
extra_is_last_sale_interfamilybooleanLast transfer was between family members.
extra_last_sale_investor_transaction_typearray of stringInvestor transaction type of the last sale. Values: flip, rental, wholesale, wholetail, pending.
extra_private_lenderbooleanFinanced by a private lender.

Foreclosure and distress events

KeyTypeDescription
extra_foreclosure_statusarray of stringForeclosure stage. Values: pre_foreclosure, foreclosure, auction.
extra_foreclosure_notice_typearray of stringRecorded 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_minstring (date)Notice recorded on or after this date.
extra_notice_date_maxstring (date)Notice recorded on or before this date.
extra_auction_date_minstring (date)Auction on or after this date.
extra_auction_date_maxstring (date)Auction on or before this date.
extra_last_obituary_date_minstring (date)Owner obituary published on or after this date.
extra_last_obituary_date_maxstring (date)Owner obituary published on or before this date.
extra_vacantbooleanProperty is flagged vacant.
extra_document_typearray of stringRecorded document type codes.

Distressors

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.

KeyTypeDescription
distressors_methodstringcustom: you choose the distressors in distressors_include. stacked: the app's stacked-list mode, used with the same keys. Values: custom, stacked.
distressors_includestringComma-separated distressor codes, e.g. is_vacant_property,is_probate_properties.
distressors_include_min_matchintegerMinimum number of the included distressors a property must have.
distressors_excludestringComma-separated distressor codes to exclude.

Distressor codes:

CodeCodeCode
is_senior_homeownersis_recent_deliquentis_vacant_property
is_lis_pendensis_notice_of_defaultis_notice_of_foreclosure
is_probate_propertiesis_pre_probateis_low_income
is_final_judgmentis_bad_creditis_court_order
is_other_lienis_inheritance_propertyis_judgment_liens
is_estate_salesis_bankruptcy_propertyis_hoa_lien
is_state_taxis_federal_lienis_divorce_property
is_evictionis_criminal_felonyis_obituary_property
is_short_term_loanis_tired_landlordis_heirs_property
is_free_and_clearis_oos_ownersis_absentee_owners
is_high_equityis_zombie_property

Codes are spelled exactly as listed, including is_recent_deliquent.

Lead scores

KeyTypeDescription
investor_off_market_score_minnumberMinimum AI off-market investor score (0-100). Requires the AI score add-on for the county.
investor_off_market_score_maxnumberMaximum AI off-market investor score.
investor_on_market_score_minnumberMinimum on-market investor score.
investor_on_market_score_maxnumberMaximum on-market investor score.
realtor_score_minnumberMinimum realtor score.
realtor_score_maxnumberMaximum realtor score.

Presets

One-click presets that mirror the app's quick filters. Set to true.

KeyPreset
preset_absentee_ownersAbsentee owners
preset_owner_occupiedOwner occupied
preset_free_clearFree clear
preset_high_equityHigh equity
preset_low_equityLow equity
preset_negative_equityNegative equity
preset_vacantVacant
preset_landLand
preset_deceasedDeceased
preset_foreclosureForeclosure
preset_pre_foreclosurePre foreclosure
preset_auctionAuction
preset_tax_lienTax lien
preset_judgmentJudgment
preset_cash_buyerCash buyer
preset_quick_resaleQuick resale
preset_adjustable_loansAdjustable loans
preset_assumable_loanAssumable loan
preset_private_lenderPrivate lender
preset_bank_owned_reoBank owned reo
preset_intra_family_transferIntra family transfer
preset_zombieZombie

Location refinements

Narrow the area chosen in addresses. The list values are a JSON-encoded string (for example "[\"33610, FL\"]"), paired with a _mode key.

KeyTypeDescription
zip_codesstringJSON-encoded list of "ZIP, ST" strings.
zip_codes_modestringInclude or exclude the listed ZIP codes. Values: include, exclude.
citiesstringJSON-encoded list of "City, ST" strings.
cities_modestringValues: include, exclude.
neighborhoodsstringJSON-encoded list of "Neighborhood, ST" strings.
neighborhoods_modestringValues: include, exclude.
has_neighborhoodbooleanOnly properties with a known neighborhood.
municipalitiesstringJSON-encoded list of "Municipality, ST" strings.
municipalities_modestringValues: include, exclude.

In my account

Compare nationwide results with the records already in your DataSift account.

KeyTypeDescription
in_my_account_modestringnot_in: only properties not yet in your account. in: only properties already in it. Values: in, not_in.
in_my_account_tags_includearray of stringTag UUIDs from your account records that a property must have.
in_my_account_tags_excludearray of stringTag UUIDs the account record must not have.
in_my_account_lists_includearray of stringList UUIDs the account record must be on.
in_my_account_lists_excludearray of stringList UUIDs the account record must not be on.
in_my_account_property_status_includearray of stringStatus slugs, e.g. new_lead, under_contract, closed.
in_my_account_property_status_excludearray of stringStatus slugs to exclude.

Search locations

In a property search, addresses is a list of locations. Each needs type and search:

typesearchAlso send
stateTwo-letter code: OH
countyCounty name without "County": Franklinstate
cityCity name: Tampastate
zipFive-digit ZIP: 33610
addressA 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 filter locations

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"}]}
searchTypeExtra fields
statestate, title ("Wisconsin, USA")
countycounty, counties (FIPS)
citymunicipality, counties
zipzip, 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}/.

Tips for agents and integrations

  1. Start from a working filter: build it in SiftMap, then GET /filters/{id}/ and reuse its filter_data.
  2. Validate every key name against this page before sending; unknown keys are not errors.
  3. Check total_results with size: 1 before paging through results or enabling auto-add.
  4. Before adding properties to your account, call the matching quote/ endpoint to see how many are new and billable.