# Redfin Open Houses

<p>List homes for sale that have an upcoming open house. Every row includes the open house start, end and label (for example "OPEN SUN, 1PM TO 3PM") next to the usual listing fields. Redfin cannot filter open houses itself, so Scrappa checks the 350 top-ranked listings of the region and returns only the rows with an open house, sorted by start time. The response states how many listings were checked, how many open houses were found and whether another page exists.</p><p><strong>Cost:</strong> 1 credit per successful request. Failed requests are not charged.</p>

- **Documentation:** [https://scrappa.co/docs/redfin-api/redfin_open_houses](https://scrappa.co/docs/redfin-api/redfin_open_houses)
- **API group:** Redfin API
- **Endpoint:** `GET https://scrappa.co/api/redfin/open-houses`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `region_id` | string | Yes | <p>Region identifier from /api/redfin/locations (for example 16163 for Seattle).</p> |
| `region_type` | string | Yes | <p>Region type: 1=neighborhood, 2=ZIP, 5=county, 6=city.</p> |
| `market` | string | Yes | <p>Market identifier from /api/redfin/locations (for example seattle, socal, dc, nyc).</p> |
| `num_homes` | string | No | <p>Homes per page (1-100). Default 20.</p> |
| `page` | string | No | <p>Page number. Default 1.</p> |

## Example response

```json
{
    "page": 1,
    "count": 1,
    "has_more": true,
    "properties": [
        {
            "price": 950000,
            "address": "123 Main St",
            "open_house": {
                "end": "2026-11-01T22:00:00+00:00",
                "label": "OPEN SUN, 1PM TO 3PM",
                "start": "2026-11-01T20:00:00+00:00",
                "start_label": "Nov 1, 1:00PM"
            },
            "property_id": 1
        }
    ],
    "listings_checked": 350,
    "total_open_houses": 97
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 400 | Invalid characters in parameter | The request contains null bytes or unsupported control characters. |
| 422 | The request validation failed | One or more Redfin request parameters failed validation. |
| 404 | Region not found | Region not found |
| 500 | Failed to fetch data from Redfin after multiple attempts. | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)