Skip to main content
POST
Search Redfin homes for sale or sold
  • Endpoint: redfin.search
  • Returns: data has listings, median.
  • Cost: 1 credit per 20 items, at least 1 credit. Failed calls cost nothing.
  • Paging: Yes. Send the cursor from the response to get the next page. See Paging.

Example

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
location
string
required
Required string length: 2 - 200
status
enum<string>
default:forSale
Available options:
forSale,
sold
soldWithin
enum<string>
default:threeMonths
Available options:
week,
month,
threeMonths,
sixMonths,
year,
twoYears,
threeYears,
fiveYears
sort
enum<string>
default:relevance
Available options:
relevance,
newest,
priceLow,
priceHigh,
sqft,
pricePerSqft
price
object
bedrooms
object
bathrooms
object
homeTypes
enum<string>[]
Minimum array length: 1
Available options:
house,
condo,
townhouse,
multiFamily,
land,
other,
manufactured,
coop
sqft
object
lotSqft
object
yearBuilt
object
daysOnMarket
object
limit
integer
default:40
Required range: 1 <= x <= 350
cursor
string
Pattern: ^\d{1,7}$

Response

The data, and the credits this call used.

success
any
required
data
object
required
creditsUsed
integer
required
requestId
string
required