# Redfin (/docs/redfin) Search Redfin homes for sale or recently sold, then read one home with its price history and tax history Redfin lists homes for sale and recently sold homes across the United States. These endpoints search an area and read one home in full with its price history and tax history. Every home uses the canonical `Place` shape, and the listing facts sit in `place.ext.listing`, the same shape Zillow homes use. Base URL: `/v1/redfin/...` Redfin exposes 2 routes here. ## Quickstart ### Search an area Pass a Redfin search link as `url` (a city, ZIP code or neighborhood page), a place name as `location`, a Redfin region as `region_id` with `region_type`, or a map box as `map_bounds`. `limit` sets how many homes come back in the one response. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/redfin/search?url=https%3A%2F%2Fwww.redfin.com%2Fcity%2F30818%2FTX%2FAustin&limit=50" \ -H "x-api-key: YOUR_API_KEY" ``` ### Read one home Pass the home's Redfin link as `url`. It ends in `/home/`. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/redfin/property?url=https%3A%2F%2Fwww.redfin.com%2FTX%2FAustin%2F8023-Acton-Dr-78736%2Fhome%2F31709039" \ -H "x-api-key: YOUR_API_KEY" ``` ## Questions people ask ### Can I get a home's sale history? Yes. `GET /v1/redfin/property` returns `place.ext.listing.price_history` with each event's date, the price where Redfin shows one, what happened (for example Listed or Sold (Public Records)) and its source, back decades through public records. `tax_history` carries the yearly tax and, where it is published, the assessed value. ### How do I find recently sold homes? Search with `status=sold` and set `sold_within_days` to how far back to look. ### Why did my search stop at the limit? One search returns up to `limit` homes. When a search reaches it, narrow the area or the filters to see the rest. ### Is the sort strict? No. `sort` uses Redfin's own order, and on sold homes a few rows can sit out of price order. Sort on your side when you need an exact order. ## All endpoints ## Platform notes **Money is in US dollars and areas are in square feet.** `place.ext.listing.currency` says so on every row. **A place name works alongside a link.** `location` takes a city or ZIP code such as `Austin, TX`; a link or a region id is the most precise way to name an area. ## Next steps - [Zillow](/docs/zillow.md): The same Place and listing shape from Zillow, with rentals. - [Realtor.com](/docs/realtor.md): Homes for sale and for rent from a search link.