Retrieve property sale and rental listings in any market in the US.

The /listings endpoints allow you to search for and retrieve active and inactive sale and rental listings in any market in the United States.

“Sale” listings refer to properties listed for sale, while “rental” listings refer to properties listed for rent.

 

Listing Records

Each property listing record contains several fields with information for that specific property:

  • Property attributes: including the property type, number of bedrooms, number of bathrooms, living area size, year built, etc.
  • Listing status: indicating whether the listing is currently active or not
  • Listed price or rent: sale listings will include their listed price, while rental listings will include their listed rent
  • Listing dates: including the original listing date, the date the listing was removed, the date the listing was last seen, and how many days it's been on the market

Below is an example of a listing record returned by our API:

{
  "id": "1702-Cherry-Orchard-Dr,-Austin,-TX-78745",
  "formattedAddress": "1702 Cherry Orchard Dr, Austin, TX 78745",
  "addressLine1": "1702 Cherry Orchard Dr",
  "addressLine2": null,
  "city": "Austin",
  "state": "TX",
  "zipCode": "78745",
  "county": "Travis",
  "latitude": 30.201436,
  "longitude": -97.802849,
  "propertyType": "Single Family",
  "bedrooms": 3,
  "bathrooms": 1,
  "squareFootage": 910,
  "lotSize": 8233,
  "yearBuilt": 1972,
  "status": "Active",
  "price": 385000,
  "listedDate": "2023-02-02T00:00:00.000Z",
  "removedDate": null,
  "createdDate": "2020-09-20T00:00:00.000Z",
  "lastSeenDate": "2023-02-25T00:00:00.000Z",
  "daysOnMarket": 23
}

📘

Both sale and rental listings use the price field to indicate the listed price (for sale listings) or listed rent (for rental listings) of the property.

 

Data Sources and Coverage

Our property listing data is obtained from various public sources, including some of the most popular real estate listing websites.

We continuously update our internal property listing database, and each individual listing is updated at least once per day.

Although we do not retrieve our property listing data directly from the MLS, you should see comparable coverage between your local MLS feeds and our API.

We aim to provide at least 96% sale and rental listing coverage for residential properties in all 50 US states, including single-family, condos, townhomes, manufactured, and 2-4 unit multi-family properties. This includes vacant land parcels.

We also aim to provide at least 90% sale and rental listing coverage for 5+ unit commercial dwellings, including apartment buildings, condo complexes, and other large residential developments. At this time, we do not have property listing coverage for office, retail, industrial, manufacturing, farm or other non-residential commercial properties.

 

Search Queries

Our property listing search endpoints (/listings/sale and /listings/rental/long-term) support retrieving data for a specific address; searching for listings in a city, state or zip code; or searching for them in a particular geographical area.

See this guide for an overview of how to structure your search queries to retrieve the listing data you are looking for.

 

Pagination

Our property listing search endpoints (/listings/sale and /listings/rental/long-term) will return large lists of listings in sets, up to 500 listings at a time, and support pagination.

See this guide for an overview of how to use the limit and offset query parameters to retrieve additional sets of results.

 

Available Endpoints

The following endpoints are available for retrieving sale and rental listings:

  • /listings/sale: An endpoint that allows you to retrieve sale listings matching specific criteria in a given city or state, or in a particular geographical area

  • /listings/sale/{id}: An endpoint that allows you to retrieve a specific sale listing, given its internal id. The id can be retrieved using the /properties, /avm or other /listings endpoints, or cached in your application from prior requests

  • /listings/rental/long-term: An endpoint that allows you to retrieve rental listings matching specific criteria in a given city or state, or in a particular geographical area

  • /listings/rental/long-term/{id}: An endpoint that allows you to retrieve a specific rental listing, given its internal id. The id can be retrieved using the /properties, /avm or other /listings endpoints, or cached in your application from prior requests