API Reference

Search

get
https://api.parcllabs.com/v1/property/search

Gets a list of properties based on user-defined search parameters. Each property in the response includes a unique <parcl_property_id>, location detail, physical attributes, and current ownership insights. The <parcl_property_id> is key for navigating the Parcl Labs API, serving as the core mechanism for retrieving detailed property-level information in other property endpoints.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
enum

The current true owner entity associated with the property. Allows for filtering based on specific named large-scale operators.

Possible values include:

AMH

TRICON

INVITATION_HOMES

HOME_PARTNERS_OF_AMERICA

PROGRESS_RESIDENTIAL

FIRSTKEY_HOMES

AMHERST

MAYMONT_HOMES

VINEBROOK_HOMES

SFR3

MY_COMMUNITY_HOMES

BLACKSTONE

BX

OPENDOOR

OFFERPAD

NULL indicates the property is not currently owned by one of these named entities

integer
required
≥ 0

A unique id for a given geographic market in the Parcl Labs API. Parcl_ids are unique and independent of each other, without any hierarchical structure. For example, the parcl_id for Brooklyn, NY bears no relationship to the parcl_id for the New York Metropolitan Statistical Area (MSA), even though Brooklyn is a part of the New York MSA

string
enum
required

The type of property the data is associated with. Allows for filtering based on property type

Allowed:
integer

The minimum total area of the property measured in square feet. Use this to specify the smallest acceptable property size

integer

The maximum total area of the property measured in square feet. Use this to specify the largest acceptable property size

integer

The minimum number of bedrooms in the property. Use this to specify the smallest acceptable number of bedrooms

integer

The maximum number of bedrooms in the property. Use this to specify the largest acceptable number of bedrooms

integer

The minimum number of bathrooms in the property. Use this to specify the smallest acceptable number of bathrooms

integer

The maximum number of bathrooms in the property. Use this to specify the largest acceptable number of bathrooms

integer

The minimum year the property was built. Use this to specify the earliest acceptable year of construction

integer

The maximum year the property was built. Use this to specify the latest acceptable year of construction

boolean

Boolean flag indicating if the property has any observed sale events in its history since 2010.

False signifies that the property has no observed sale events

True signifies that the property has at least one observed sale event

boolean

Boolean flag indicating if the property has any observed rental events in its history since 2010.

False signifies that the property has no observed rental events

True signifies that the property has at least one observed rental event

boolean

Boolean flag indicating if the property has any observed listing events in its history since 2010.

False signifies that the property has no observed listing events

True signifies that the property has at least one observed listing event

boolean

Boolean flag indicating if the property is currently classified as new construction.

False signifies that the property is not currently classified as new construction

True signifies that the property is currently classified as new construction

boolean

Boolean flag indicating if the property is currently owner-occupied (i.e., not owned by an investor).

False signifies that the property is not currently owner-occupied

True signifies that the property is currently owner-occupied

NULL signifies that the current owner-occupied status is unknown

boolean

Boolean flag indicating if the property is currently owned by an investor (i.e., not owner-occupied).

False signifies that the property is not currently investor-owned

True signifies that the property is currently investor-owned

NULL signifies that the current investor ownership status is unknown

boolean

Boolean flag indicating if the property is currently listed on the market for sale.

0 signifies that the property is not currently listed on the market for sale

1 signifies that the property is currently listed on the market for sale

Boolean flag indicating if the property is currently listed on the market for rent.

0 signifies that the property is not currently listed on the market for rent

1 signifies that the property is currently listed on the market for rent

NULL signifies that either the current on-market status is unknown or the property is not a single family home

boolean

Boolean flag indicating if the property has a swimming pool.

1 signifies that the property has a pool

0 signifies that we do not have information about this home having a pool

date
Defaults to 2024-12-13

Specifies the beginning of the query period for when properties were added to the property record tracking system, inclusive, in ISO 8601 format, i.e. YYYY-MM-DD. Properties existing before tracking implementation are marked as 2024-12-13. Defaults to 2024-12-13

date

Specifies the end of the query period for when properties were added to the property record tracking system, inclusive, in ISO 8601 format, i.e. YYYY-MM-DD. Properties existing before tracking implementation are marked as 2024-12-13. Defaults to NULL

Responses

Updated about 1 year ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 year ago