Redfin API endpoint
Returns Redfin's aggregate market trends for a region (median list/sale price, sale-to-list, offers, days on market, inventory, year-over-year). Faithful pass-through of Redfin's public aggregate-trends resource.
/redfin/region-trendsMCP tool: redfin_region_trends
Query parameters: region_id is required (a Redfin region id for a neighborhood, ZIP code, county, or city). region_type is optional, defaults to 6 (city), and accepts: 1 (neighborhood), 2 (ZIP code), 5 (county), 6 (city). Any other value is rejected with an invalid-params error rather than forwarded to Redfin.
Returns Redfin's aggregate market trends for the region — a faithful pass-through of Redfin's public aggregate-trends resource. Values are Redfin's display strings (e.g. $1.76M, +14.0%).
| Field | In the sample | Value in the sample |
|---|---|---|
| region_id | Has a value | |
| region_type | Has a value | 6 |
| median_list_price | Has a value | “$1.32M” |
| median_sale_per_sqft | Has a value | “$1.14K” |
| avg_num_offers | Has a value | 3 |
| avg_days_on_market | Has a value | 22 |
| num_homes_on_market | Has a value | 944 |
| yoy_sale_per_sqft | Has a value | “+15.3%” |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| region_id | integer | Yes | Redfin region id for a neighborhood, ZIP code, county, or city | 17151 | |
| region_type | integer | No | 6 | Redfin region type (defaults to 6, city) Allowed values: 1, 2, 5, 6. | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/redfin/region-trends?region_id=17151®ion_type=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"region_id": 17151,
"region_type": 6,
"median_list_price": "$1.29M",
"median_sale_price": "$1.76M",
"median_list_per_sqft": "$943",
"median_sale_per_sqft": "$1.14K",
"median_sale_per_list": "115.5%",
"avg_num_offers": "5",
"avg_down_payment": "35.7%",
"avg_days_on_market": "31",
"num_homes_sold": "568",
"num_homes_on_market": "978",
"yoy_sale_price": "+14.0%",
"yoy_sale_per_sqft": "+12.6%"
}
}Request schema
No body schema
Response schema
#/definitions/redfin.RegionTrendsResponse
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| avg_days_on_market | string | No | Average number of days homes in the region spend on the market, as Redfin displays it. | |||
| avg_down_payment | string | No | Average down payment in the region, as Redfin displays it, for example `35.7%`. | |||
| avg_num_offers | string | No | Average number of offers per sold home in the region, as Redfin displays it. | |||
| median_list_per_sqft | string | No | Median listing price per square foot in the region, as Redfin displays it. | |||
| median_list_price | string | No | $1.29M | Median listing price in the region, as Redfin displays it, for example `$1.29M`. | ||
| median_sale_per_list | string | No | Median ratio of sale price to listing price in the region, as Redfin displays it, for example `115.5%`. | |||
| median_sale_per_sqft | string | No | Median sale price per square foot in the region, as Redfin displays it. | |||
| median_sale_price | string | No | $1.76M | Median sale price in the region, as Redfin displays it, for example `$1.76M`. | ||
| num_homes_on_market | string | No | Number of homes currently on the market in the region, as Redfin displays it. | |||
| num_homes_sold | string | No | Number of homes sold in the region, as Redfin displays it. | |||
| region_id | integer | No | 17151 | Redfin region id the trends are for. | ||
| region_type | integer | No | 6 | Type of region: `1` neighborhood, `2` ZIP code, `5` county or `6` city. | ||
| yoy_sale_per_sqft | string | No | Year-over-year change in sale price per square foot, as Redfin displays it, for example `+12.6%`. | |||
| yoy_sale_price | string | No | Year-over-year change in sale price, as Redfin displays it, for example `+14.0%`. |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/redfin/region-trends?region_id=17151®ion_type=1" \
-H "x-api-key: $CRAWLORA_API_KEY"