MLS Search API

Enable "count" mode to only receive the number of results ("resultCount") matching your input payload, not the actual listing records. Default: false

Specify the number of results you'd like returned in your MLS Search API Call. Values of 1-250 accepted for record pulling mode (default). Values of 1-10,000 accepted for "ids_only": true mode.

"resultIndex" is your pagination parameter for MLS Search API. Each API call will a resultIndex value in the response you can use to fetch subsequent pages by adding it and its value in the input of the next request with the same query as before.

return a list of all the listing IDs, with which you can hit MLS Detail (or MLS Detail Bulk) with to get additional info (max of 10,000 listing IDs per request)

Receive an array of RealEstateAPI unique "ID"s to assist with calling Property Detail or Property Detail Bulk API as your Step 2 to get public record data for your listing. Max size with ids_only mode is 10,000

return full list of photos for each MLS Search response object, without having to call MLS Detail for each

use along with "active": true to eliminate closed listings still showing as active issue

"id" + "radius" will allow you to do a search radius search around a given property through it's RealEstateAPI ID

Find a single listing by it's official MLS Number. Check here for a code sample: https://developer.realestateapi.com/reference/mls-number-search

"address" can be used instead of "latitude"/"longitude" for search radius searches. Another use is to find any listing record matching for a specific address across different statuses (a previously sold, current active, etc.)

Filter for listings on a specific street - works best when combined with "city", "zip", "state", "county"

Filter for listings in a specific city - required dependency is "state" field

Accepts the 2 Character State Code, ALL CAPS. Filter for listings in a specific state - or combine with "county", "city" or "street" to narrow your search.

Filter for listings in a specific zip code or an array of zip codes

Accepts a single "string" value or array of "string" values. MLS Board Codes for searching by specific boards can be provided by our team.

Required dependency fields: "longitude", "radius"

Required dependency fields: "latitude", "radius"

Use along with "latitude"/"longitude" to perform a search radius search around a specific location point with your other MLS Search filters applied. Values between 1-100 miles are accepted.

Check possible values here: https://developer.realestateapi.com/reference/listing-property-type

Check possible values: https://developer.realestateapi.com/reference/property-sub-types

SFR, MFR, LAND, CONDO, MOBILE, OTHER (from Public Record property types)

Filter for listings with a status of "Active"

Filter for listings with a status of "Cancelled"

Filter for listings with a status of "Failed"

Filter for only pending listings

Please use "sold_date_min"/"sold_date_max" instead

Only return listings that have photos

A true/false flag that indicates whether the listed property has a pool

A true/false flag that indicates whether the listed property has a basement structure

A true/false flag that indicates whether the listed property has a view of a city landscape

A true/false flag that indicates whether the listed property has a view of a mountain

A true/false flag that indicates whether the listed property has a view of a public park

A true/false flag that indicates whether the listed property has a view of a pond, lake, river, or other body of water

A true/false flag that indicates whether the listed property has direct access to a body of water

Filter by the statuses of your choice: https://developer.realestateapi.com/reference/current-status-searches

See examples of how to call for listings by listing agent email: https://developer.realestateapi.com/reference/search-for-agent-listings-by-email

See examples of how to call for listings by selling agent email: https://developer.realestateapi.com/reference/search-for-agent-listings-by-email

Exact value bathroom count search param. Do NOT use along with "bathrooms_min"/"bathrooms_max"

Use along with "bathrooms_max" to search for listings with a range of bathrooms falling between your min & max

Use along with "bathrooms_min" to search for listings with a range of bathrooms falling between your min & max

Exact value bedroom count search param. Do NOT use along with "bedrooms_min"/"bedrooms_max"

Use along with "bedrooms_max" to search for listings with a range of bedrooms falling between your min & max

Use along with "bedrooms_min" to search for listings with a range of bathrooms falling between your min & max

Use along with "days_on_market_max" to search for listings with that have been on-market for the number of days falling between your min & max

Use along with "days_on_market_min" to search for listings with that have been on-market for the number of days falling between your min & max

Use along with "listing_price_max" to search for listings with a current listing price range between your min & max

Use along with "listing_price_min" to search for listings with a current listing price range between your min & max

Exact value living square feet search param. Do NOT use along with "living_area_min"/"living_area_max"

Use along with "living_area_max" to search for listings with a living square footage between your min & max

Use along with "living_area_min" to search for listings with a living square footage between your min & max

Exact value lot square feet search param. Do NOT use along with "lot_size_min"/"lot_size_max"

Use along with "lot_size_max" to search for listings with a lot square footage between your min & max

Use along with "lot_size_min" to search for listings with a lot square footage between your min & max

Exact value sold price search param.

Exact value stories count search param.

Exact value year built search param. Useful for getting new construction - year_built: <current-year-value>. Do NOT use along with "year_built_min"/"year_built_max"

Use along with "year_built_max" to search for listings with built in the years between your min & max

Use along with "year_built_min" to search for listings with built in the years between your min & max

Check examples here: https://developer.realestateapi.com/reference/listing-status-change-date-searches

YYYY-MM-DD date format

YYYY-MM-DD date format

Filter for any listing changes with the modification timestamp search: https://developer.realestateapi.com/reference/listing-detail-update-searches

Check examples here: https://developer.realestateapi.com/reference/listing-price-change-date-searches

Check code sample here: https://developer.realestateapi.com/reference/sold-date-searches

Filters against the public record data field: "absentee_owner" (bool)

Filters against the County Tax Recorder data field that indicates the deed type of the current owner's mortgage.

Filters against the public record deed type code corresponding with the corresponding mortgage document type descriptor: https://developer.realestateapi.com/reference/document-type-codes

Filters against the County Assessor's classification for the listing parcel's land use. Common values include "Residential" and "Commercial"

Accepts an integer or array of integers of the valid County Assessor classifications for property use that can be found here: https://developer.realestateapi.com/reference/property-use-codes-reference

Unique identifier for the MLS listing

Alternative identifier for the listing

Timestamp of when the listing was last modified