# Zillow Property Search by Polygon

> Zillow Property Search by 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 for Zillow property listings within a custom-drawn geographic polygon boundary, supporting all standard Zillow filters.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-zillow-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-zillow-property-search-by-polygon-8dc10cbb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DnqpsYcUFkcqzUtNjo-Nr

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-zillow-property-search-by-polygon-8dc10cbb
```

Example prompt: Search Zillow for single-family homes for sale within this polygon area defined by these coordinates — sort by price low to high, at least 3 bedrooms and 2 bathrooms, and show me page 1 of results: -118.50394 34.02926, -118.50840 34.02926, -118.51286 34.02869, -118.51527 34.02570.

## When to prefer this

Choose this endpoint when you need to search properties within a complex, irregular, or non-rectangular geographic boundary — such as a specific neighborhood, school district, city zone, or custom drawn area. Prefer this over bounding-box search when the area of interest has curved or irregular edges that a rectangle would over- or under-include. Ideal when users have polygon coordinates from a GIS tool, map drawing interface, or neighborhood boundary dataset.

## Known failure modes

- Invalid or malformed polygon coordinate string returns an error
- Polygon too large or too small may return zero results
- Page number exceeding available results returns empty data array
- Invalid filter values (e.g. unsupported sort order for a given home_status) may return error or default behavior
- Network timeout if Zillow's underlying service is slow or rate-limited
- Missing required polygon parameter returns a 400 validation error

## How this service works

Search for properties in a specific geographic polygon area.  
  Perfect for those who need more control over their search boundaries, this feature enables finding properties in complex or non-standard geographic areas.  
  Support all filters and options available on Zillow.com.

## Output

Returns an array of property listings matching the polygon boundary and filters. Each listing includes zpid, full address, listing price, Zestimate, number of bedrooms and bathrooms, home type, square footage, latitude/longitude coordinates, canonical Zillow detail URL, listing photo URL, open house schedule, and home status. Results are paginated with up to 41 properties per page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "polygon"
 ],
 "properties": {
  "page": {
   "type": "number",
   "default": 1,
   "maximum": 100,
   "minimum": 1,
   "description": "Page to return (each page includes up to 41 results). "
  },
  "sort": {
   "type": "string",
   "default": "DEFAULT",
   "description": "Return the results in a specific sort order.  \n\n  **Allowed values for** FOR_SALE and RECENTLY_SOLD:  \n  `DEFAULT`  \n  `PRICE_HIGH_LOW`  \n  `PRICE_LOW_HIGH`  \n  `NEWEST`  \n  `BEDROOMS`  \n  `BATHROOMS`  \n  `SQUARE_FEET`  \n  `LOT_SIZE`  \n  \n  **Allowed values for** FOR_RENT:  \n  `DEFAULT`  \n  `VERIFIED_SOURCE`  \n  `PRICE_HIGH_LOW`  \n  `PRICE_LOW_HIGH`  \n  `NEWEST`  \n  `BEDROOMS`  \n  `BATHROOMS`  \n  `SQUARE_FEET`  \n  `LOT_SIZE`\n\n  **Note:** For other status types `DEFAULT` sort order is the equivalent of Homes for you."
  },
  "polygon": {
   "type": "string",
   "example": "-118.50394248962402 34.02926010734425, -118.5084056854248 34.02926010734425, -118.51286888122559 34.028691046671696, -118.51527214050293 34.02570341552858,  \n  -118.51321220397949 34.02257340341831, -118.51750373840332 34.0215774662657, -118.51681709289551 34.017878168811684, -118.51286888122559 34.016455319170184,  \n  -118.51080894470215 34.013324966013194, -118.50789070129395 34.010621386310234, -118.50411415100098 34.008629219864694, -118.49982261657715 34.008486920473,  \n  -118.49570274353027 34.007063913440916, -118.4919261932373 34.00891381793271, -118.48849296569824 34.01119056813859, -118.4860897064209 34.014463289606894,  \n  -118.48471641540527 34.018020452464164, -118.48042488098145 34.01858958468914, -118.4780216217041 34.0215774662657, -118.47939491271973 34.0249920592766,  \n  -118.47681999206543 34.02797971546417, -118.47493171691895 34.03125178964367, -118.4721851348877 34.034381481654364, -118.47733497619629 34.035377268536706,  \n  -118.48231315612793 34.035377268536706, -118.48677635192871 34.035377268536706, -118.49141120910645 34.03495050416125, -118.49604606628418 34.034096968969656,  \n  -118.49621772766113 34.03054047990366, -118.50033760070801 34.02926010734425, -118.50239753723145 34.032532132148006, -118.50394248962402 34.02926010734425",
   "description": "Defines a custom geographic search area by specifying a series of longitude and latitude coordinates that form a closed shape (polygon).  \n  Each coordinate pair is longitude first, then latitude (lng lat), separated by a space. Pairs are separated by commas. The polygon is cl
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "zpid",
     "homeStatus",
     "detailUrl",
     "address"
    ],
    "properties": {
     "city": {
      "type": "string",
      "nullable": true,
      "description": "City where the property is located."
     },
     "unit": {
      "type": "string",
      "nullable": true,
      "description": "Unit / apartment number, when applicable."
     },
     "zpid": {
      "type": "string",
      "description": "Zillow's unique property identifier."
     },
     "price": {
      "type": "number",
      "nullable": true,
      "description": "Listed price of the property in the displayed currency."
     },
     "state": {
      "type": "string",
      "nullable": true,
      "description": "US state code where the property is located."
     },
     "imgSrc": {
      "type": "string",
      "nullable": true,
      "description": "URL of the primary listing photo."
     },
     "address": {
      "type": "string",
      "description": "Full street address of the property."
     },
     "country": {
      "type": "string",
      "nullable": true,
      "description": "Country code of the property."
     },
     "zipcode": {
      "type": "string",
      "nullable": true,
      "description": "ZIP / postal code of the property."
     },
     "bedrooms": {
      "type": "number",
      "nullable": true,
      "description": "Number of bedrooms in the property."
     },
     "currency": {
      "type": "string",
      "nullable": true,
      "description": "ISO 4217 currency code of `price`."
     },
     "hasImage": {
      "type": "boolean",
      "nullable": true,
      "description": "Whether the listing has at least one image."
     },
     "homeType": {
      "type": "string",
      "nullable": true,
      "description": "Property type. Values include SINGLE_FAMILY, CONDO, TOWNHOUSE, MULTI_FAMILY, MANUFACTURED, APARTMENT, LOT, OTHER."
     },
     "latitude": {
      "type": "number",
      "nullable": true,
      "description": "Latitude coordinate of the property."
     },
     "bathrooms": {
      "type": "number",
      "nullable": true,
      "description": "Number of bathrooms in the property."
     },
     "detailUrl": {
      "type": "string",
      "description": "Canonical Zillow URL of the property detail page."
     },
     "longitude": {
      "type": "number",
      "nullable": true,
      "description": "Longitude coo
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-zillow-property-search-by-polygon-8dc10cbb/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)
