Buildings Search

post

https://api.repliers.io/buildings

Searches for buildings based on location, price, property type, and other criteria. A building represents a unique address and groups together all current and historical listings at that address, making it useful for building directory pages and pre-construction research.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

area

array of strings

Filters buildings by geographical area (also referred to as region or county).

area

buildingName

array of strings

Filters buildings by name. Availability of building names may vary by MLS and is not guaranteed for all buildings.

buildingName

city

array of strings

Filters buildings by city.

city

class

array of strings

Filters buildings by property class.

class

displayPublic

string

enum

Filters buildings by public display status. Y returns buildings that may be displayed publicly, N returns buildings that should be password protected.

Allowed:

lat

float

-90 to 90

Accepts a value for latitude. Must be used with radius parameter to return buildings within a certain radius of a given latitude and longitude.

long

float

-180 to 180

Accepts a value for longitude. Must be used with radius parameter to return buildings within a certain radius of a given latitude and longitude.

map

json

GeoJSON polygon or multi-polygon boundary for geographical filtering. Limits results to buildings within the specified boundaries. For complex polygons or multipolygons that exceed query parameter size limits, use the POST method and include the map data in the request body. Format: Array of coordinate arrays, where each coordinate is [longitude, latitude] in WGS 84 format. The polygon must be closed (first and last points must be identical). For more information refer to the implementation guide Filtering Listings Geo-Spatially Using the "map" Parameter

maxPrice

integer

≥ 0

Filters buildings whose listing prices are <= the supplied value.

maxStories

integer

≥ 1

Filters buildings whose story count is <= the supplied value.

minBathrooms

integer

≥ 0

Filters buildings whose bathroom count is >= the supplied value.

minBedrooms

integer

≥ 0

Filters buildings whose bedroom count is >= the supplied value.

minPrice

integer

≥ 0

Filters buildings whose listing prices are >= the supplied value.

minStories

integer

≥ 1

Filters buildings whose story count is >= the supplied value.

neighborhood

array of strings

Filters buildings by neighborhood.

neighborhood

pageNum

integer

≥ 1

Defaults to 1

The page number to return. For example, with 100 results per page, specifying pageNum=2 returns results 101–200.

propertyType

array of strings

Filters buildings by property type.

propertyType

radius

float

≥ 1

Accepts a value for radius in KM. Must be used with lat and long parameters to return buildings within the specified radius of a given latitude and longitude.

resultsPerPage

integer

1 to 300

Defaults to 100

The number of buildings to return per page.

sortBy

string

enum

Sorts results by the specified field.

Allowed:

streetName

array of strings

Filters buildings by street name.

streetName

streetNumber

array of strings

Filters buildings by street number.

streetNumber

type

string

enum

Filters buildings by listing type.

Allowed:

Body Params

Optional request body for complex geographical filtering using GeoJSON polygons. Use this for large polygon data that exceeds query parameter size limits.

map

object

GeoJSON polygon for geographical filtering. Limits results to buildings within the specified boundaries. Format: Array of coordinate arrays, where each coordinate is [longitude, latitude] in WGS 84 format. The polygon must be closed (first and last points must be identical).

Responses

401

Unauthorized

403

Forbidden

500

Internal Server Error

200Successful response containing list of buildings

400Bad Request