# Real-Time Redfin Data - U.S. & Canada Real-Estate Data from Redfin

> Fast and reliable real-estate data API for the U.S. and Canada - search properties by address, coordinates, or polygon, full property details, market trends, and more from Redfin in real-time.

## Overview

Real-Time Redfin Data is a fast and reliable real-estate data API for the U.S. and Canada, sourced from Redfin in real-time. It returns property listings, details, and market trends as structured JSON via REST.

Who is this API for: developers building real-estate search portals, investment and market-analysis tools, and valuation pipelines.

What it returns: property search (by query, coordinates, or polygon), full property details, and market trends.

Need help integrating? Contact support@openwebninja.com.
For high volume / large scale plans, please contact support@openwebninja.com.

## Endpoints

### GET /search - Search
Search Redfin property listings by location (5-digit US zip code, Canadian postal-code area, or a Redfin URL).
Parameters:
- **location** (string, required): The location to search. Accepts a 5-digit US zip code (e.g., `90210`), a Canadian postal-code area, or a full Redfin region URL (e.g., `https://www.redfin.com/city/30749/NY/New-York` or `https://www.redfin.com/zipcode/90210`).
- status (string, default: `for_sale`, allowed: for_sale | sold | for_rent | coming_soon): Listing status to filter by. Allowed values: `for_sale`, `sold`, `for_rent`, `coming_soon`.
- property_types (string): Comma-separated list of property types to filter by. Allowed values: `HOUSE`, `CONDO`, `TOWNHOUSE`, `MULTI_FAMILY`, `LAND`, `OTHER`, `MANUFACTURED`, `CO_OP`.
- sort (string, default: `redfin_recommended`, allowed: redfin_recommended | newest | oldest | price_low_high | price_high_low | beds | baths | sqft | lot_size): Sort order for the results.
- page (integer, default: `1`): Page number for pagination. Allowed values: `1` to `100`.
- num_homes (integer, default: `40`): Number of homes to return per page. Allowed values: `1` to `350`.
- country_code (string, default: `US`, allowed: US | CA): Country code to scope the search. Use `US` for redfin.com or `CA` for redfin.ca.
- min_price (number): Minimum listing price filter.
- max_price (number): Maximum listing price filter.
- min_beds (integer): Minimum number of bedrooms.
- max_beds (integer): Maximum number of bedrooms.
- min_baths (number): Minimum number of bathrooms (supports half-baths, e.g., `2.5`).
- min_sqft (integer): Minimum interior square footage.
- max_sqft (integer): Maximum interior square footage.
- min_lot_size (integer): Minimum lot size in square feet.
- max_lot_size (integer): Maximum lot size in square feet.
- min_year_built (integer): Minimum year built.
- max_year_built (integer): Maximum year built.
- max_hoa (number): Maximum monthly HOA dues.
- has_pool (boolean): Only return properties with a pool.
- has_garage (boolean): Only return properties with a garage.
- is_waterfront (boolean): Only return waterfront properties.
- time_on_market_days (integer): Only return properties on the market within the last N days.
- sold_within_days (integer): For `status=sold` searches, only return properties sold within the last N days. Allowed values: `1` to `1095` (3 years).
Full URL: `https://api.openwebninja.com/real-time-redfin-data/search`

### GET /search-coordinates - Search by Coordinates
Search Redfin property listings within a geographic bounding box defined by Northeast (NE) and Southwest (SW) latitude/longitude corners.
Parameters:
- **ne_lat** (number, required): Latitude of the Northeast corner of the bounding box. Allowed values: `-90` to `90`.
- **ne_lng** (number, required): Longitude of the Northeast corner of the bounding box. Allowed values: `-180` to `180`.
- **sw_lat** (number, required): Latitude of the Southwest corner of the bounding box. Allowed values: `-90` to `90`. Must be less than `ne_lat`.
- **sw_lng** (number, required): Longitude of the Southwest corner of the bounding box. Allowed values: `-180` to `180`. Must be less than `ne_lng`.
- status (string, default: `for_sale`, allowed: for_sale | sold | for_rent | coming_soon): Listing status to filter by. Allowed values: `for_sale`, `sold`, `for_rent`, `coming_soon`.
- property_types (string): Comma-separated list of property types to filter by. Allowed values: `HOUSE`, `CONDO`, `TOWNHOUSE`, `MULTI_FAMILY`, `LAND`, `OTHER`, `MANUFACTURED`, `CO_OP`.
- sort (string, default: `redfin_recommended`, allowed: redfin_recommended | newest | oldest | price_low_high | price_high_low | beds | baths | sqft | lot_size): Sort order for the results.
- page (integer, default: `1`): Page number for pagination. Allowed values: `1` to `100`.
- num_homes (integer, default: `40`): Number of homes to return per page. Allowed values: `1` to `350`.
- country_code (string, default: `US`, allowed: US | CA): Country code to scope the search. Use `US` for redfin.com or `CA` for redfin.ca.
- min_price (number): Minimum listing price filter.
- max_price (number): Maximum listing price filter.
- min_beds (integer): Minimum number of bedrooms.
- max_beds (integer): Maximum number of bedrooms.
- min_baths (number): Minimum number of bathrooms.
- min_sqft (integer): Minimum interior square footage.
- max_sqft (integer): Maximum interior square footage.
- min_lot_size (integer): Minimum lot size in square feet.
- max_lot_size (integer): Maximum lot size in square feet.
- min_year_built (integer): Minimum year built.
- max_year_built (integer): Maximum year built.
- max_hoa (number): Maximum monthly HOA dues.
- has_pool (boolean): Only return properties with a pool.
- has_garage (boolean): Only return properties with a garage.
- is_waterfront (boolean): Only return waterfront properties.
- time_on_market_days (integer): Only return properties on the market within the last N days.
- sold_within_days (integer): For `status=sold` searches, only return properties sold within the last N days.
Full URL: `https://api.openwebninja.com/real-time-redfin-data/search-coordinates`

