---
title: "Search Redfin properties by region"
method: GET
path: "/redfin/search"
tags: ["Redfin"]
---

# Search Redfin properties by region

`GET /redfin/search`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/redfin/search`
- Auth: API key in header `X-API-KEY`

Returns property listings for a specified region.

## Query parameters

- `region_id` integer, required
- `region_type` integer, required
- `market` string, required
- `min_price` integer, nullable
- `max_price` integer, nullable
- `num_beds` integer, nullable
- `num_baths` number, nullable
- `property_types` string, nullable
- `status` integer, nullable
- `sold_within_days` integer, nullable
- `num_homes` integer, nullable
- `page` integer, nullable

## Response `200`

- object
  - `data` object, required
    - `properties` object[], required
    - `count` integer, required
    - `region_id` integer, required
    - `region_type` integer, required

## Other responses

- `400`: The request contains null bytes or unsupported control characters.
- `401`: Unauthorized - API key is missing or invalid
- `404`: Region not found
- `422`: One or more Redfin request parameters failed validation.
- `500`: The upstream service is temporarily unavailable. Please retry shortly.

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/2f4af6143d10?raw)