Skip to main content
POST /v1/data/redfin/listings/run Pricing: $0.002 per listing ($2.00 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
required
City, ZIP code or neighborhood to search, e.g. Austin, TX or 78704.
string
default:"forSale"
Which listings to return: homes for sale, or homes sold in the last 3 months. Defaults to for sale. For rentals use the Redfin Rentals API.Allowed values: forSale (For sale), sold (Sold (last 3 months)).
integer
Lowest price in dollars, e.g. 300000.Min 0.
integer
Highest price in dollars, e.g. 750000.Min 0.
integer
Minimum number of bedrooms, e.g. 3.Min 0; max 10.
string[]
Only these home types. Leave empty for all types.Allowed values: house (House), condo (Condo), townhouse (Townhouse), multifamily (Multi-family), land (Land), manufactured (Manufactured), co-op (Co-op), other (Other).
integer
default:"100"
How many listings to return in total. Defaults to 100; use 0 for all.

Example

Response fields

Each row in data is one listing, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For rentals use redfin/rentals; for Zillow listings use zillow/listings; for Realtor.com use realtor/listings.