Skip to main content
Scrape Redfin real-estate listings

Authorizations

x-scrapeunblocker-key
string
header
required

Your ScrapeUnblocker API key. Apply on every request.

Query Parameters

mode
string
default:search

'search' (listings for a location) or 'detail' (one home by url).

location
string | null

City/state or ZIP to search, e.g. 'Austin, TX' or '78704'. Search mode.

url
string | null

Redfin URL. Required for detail mode (a listing URL); optional in search mode (a city/zip page URL).

status
string
default:for_sale

Listing status: for_sale, sold.

max_results
integer
default:350

How many listings to collect across pages (~350 per page).

Required range: 1 <= x <= 1750
sort
string
default:recommended

Ordering: recommended, newest, price_asc, price_desc, sqft, price_per_sqft.

property_type
string | null

Property type filter: houses, condos, townhomes, multi_family, land, manufactured, other. Omit for all.

min_price
integer | null

Minimum price.

Required range: x >= 0
max_price
integer | null

Maximum price.

Required range: x >= 0
beds
integer | null

Minimum bedrooms.

Required range: x >= 0
baths
integer | null

Minimum bathrooms.

Required range: x >= 0
sold_within_days
integer
default:90

For status=sold: look back this many days (default 90).

Required range: 1 <= x <= 1825
proxy_country
string | null

Exit-IP country (ISO-2). Defaults to a US exit for Redfin.

Response

JSON with a homes array plus region and totals (search), or a home object (detail).