# Redfin Property Search by Custom Polygon

> Redfin Property Search by Custom Polygon is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Search Redfin property listings within a user-defined polygon area specified as longitude/latitude coordinate pairs, with full filtering and sorting support.

## Facts

- Endpoint: GET https://agents.openwebninja.com/real-time-redfin-data/search-polygon?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-redfin-property-search-by-custom-polygon-9a5f04eb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v1K7k_nfEbKFVKD8hFKoF

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-redfin-property-search-by-custom-polygon-9a5f04eb
```

Example prompt: Search Redfin for homes for sale inside this polygon area — coordinates: -122.45 37.77, -122.43 37.77, -122.43 37.75, -122.45 37.75 — with at least 3 bedrooms, at least 2 bathrooms, and a max price of $1,500,000, sorted by newest listings first.

## When to prefer this

Choose this endpoint when you need to search Redfin listings within an irregular or custom-shaped geographic area — such as a school district boundary, neighborhood outline, HOA footprint, or a user-drawn polygon on a map — rather than a simple city/zip/address query or bounding box. It is ideal for geospatial-aware real estate agents, district-matching tools, and map-drawing interfaces where the search area cannot be expressed as a simple rectangle or text location.

## Known failure modes

- Invalid polygon format (fewer than 3 coordinate pairs or malformed string) returns an error
- Polygon coordinates outside supported country scope returns empty results
- Invalid filter combinations (e.g. min_price greater than max_price) may return empty results or error
- Exceeding num_homes limit of 350 returns a validation error
- Rate limiting or payment/credit exhaustion returns 402 or 429 status
- Very large or complex polygons may time out or return partial results

## How this service works

Search Redfin property listings within a custom polygon area. Accepts a polygon as a string of longitude/latitude pairs. Useful for searching irregular regions, drawing a custom shape on a map, or matching the exact shape of a school district, neighborhood, or service area. Supports the same filters and sorting as /search.

## Output

Returns a paginated list of Redfin property listings within the specified polygon, including total results count, current page, whether more pages exist, median property statistics, and an array of individual listing details (price, beds, baths, sqft, address, etc.) matching all applied filters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "polygon"
 ],
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "description": "Page number for pagination."
  },
  "sort": {
   "enum": [
    "redfin_recommended",
    "newest",
    "oldest",
    "price_low_high",
    "price_high_low",
    "beds",
    "baths",
    "sqft",
    "lot_size"
   ],
   "type": "string",
   "default": "redfin_recommended",
   "description": "Sort order for the results."
  },
  "status": {
   "enum": [
    "for_sale",
    "sold",
    "for_rent",
    "coming_soon"
   ],
   "type": "string",
   "default": "for_sale",
   "description": "Listing status to filter by."
  },
  "max_hoa": {
   "type": "number",
   "description": "Maximum monthly HOA dues."
  },
  "polygon": {
   "type": "string",
   "description": "The polygon to search within, specified as a comma-separated list of `longitude latitude` pairs (at least 3 pairs required).\nFormat: `lng1 lat1,lng2 lat2,lng3 lat3,...`. The polygon will be closed automatically if not already closed."
  },
  "has_pool": {
   "type": "boolean",
   "description": "Only return properties with a pool."
  },
  "max_beds": {
   "type": "integer",
   "description": "Maximum number of bedrooms."
  },
  "max_sqft": {
   "type": "integer",
   "description": "Maximum interior square footage."
  },
  "min_beds": {
   "type": "integer",
   "description": "Minimum number of bedrooms."
  },
  "min_sqft": {
   "type": "integer",
   "description": "Minimum interior square footage."
  },
  "max_price": {
   "type": "number",
   "description": "Maximum listing price filter."
  },
  "min_baths": {
   "type": "number",
   "description": "Minimum number of bathrooms."
  },
  "min_price": {
   "type": "number",
   "description": "Minimum listing price filter."
  },
  "num_homes": {
   "type": "integer",
   "default": 40,
   "description": "Number of homes to return per page. Allowed values: `1` to `350`."
  },
  "has_garage": {
   "type": "boolean",
   "description": "Only return properties with a garage."
  },
  "country_code": {
   "enum": [
    "US",
    "CA"
   ],
   "type": "string",
   "default": "US",
   "description": "Country code to scope the search."
  },
  "max_lot_size": {
   "type": "integer",
   "description": "Maximum lot size in square feet."
  },
  "min_lot_size": {
   "type": "integer",
   "description": "Minimum lot size in square feet."
  },
  "is_waterfront": {
   "type": "boolean",
   "description": "Only return waterfront properties."
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "description": "Same shape as /search response (results_count, current_page, has_more, medians, results[])"
  },
  "status": {
   "type": "string"
  },
  "parameters": {
   "type": "object"
  },
  "request_id": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-redfin-property-search-by-custom-polygon-9a5f04eb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)