↑ ↓ to move ↵ to open
Redfin Real Estate API reference

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
POST /execute
Run an endpoint
MCP tool when pinned
redfin__listings__sold
Pin tools
OpenAPI
openapi.json
Download

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  }}'

Input

FieldTypeRequiredWhat it doesExample
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:

results[0].data
{  "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

FieldTypeWhat it isExample
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.