Redfin Sold Homes Search
redfin.listings.sold
List the homes sold in a city in the last 30 days to three years, with sold price, sale date, size and year built.
At a glance
- Endpoint ID
redfin.listings.sold- Price
- 5–25 credits per call; failed calls are free
- Runs for up to
- 45 seconds
Request
Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "redfin.listings.sold", "input": { "max_pages": 1, "page": 1, "region_id": 16163, "region_type": 6, "sold_within_days": 90 }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "redfin.listings.sold", "input": { "max_pages": 1, "page": 1, "region_id": 16163, "region_type": 6, "sold_within_days": 90 }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "redfin.listings.sold", "input": { "max_pages": 1, "page": 1, "region_id": 16163, "region_type": 6, "sold_within_days": 90 }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
Input
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
region_id |
integer | yes | Redfin's ID for the city, such as 16163 for Seattle. It is the number in the city's Redfin link: redfin.com/city/16163/WA/Seattle. | 16163 |
max_pages |
integer | no | How many pages to read in this call, up to 10. | 1 |
page |
integer | no | The page of results to start from. | 1 |
region_type |
integer | no | The kind of area. 6 is a city, and the default. | 6 |
sold_within_days |
integer | no | How far back to look, in days: 30, 90, 180, 365, 730 or 1095. The default is 90. | 90 |
Response
A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.
This is results[0].data from a real run:
{ "has_more": true, "next_page": 2, "total_count": 316, "listings": [ { "title": "2717 Franklin Ave E #302", "price": 480000, "address": "2717 Franklin Ave E #302, Seattle, WA 98102", "area_sqft": 732, "baths": 1, "beds": 1, "collected_at": "2026-10-19T18:58:24Z", "currency": "USD", "position": 1, "property_id": "139", "sold_date": "2026-08-05", "status": "Sold", "url": "https://www.redfin.com/WA/Seattle/2717-Franklin-Ave-E-98102/unit-302/home/139", "year_built": 1930 }, { "title": "7064 35th Ave NE #2", "price": 461278, "address": "7064 35th Ave NE #2, Seattle, WA 98115", "area_sqft": 1147, "baths": 2, "beds": 3, "collected_at": "2026-10-19T18:58:24Z", "currency": "USD", "position": 2, "property_id": "2286", "sold_date": "2026-09-23", "status": "Sold", "url": "https://www.redfin.com/WA/Seattle/7064-35th-Ave-NE-98115/unit-2/home/2286", "year_built": 1969 } ]}
Fields
| Field | Type | What it is | Example |
|---|---|---|---|
listings[].address |
string | The home's street address. | 2717 Franklin Ave E #302, Seattle, WA 98102 |
listings[].price |
integer | The sold price, in US dollars. | 480,000 |
listings[].sold_date |
string | The date the home sold. | 2026-08-05 |
listings[].beds |
integer | Bedrooms. | 1 |
listings[].baths |
integer | Bathrooms. | 1 |
listings[].area_sqft |
integer | The home's size, in square feet. | 732 |
listings[].year_built |
integer | The year the home was built. | 1930 |
listings[].title |
string | The listing's headline, usually the street address. | 2717 Franklin Ave E #302 |
listings[].collected_at |
string | When the data was read. | 2026-10-19T18:58:24Z |
listings[].currency |
string | The currency of the prices. | USD |
listings[].position |
integer | The home's place in Redfin's results. | 1 |
listings[].property_id |
string | Redfin's ID for the home. | 139 |
listings[].status |
string | Sold, for every home here. | Sold |
listings[].url |
string | The home's page on Redfin. | https://www.redfin.com/WA/Seattle/2717-Franklin-Ave-E-98102/uni… |
has_more |
boolean | Whether more pages follow. | true |
listings |
array | The homes sold in the window. | 316 records |
next_page |
integer | The page to ask for next. | 2 |
total_count |
integer | How many homes this response holds. | 316 |
If a call fails
A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.
Other Redfin Real Estate endpoints
Something missing or unclear? Ask the team that builds the Redfin Real Estate endpoints.