### GET /search-polygon - Search by Polygon
Search Redfin property listings within a custom polygon area.
Parameters:
- **polygon** (string, required): The polygon to search within, specified as a comma-separated list of `longitude latitude` pairs (at least 3 pairs required). Format: `lng1 lat1,lng2 lat2,lng3 lat3,...`. The polygon will be closed automatically if not already closed.
- status (string, default: `for_sale`, allowed: for_sale | sold | for_rent | coming_soon): Listing status to filter by.
- property_types (string): Comma-separated list of property types to filter by. Allowed values: `HOUSE`, `CONDO`, `TOWNHOUSE`, `MULTI_FAMILY`, `LAND`, `OTHER`, `MANUFACTURED`, `CO_OP`.
- sort (string, default: `redfin_recommended`, allowed: redfin_recommended | newest | oldest | price_low_high | price_high_low | beds | baths | sqft | lot_size): Sort order for the results.
- page (integer, default: `1`): Page number for pagination.
- num_homes (integer, default: `40`): Number of homes to return per page. Allowed values: `1` to `350`.
- country_code (string, default: `US`, allowed: US | CA): Country code to scope the search.
- min_price (number): Minimum listing price filter.
- max_price (number): Maximum listing price filter.
- min_beds (integer): Minimum number of bedrooms.
- max_beds (integer): Maximum number of bedrooms.
- min_baths (number): Minimum number of bathrooms.
- min_sqft (integer): Minimum interior square footage.
- max_sqft (integer): Maximum interior square footage.
- min_lot_size (integer): Minimum lot size in square feet.
- max_lot_size (integer): Maximum lot size in square feet.
- min_year_built (integer): Minimum year built.
- max_year_built (integer): Maximum year built.
- max_hoa (number): Maximum monthly HOA dues.
- has_pool (boolean): Only return properties with a pool.
- has_garage (boolean): Only return properties with a garage.
- is_waterfront (boolean): Only return waterfront properties.
- time_on_market_days (integer): Only return properties on the market within the last N days.
- sold_within_days (integer): For `status=sold` searches, only return properties sold within the last N days.
Full URL: `https://api.openwebninja.com/real-time-redfin-data/search-polygon`

### GET /property-details - Property Details
Get the full details of a specific Redfin property by `property_id` or Redfin listing URL.
Parameters:
- property_id (string): Redfin internal property ID. You can find property IDs in the `property_id` field of the `/search` response or in any Redfin URL (e.g., `https://www.redfin.com/CA/Beverly-Hills/.../home/6824074`). One of `property_id` or `url` is required.
- url (string): Full Redfin listing URL. Example: `https://www.redfin.com/CA/Beverly-Hills/1185-Angelo-Dr-90210/home/6824074` One of `property_id` or `url` is required.
- country_code (string, default: `US`, allowed: US | CA): Country code to scope the lookup. Use `US` for redfin.com or `CA` for redfin.ca.
Full URL: `https://api.openwebninja.com/real-time-redfin-data/property-details`

### GET /market-trends - Market Trends
Get Redfin housing market trends for a region.
Parameters:
- **location** (string, required): The location to fetch market trends for. Accepts a 5-digit US zip code, a Canadian postal-code area, or a full Redfin region URL (e.g., `https://www.redfin.com/city/30749/NY/New-York` or `https://www.redfin.com/zipcode/90210`).
- country_code (string, default: `US`, allowed: US | CA): Country code to scope the lookup. Use `US` for redfin.com or `CA` for redfin.ca.
Full URL: `https://api.openwebninja.com/real-time-redfin-data/market-trends`

## Base URL and Authentication

- Base URL: `https://api.openwebninja.com/real-time-redfin-data`
- Auth: API key in the `x-api-key` header. Get a key by subscribing (free tier available) at https://app.openwebninja.com/api/realtime-redfin-data

## Topics

redfin api, real estate data api, property data api, property search api, real estate listings api, market trends api, property details api, housing data api, real estate api

## Links

- API page: https://www.openwebninja.com/api/real-time-redfin-data
- Get an API key / subscribe: https://app.openwebninja.com/api/realtime-redfin-data
- Pricing & plans: https://app.openwebninja.com/api/realtime-redfin-data/pricing
- Website: https://www.openwebninja.com
- OpenAPI spec: https://openwebninja.s3.us-east-1.amazonaws.com/portal/openapi/realtime_redfin_data.yaml
- Support: support@openwebninja.com

_Last updated: 2026-05-27_