Sale Listings

get

https://api.rentcast.io/v1/listings/sale

Search for sale listings in a geographical area, or by a specific address.

Query Params

address

string

The full address of the property, in the format Street, City, State, Zip. Used to retrieve data for a specific property, or together with the radius parameter to search for listings in a circular area

city

string

Defaults to Austin

The name of the city, used to search for listings in a specific city. This parameter is case-sensitive

state

string

Defaults to TX

The 2-character state abbreviation, used to search for listings in a specific state. This parameter is case-sensitive

zipCode

string

The 5-digit zip code, used to search for listings in a specific zip code

latitude

float

The latitude of the search area. Use the latitude/longitude and radius parameters to search for listings in a circular area

longitude

float

The longitude of the search area. Use the latitude/longitude and radius parameters to search for listings in a circular area

radius

float

The radius of the search area in miles, with a maximum of 100. Use in combination with the latitude/longitude or address parameters to search for listings in a circular area

propertyType

string

enum

The type of the property, used to search for listings matching this criteria. See explanation of property types. Supports multiple values

Allowed:

bedrooms

string

The number of bedrooms, used to search for listings matching this criteria. Use 0 to indicate a studio layout. Supports numeric ranges and multiple values

bathrooms

string

The number of bathrooms, used to search for listings matching this criteria. Supports fractions to indicate partial bathrooms, numeric ranges and multiple values

squareFootage

string

The total living area size in square feet, used to search for listings matching this criteria. Supports numeric ranges and multiple values

lotSize

string

The total lot size in square feet, used to search for listings matching this criteria. Supports numeric ranges and multiple values

yearBuilt

string

The year of construction, used to search for listings matching this criteria. Supports numeric ranges and multiple values

status

string

enum

Defaults to Active

The current listing status, used to search for listings matching this criteria. See explanation of listing statuses

Allowed:

price

string

The listed price of the property, used to search for listings matching this criteria. Supports numeric ranges and multiple values

daysOld

string

The number of days since a property was listed on the market, with a minimum of 1. Supports numeric ranges

limit

int32

Defaults to 5

The maximum number of listing records to return, between 1 and 500. Defaults to 50 if not provided. Learn more about pagination

offset

int32

The index of the first listing record to return, used to paginate through large lists of results. Defaults to 0 if not provided. Learn more about pagination

includeTotalCount

boolean

When enabled, will return the total number of results matching the current query in the X-Total-Count response header. Defaults to false if not provided

Responses

200Success

401Auth Error