---
title: "Scrape Redfin real-estate listings"
method: POST
path: "/realestate/redfin"
tags: ["Plugins"]
---

# Scrape Redfin real-estate listings

`POST /realestate/redfin`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/realestate/redfin`
- Auth: API key in header `x-scrapeunblocker-key`

Searches Redfin for `location` (a city/state or ZIP) and returns the listings as JSON: `price`, `beds`, `baths`, `sqFt`, `lotSize`, address, coordinates, `propertyType`, `mlsStatus`, `mlsId`, `daysOnMarket`, `pricePerSqFt` and a clean `url`. Filter with `status` (for_sale / sold), `min_price`/`max_price`, `beds`, `baths` and `property_type`, sort with `sort`, and collect up to `max_results` across pages. Use `mode=detail` with a listing `url` for one home in full (agents, public records, tax, price history, Redfin Estimate).

## Query parameters

- `mode` string: 'search' (listings for a location) or 'detail' (one home by url).
- `location` string, nullable: City/state or ZIP to search, e.g. 'Austin, TX' or '78704'. Search mode.
- `url` string, nullable: Redfin URL. Required for detail mode (a listing URL); optional in search mode (a city/zip page URL).
- `status` string: Listing status: for_sale, sold.
- `max_results` integer: How many listings to collect across pages (~350 per page).
- `sort` string: Ordering: recommended, newest, price_asc, price_desc, sqft, price_per_sqft.
- `property_type` string, nullable: Property type filter: houses, condos, townhomes, multi_family, land, manufactured, other. Omit for all.
- `min_price` integer, nullable: Minimum price.
- `max_price` integer, nullable: Maximum price.
- `beds` integer, nullable: Minimum bedrooms.
- `baths` integer, nullable: Minimum bathrooms.
- `sold_within_days` integer: For status=sold: look back this many days (default 90).
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Defaults to US.

## Response `200`

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

- unknown

## Other responses

- `400`: Invalid parameters, or the location could not be resolved.
- `422`: Validation Error
- `502`: Blocked by Redfin, no results page returned, or the call did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)