MLS Property Scouting

The MLS data available in Property Search/Detail is updated weekly.

If you need more timely updates, photos, agent comments, and other IDX specific data points, please check out our MLS APIs (require approvals): https://developer.realestateapi.com/reference/realestateapi-mls-dataset-and-apis

MLS Status Searches

"mls_active" Filter

find properties that are currently on the market
this search will be missing any listings that don't have a matching county record (e.g. new construction)

{
  "size": 10,
  "count": false,
  "mls_active": true,
  "state": "VA"
}

"mls_pending" Filter

{
  "size": 10,
  "count": false,
  "mls_pending": true,
  "city": "Houston"
}

Listing Price Searches

The second way to search for MLS properties is by MLS Listing Price. The fields available are:

"mls_listing_price" [int] / "mls_operator" [string]

mls_listing_price & mls_operator must always be used together and do NOT work with other MLS list price fields such as mls_listing_price_min/max

{
  "size": 10,
  "mls_listing_price": 250000,
  "mls_operator": "gte",
  "zip": "22205"
}

"mls_listing_price_min" [int] / "mls_listing_price_max" [int]

if using mls_listing_price_min/max, you should exclude mls_listing_price & mls_operator

{
  "size": 10,
  "ids_only": true,
  "mls_listing_price_min": 250000,
  "mls_listing_price_max": 350000,
  "zip": "22205"
}

Inferring Listing Date from Days on Market Search

{
  "ids_only": true,
  "city": "Richmond", 
  "state": "VA",
  "mls_active": true,
  "mls_days_on_market_min": 30,
  "mls_days_on_market_max": 60
}

then take the current day and use a date math package such as moment.js to calculate the listing date based on the mlsDaysOnMarket value returned for each result

Find Listings with a Reduced Listing Price

{
  "ids_only": true,
  "city": "Richmond", 
  "state": "VA",
  "mls_active": true,
  "price_reduced": true
}

Listing Price to Value Ratio

{
  "ids_only": true,
  "city": "Richmond", 
  "state": "VA",
  "mls_active": true,
  "listing_price_to_value_percent_min": 75,
  "listing_price_to_value_percent_max": 95
}

Getting Agent Info and More Listing Data from Property Detail

Take the Property IDs or addresses from your Property Search result objects above and make an API Call to Property Detail (or Property Detail Bulk).

Inspect the response for the ".mlsHistory" array:

{
	"mlsHistory": [
  	{
        "propertyId": "18871883",
        "type": "single_family",
        "price": "525000",
        "beds": 3,
        "baths": 2.5,
        "daysOnMarket": "30",
        "agentName": "Bryan Goldman",
        "agentOffice": "Keller Williams Realty",
        "agentPhone": "3606933336",
        "status": "active",
        "statusDate": "2022-05-13",
        "seqNo": "1"
      }
    	
  ]
	
}