---
title: "Real Estate Search by Coordinates"
method: POST
path: "/v1/data/real-estate/coordinates"
tags: ["Data"]
---

# Real Estate Search by Coordinates

`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`

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

## Request body

- RealEstateCoordinatesRequest
  - `lat` number, float, required: Latitude coordinate
  - `long` number, float, required: Longitude coordinate
  - `diameter` number, float, required: Diameter in miles for search area
  - `home_status` 'FOR_SALE' | 'FOR_RENT' | 'RECENTLY_SOLD': Filters properties based on their status
  - `home_type` string: Filters by comma-separated list of property types
  - `space_type` string: 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_price` number: Sets the minimum price for properties in the search results
  - `max_price` number: Sets the maximum price for properties in the search results
  - `min_monthly_payment` number: Sets the minimum monthly payment for properties (only for FOR_SALE)
  - `max_monthly_payment` number: Sets the maximum monthly payment for properties (only for FOR_SALE)
  - `min_bedrooms` number: Filters properties by a minimum number of bedrooms
  - `max_bedrooms` number: Filters properties by a maximum number of bedrooms
  - `min_bathrooms` number: Filters properties by a minimum number of bathrooms
  - `max_bathrooms` number: Filters properties by a maximum number of bathrooms
  - `min_sqft` number: Sets the minimum square footage for properties
  - `max_sqft` number: Sets the maximum square footage for properties
  - `min_lot_size` number: Sets the minimum lot size for properties (in square feet)
  - `max_lot_size` number: 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_agent` boolean: Filters properties listed by real estate agents
  - `for_sale_by_owner` boolean: Filters properties listed by the owner directly
  - `for_sale_is_new_construction` boolean: Filters for new construction properties
  - `for_sale_is_foreclosure` boolean: Filters for properties that are foreclosures
  - `for_sale_is_auction` boolean: Filters for properties that are for sale at auction
  - `for_sale_is_foreclosed` boolean: Filters for properties which had been foreclosed
  - `for_sale_is_preforeclosure` boolean: Filters for properties in pre-market foreclosure status
  - `max_hoa_fee` number: Sets the maximum Homeowners Association (HOA) fee for properties
  - `includes_homes_no_hoa_data` boolean: Include homes with incomplete HOA data
  - `user` string: User identifier for billing observability purposes

## Response `200`

Successful real estate search with results

- RealEstateResponse
  - `dataResults` object
    - `properties` PropertyResultItem[]
      - `zpid` string
      - `homeStatus` string
      - `detailUrl` string
      - `address` string
      - `streetAddress` string
      - `city` string
      - `state` string
      - `country` string
      - `zipcode` string
      - `latitude` number
      - `longitude` number
      - `homeType` string
      - `price` number
      - `currency` string
      - `zestimate` number
      - `rentZestimate` number
      - `taxAssessedValue` number
      - `lotAreaValue` number
      - `lotAreaUnit` string
      - `bathrooms` number
      - `bedrooms` number
      - `livingArea` number
      - `daysOnZillow` number
      - `isFeatured` boolean
      - `isPreforeclosureAuction` boolean
      - `timeOnZillow` number
      - `isNonOwnerOccupied` boolean
      - `isPremierBuilder` boolean
      - `isZillowOwned` boolean
      - `unit` string
      - `isShowcaseListing` boolean
      - `listingSubType` object
      - `is_FSBA` boolean
      - `is_openHouse` boolean
      - `imgSrc` string
      - `hasImage` boolean
      - `brokerName` string
      - `openHouse` string
      - `priceChange` number
      - `datePriceChanged` number
      - `priceReduction` string
      - `newConstructionType` string
      - `is_newHome` boolean
      - `rank` integer
    - `general` object
      - `location` string
      - `results_cnt` integer
      - `total_properties` integer
      - `page` integer
      - `request_id` string
      - `parameters` object
  - `queryDetails` RealEstateUsage
    - `search_id` string
    - `timestamp` integer
    - `location` string
    - `requested_records` integer
    - `total_records` integer
    - `cost` number, float
    - `latency` integer

## Other responses

- `400`: Bad request or search failed
- `401`: Unauthorized - invalid API key
- `402`: Insufficient credits
- `500`: Internal server error

---

[API](https://skmtc.dev/apipie/apis/introduction.md) · [All operations](https://skmtc.dev/apipie/apis/introduction/llms.txt) · [OpenAPI document](https://skmtc.dev/apipie/apis/introduction/revisions/f8386be4eb3f?raw)