{"uid":"cap_DnqpsYcUFkcqzUtNjo-Nr","slug":"agents-openwebninja-com-zillow-property-search-by-polygon-8dc10cbb","name":"Zillow Property Search by Polygon","description":"Search for properties in a specific geographic polygon area.  \n  Perfect for those who need more control over their search boundaries, this feature enables finding properties in complex or non-standard geographic areas.  \n  Support all filters and options available on Zillow.com.","url":"https://agents.openwebninja.com/realtime-zillow-data/search-polygon?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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 closed automatically if the last pair does not match the first.  \n  \n  **Format:** lng1 lat1,lng2 lat2,lng3 lat3,...  \n  This allows users to search for properties within complex, non-standard boundaries."},"max_sqft":{"type":"number","description":"Sets the maximum square footage for properties."},"min_sqft":{"type":"number","description":"Sets the minimum square footage for properties."},"home_type":{"type":"string","description":"Filters by comma-separated list of property types (leave empty to include all types):\n\n  **Allowed values for** FOR_SALE and RECENTLY_SOLD:  \n  `HOUSES`  \n  `TOWNHOMES`  \n  `MULTI_FAMILY`  \n  `CONDOS_COOPS`  \n  `LOTSLAND`  \n  `APARTMENTS`  \n  `MANUFACTURED`\n\n  **Allowed values for** FOR_RENT:  \n  `HOUSES`  \n  `APARTMENTS_CONDOS_COOPS`  \n  `TOWNHOMES`  "},"max_price":{"type":"number","description":"Sets the maximum price for properties in the search results."},"min_price":{"type":"number","description":"Sets the minimum price for properties in the search results."},"space_type":{"type":"string","description":"Find properties with specified space type (works for FOR_RENT home_status type), specified as a comma separated list of the following values: `ENTIRE_PLACE`, `ROOM`."},"home_status":{"enum":["FOR_SALE","FOR_RENT","RECENTLY_SOLD"],"type":"string","default":"FOR_SALE","description":"Filters properties based on their status."},"max_hoa_fee":{"type":"number","default":"ANY FEE","description":"Sets the maximum Homeowners Association (HOA) fee for properties (0 - no hoa fee)."},"listing_type":{"type":"string","default":"BY_AGENT","description":"Listing type of the property. (`BY_OWNER_OTHER` is for off market properties)."},"max_bedrooms":{"type":"number","description":"Filters properties by a maximum number of bedrooms."},"max_lot_size":{"type":"number","description":"Sets the minimum lot size for properties (in square feet)."},"min_bedrooms":{"type":"number","description":"Filters properties by a minimum number of bedrooms."},"min_lot_size":{"type":"number","description":"Sets the minimum lot size for properties (in square feet)."},"max_bathrooms":{"type":"number","description":"Filters properties by a maximum number of bathrooms."},"min_bathrooms":{"type":"number","description":"Filters properties by a minimum number of bathrooms."},"for_sale_by_agent":{"type":"boolean","default":true,"description":"Filters properties listed by real estate agents."},"for_sale_by_owner":{"type":"boolean","default":true,"description":"Filters properties listed by the owner directly.  \n\n  **Note:** works only for listing_type `BY_OWNER_OTHER`."},"for_sale_is_auction":{"type":"boolean","default":true,"description":"Filters for properties that are for sale at auction."},"max_monthly_payment":{"type":"number","description":"Sets the maxium monthly payment for properties in the search results (only for FOR_SALE).  \n  Includes estimated principal and interest, mortgage insurance, property taxes, home insurance and HOA fees."},"min_monthly_payment":{"type":"number","description":"Sets the minimum monthly payment for properties in the search results (only for FOR_SALE).  \n  Includes estimated principal and interest, mortgage insurance, property taxes, home insurance and HOA fees."},"for_sale_is_foreclosed":{"type":"boolean","default":false,"description":"Filters for properties which had been foreclosed.  \n  These properties are owned by a bank or a lender who took ownership through foreclosure proceedings.  \n  They may soon be listed for sale."},"for_sale_is_foreclosure":{"type":"boolean","default":true,"description":"Filters for properties that are foreclosures.  \n  These properties are currently listed for sale.  \n  They are owned by a bank or a lender who took ownership through foreclosure proceedings.  \n  These are also known as bank-owned or real estate owned (REO)."},"for_sale_is_preforeclosure":{"type":"boolean","default":false,"description":"Filters for properties in pre-market foreclosure status.  \n  The lender initiated foreclosure proceedings on these properties because the owner(s) were in default on their loan obligations.  \n  Pre-foreclosures also include properties for which a foreclosure auction is scheduled."},"includes_homes_no_hoa_data":{"type":"boolean","default":true,"description":"Include homes with incomplete HOA data."},"for_sale_is_new_construction":{"type":"boolean","default":true,"description":"Filters for new construction properties."}}},"responseSchema":{"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 coordinate of the property."},"openHouse":{"type":"string","nullable":true,"description":"Open-house schedule label, when applicable."},"zestimate":{"type":"number","nullable":true,"description":"Zillow's automated valuation (Zestimate) for the property."},"brokerName":{"type":"string","nullable":true,"description":"Listing agent / brokerage name."},"homeStatus":{"type":"string","description":"Listing status. Values: FOR_SALE, FOR_RENT, SOLD, PENDING, OTHER."},"isFeatured":{"type":"boolean","nullable":true,"description":"Whether the listing is featured / promoted."},"livingArea":{"type":"number","nullable":true,"description":"Living area in square feet."},"lotAreaUnit":{"type":"string","nullable":true,"description":"Unit for `lotAreaValue`. Typical values: acres, sqft."},"priceChange":{"type":"number","nullable":true,"description":"Most recent price change amount (negative for reductions)."},"daysOnZillow":{"type":"integer","nullable":true,"description":"Number of days the listing has been on Zillow."},"lotAreaValue":{"type":"number","nullable":true,"description":"Lot area value in `lotAreaUnit`."},"timeOnZillow":{"type":"integer","nullable":true,"description":"Time the listing has been on Zillow, in milliseconds."},"isZillowOwned":{"type":"boolean","nullable":true,"description":"Whether the property is owned by Zillow (Zillow Offers)."},"rentZestimate":{"type":"number","nullable":true,"description":"Zillow's automated rent valuation for the property."},"streetAddress":{"type":"string","nullable":true,"description":"Street address component of the property."},"listingSubType":{"type":"object","nullable":true,"properties":{"is_FSBA":{"type":"boolean","nullable":true,"description":"For Sale By Agent."},"is_FSBO":{"type":"boolean","nullable":true,"description":"For Sale By Owner."},"is_newHome":{"type":"boolean","nullable":true,"description":"New construction."},"is_bankOwned":{"type":"boolean","nullable":true,"description":"Bank-owned (REO) listing."},"is_openHouse":{"type":"boolean","nullable":true,"description":"Has an open house scheduled."},"is_comingSoon":{"type":"boolean","nullable":true,"description":"Coming soon listing."},"is_forAuction":{"type":"boolean","nullable":true,"description":"Auction listing."},"is_foreclosure":{"type":"boolean","nullable":true,"description":"Foreclosure listing."}},"description":"Flags describing sub-types of the listing (FSBA, FSBO, open house, etc.)."},"priceReduction":{"type":"string","nullable":true,"description":"Human-readable price reduction summary (amount and date)."},"datePriceChanged":{"type":"integer","nullable":true,"description":"Unix timestamp (milliseconds) when the price was last changed."},"isPremierBuilder":{"type":"boolean","nullable":true,"description":"Whether the listing belongs to a premier builder."},"taxAssessedValue":{"type":"number","nullable":true,"description":"Most recent tax-assessed value of the property."},"isShowcaseListing":{"type":"boolean","nullable":true,"description":"Whether the listing is a Zillow Showcase listing."},"isNonOwnerOccupied":{"type":"boolean","nullable":true,"description":"Whether the property is non-owner occupied."},"isPreforeclosureAuction":{"type":"boolean","nullable":true,"description":"Whether the property is in a pre-foreclosure auction."}},"description":"Array of property listing objects"},"description":"Array of property listing objects within the requested polygon."},"status":{"type":"string","description":"The status of the API response"},"parameters":{"type":"object","properties":{"page":{"type":"integer","description":"Current page number in paginated results"},"sort":{"type":"string","description":"How the results should be sorted"},"polygon":{"type":"string","description":"Geographic area defined by polygon coordinates"},"home_status":{"type":"string","description":"Status of the properties (for sale, sold, etc)"},"listing_type":{"type":"string","description":"Type of property listing"}}},"request_id":{"type":"string","description":"Unique identifier for the API request"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_PRqPveoSQvFaN9sRNGGYA","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Search for Zillow property listings within a custom-drawn geographic polygon boundary, supporting all standard Zillow filters.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Custom neighborhood home search","prompt":"Find all homes for sale within the boundaries of the Silver Lake neighborhood in LA — I want at least 2 bedrooms, priced between $800,000 and $1,500,000, sorted from newest to oldest. Here are the polygon coordinates defining the neighborhood boundary: -118.274 34.087, -118.261 34.087, -118.261 34.078, -118.274 34.078."},{"title":"School district property search","prompt":"Show me rental apartments within this specific school district boundary polygon — at least 2 bedrooms, max $3,000/month, for the entire place only. Polygon: -122.441 37.769, -122.420 37.769, -122.420 37.755, -122.441 37.755. Sort by price low to high."},{"title":"Investment property scouting in custom zone","prompt":"I'm looking for recently sold multi-family properties within this irregular zone I outlined — polygon coordinates are -87.640 41.893, -87.625 41.893, -87.618 41.880, -87.630 41.870, -87.645 41.875. Give me page 1 sorted by price high to low."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:37:01.885Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-zillow-property-search-by-polygon-8dc10cbb"}