docs / redfin

Redfin

US homes for sale, sold and rentals with history.

base /redfin/v15 endpoints

post/redfin/v1/search2 credits

Listings by location with price/bed/bath/type filters (for sale / recently sold / for rent).

Parameter		Allowed / range	Description
location	required	—	Where to search — city, ZIP or neighborhood ('Austin, TX', '78745').
status = for_sale	optional	for_sale · sold · for_rent	Listing status to search (case-insensitive).
max_results = 100	optional	1–10000	How many listings to return. The engine pages internally — no page/cursor needed.
sold_within_days = 90	optional	1–1825	For status=sold: how far back to look (30/90/180/365 typical).
min_price	optional	0–	Minimum price in USD.
max_price	optional	0–	Maximum price in USD.
min_beds	optional	0–20	Minimum bedrooms.
max_beds	optional	0–20	Maximum bedrooms.
min_baths	optional	0–20	Minimum bathrooms.
property_types	optional	1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 · 13	Only these property types (Redfin type codes — pick from the list).
url	optional	—	Advanced: a Redfin search URL (alternative to location — the region is read from the URL).

Try in playground →

post/redfin/v1/listing_detail3 credits

Full property record: 17-year price & tax history, schools, amenities, agent, photos, description, Redfin Estimate, mortgage, parcel.

Parameter		Allowed / range	Description
property_id	required	—	Redfin property ID — `property_id` from a search result, or the last number in a /home/ URL.
listing_id	optional	—	Advanced: Redfin listing ID (pairs with property_id for the exact active listing).
url	optional	—	Redfin /home/ property URL (alternative to property_id).

Try in playground →

post/redfin/v1/similar2 credits

Comparable/similar listings near a property, with the comp price band.

Parameter		Allowed / range	Description
property_id	required	—	Redfin property ID — `property_id` from a search result, or the last number in a /home/ URL.
listing_id	optional	—	Advanced: Redfin listing ID (pairs with property_id for the exact active listing).
url	optional	—	Redfin /home/ property URL (alternative to property_id).

Try in playground →

post/redfin/v1/autocomplete1 credit

Resolve free text to Redfin places / agents / schools / buildings (ids + types).

Parameter		Allowed / range	Description
query	required	—	Free text: a city, neighborhood, address, school or agent name.

Try in playground →

post/redfin/v1/market_stats2 credits

Derived market snapshot for an area: median list price, $/sqft, days on market, inventory, price band.

Parameter		Allowed / range	Description
location	required	—	The market area — city, ZIP or neighborhood.
url	optional	—	Advanced: a Redfin search URL instead of location.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/redfin/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"location":"Austin, TX","max_results":30}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}