Data

Real Estate Search by Polygon

Search for real estate properties by polygon area using Real Estate API through RapidAPI

post/v1/data/real-estate/polygon

Request

Base URL: https://apipie.ai
URL: https://apipie.ai/v1/data/real-estate/polygon
Auth: API key in header Authorization

Request body

polygonstring required

Polygon coordinates string for search area

home_status'FOR_SALE' | 'FOR_RENT' | 'RECENTLY_SOLD'

Filters properties based on their status

home_typestring

Filters by comma-separated list of property types

space_typestring

Find properties with specified space type (works for FOR_RENT home_status type)

Return the results in a specific sort order

min_pricenumber

Sets the minimum price for properties in the search results

max_pricenumber

Sets the maximum price for properties in the search results

min_monthly_paymentnumber

Sets the minimum monthly payment for properties (only for FOR_SALE)

max_monthly_paymentnumber

Sets the maximum monthly payment for properties (only for FOR_SALE)

min_bedroomsnumber

Filters properties by a minimum number of bedrooms

max_bedroomsnumber

Filters properties by a maximum number of bedrooms

min_bathroomsnumber

Filters properties by a minimum number of bathrooms

max_bathroomsnumber

Filters properties by a maximum number of bathrooms

min_sqftnumber

Sets the minimum square footage for properties

max_sqftnumber

Sets the maximum square footage for properties

min_lot_sizenumber

Sets the minimum lot size for properties (in square feet)

max_lot_sizenumber

Sets the maximum lot size for properties (in square feet)

listing_type'BY_AGENT' | 'BY_OWNER_OTHER'

Listing type of the property

for_sale_by_agentboolean

Filters properties listed by real estate agents

for_sale_by_ownerboolean

Filters properties listed by the owner directly

for_sale_is_new_constructionboolean

Filters for new construction properties

for_sale_is_foreclosureboolean

Filters for properties that are foreclosures

for_sale_is_auctionboolean

Filters for properties that are for sale at auction

for_sale_is_foreclosedboolean

Filters for properties which had been foreclosed

for_sale_is_preforeclosureboolean

Filters for properties in pre-market foreclosure status

max_hoa_feenumber

Sets the maximum Homeowners Association (HOA) fee for properties

includes_homes_no_hoa_databoolean

Include homes with incomplete HOA data

userstring

User identifier for billing observability purposes

Example request

{
  "polygon": "-118.50394248962402 34.02926010734425, -118.5084056854248 34.02926010734425, -118.51286888122559 34.028691046671696, -118.51527214050293 34.02570341552858, -118.51321220397949 34.02257340341831, -118.51750373840332 34.0215774662657, -118.51681709289551 34.017878168811684, -118.51286888122559 34.016455319170184, -118.51080894470215 34.013324966013194, -118.50789070129395 34.010621386310234, -118.50411415100098 34.008629219864694, -118.49982261657715 34.008486920473, -118.49570274353027 34.007063913440916, -118.4919261932373 34.00891381793271, -118.48849296569824 34.01119056813859, -118.4860897064209 34.014463289606894, -118.48471641540527 34.018020452464164, -118.48042488098145 34.01858958468914, -118.4780216217041 34.0215774662657, -118.47939491271973 34.0249920592766, -118.47681999206543 34.02797971546417, -118.47493171691895 34.03125178964367, -118.4721851348877 34.034381481654364, -118.47733497619629 34.035377268536706, -118.48231315612793 34.035377268536706, -118.48677635192871 34.035377268536706, -118.49141120910645 34.03495050416125, -118.49604606628418 34.034096968969656, -118.49621772766113 34.03054047990366, -118.50033760070801 34.02926010734425, -118.50239753723145 34.032532132148006, -118.50394248962402 34.02926010734425",
  "home_status": "FOR_SALE",
  "home_type": "HOUSES,CONDOS_COOPS",
  "space_type": "ENTIRE_PLACE",
  "sort": "DEFAULT",
  "min_price": 500000,
  "max_price": 1000000,
  "min_monthly_payment": 2000,
  "max_monthly_payment": 5000,
  "min_bedrooms": 2,
  "max_bedrooms": 4,
  "min_bathrooms": 1,
  "max_bathrooms": 3,
  "min_sqft": 1000,
  "max_sqft": 3000,
  "min_lot_size": 5000,
  "max_lot_size": 10000,
  "listing_type": "BY_AGENT",
  "for_sale_by_agent": true,
  "for_sale_by_owner": true,
  "for_sale_is_new_construction": true,
  "for_sale_is_foreclosure": true,
  "for_sale_is_auction": true,
  "max_hoa_fee": 500,
  "includes_homes_no_hoa_data": true,
  "user": "user123"
}

Response

Successful real estate search with results

Example response

{
  "queryDetails": {
    "search_id": "nai-123e4567-e89b-12d3-a456-426614174000",
    "timestamp": 1711729795000,
    "location": "Los Angeles, CA",
    "requested_records": 41,
    "total_records": 25,
    "cost": 0.01,
    "latency": 1200
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.