{"uid":"cap_v1K7k_nfEbKFVKD8hFKoF","slug":"agents-openwebninja-com-redfin-property-search-by-custom-polygon-9a5f04eb","name":"Redfin Property Search by Custom Polygon","description":"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.","url":"https://agents.openwebninja.com/real-time-redfin-data/search-polygon?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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."},"max_year_built":{"type":"integer","description":"Maximum year built."},"min_year_built":{"type":"integer","description":"Minimum year built."},"property_types":{"type":"string","description":"Comma-separated list of property types to filter by.\nAllowed values: `HOUSE`, `CONDO`, `TOWNHOUSE`, `MULTI_FAMILY`, `LAND`, `OTHER`, `MANUFACTURED`, `CO_OP`."},"sold_within_days":{"type":"integer","description":"For `status=sold` searches, only return properties sold within the last N days."},"time_on_market_days":{"type":"integer","description":"Only return properties on the market within the last N days."}}},"responseSchema":{"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"}}},"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_D8lcm7wEHHeuVeMeTcQy_","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 Redfin property listings within a user-defined polygon area specified as longitude/latitude coordinate pairs, with full filtering and sorting support.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"School district boundary home search","prompt":"Find all homes for sale on Redfin within the boundary of Lincoln Elementary's school district — here are the polygon coordinates: -118.45 34.05, -118.42 34.05, -118.42 34.02, -118.45 34.02 — with at least 2 bedrooms and a price between $500,000 and $900,000."},{"title":"Custom neighborhood shape rental search","prompt":"Search Redfin rentals within this custom neighborhood polygon I drew: -87.65 41.88, -87.62 41.88, -87.62 41.85, -87.65 41.85 — I want at least 1 bath, up to $2,500 per month, and show me 50 results sorted by price low to high."},{"title":"Waterfront property search within marina area","prompt":"Look up waterfront homes for sale on Redfin inside this marina area polygon: -122.25 37.82, -122.22 37.82, -122.22 37.80, -122.25 37.80 — minimum 3 bedrooms, no HOA over $500 a month, and only show houses and condos."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:37:00.798Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-redfin-property-search-by-custom-polygon-9a5f04eb"}