Main List Fields

Parameter name: the field’s name

A main list field may be specified either by its field ID or by its display value with any white space removed. So, if “Begin Date” is that field’s label, a listing’s begin date may be specified by either &begin_date= or &BeginDate=.

Common field IDs include the following: list_price, house_nbr, streetdirprefix, streetaddress, streetsuffix, streetdirsuffix, city, state, zip, total_sqft, yr_built, total_br, total_bath . Not all MLSs use all of these fields, but they should be relatively common across all MLSs and property types. Some example exceptions include bathrooms and bedrooms for commercial or land property types.

Date queries are specified with dates in the form of MM/DD/YYYY. If a date range is desired, the start and end of the range should be separated by a comma; for example, &BeginDate=01/01/2011,12/31/2011 . If only one date is supplied, the search will return results that match that single date.

Example Date Parameter Description
&BeginDate=01/01/2009 a begin date of exactly 01/01/2009
&BeginDate=01/01/2009,06/01/2009 a begin date range from 01/01/2009 to 06/01/2009

Text field queries are specified by the parameter followed by a string, like the following: &streetaddress=Broadway

The characters #.{}|^~[]`+?& should be omitted from the display value.

List items are specified by the values (not the display values) of the scroll fields. Multiple list items should be comma-delimited. For example: &City=Fargo,Moorhead

Numeric field queries may be specified as a single value, as a range, or as upper and lower ranges:

Example Numeric Field Parameter Description
&TotalBathrooms=5 exactly 5 bathrooms
&TotalBathrooms=3,5 a range of 3 to 5 bathrooms
&TotalBathrooms=>3 at least three bathrooms
&TotalBathrooms=<3 at least one, but no more than three