Data

Real Estate Search by Coordinates

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

post/v1/data/real-estate/coordinates

Request

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

Request body

latnumber float required

Latitude coordinate

longnumber float required

Longitude coordinate

diameternumber float required

Diameter in miles 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)

sort'DEFAULT' | 'VERIFIED_SOURCE' | 'PRICE_HIGH_LOW' | 'PRICE_LOW_HIGH' | 'NEWEST' | 'BEDROOMS' | 'BATHROOMS' | 'SQUARE_FEET' | 'LOT_SIZE'

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

{
  "lat": 34.01822,
  "long": -118.504744,
  "diameter": 1,
  "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.