Navigating the API

How to efficiently navigate the API

Parcl ID System

Parcl Labs' API is built around parcl_id's. Each parcl_id corresponds to a geographic market and serves as the starting point for querying any data about that particular market.

  • Parcl_id – 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.

Query the markets endpoint to understand which parcl_id's are currently available through Parcl Labs' beta API. At the moment, we make a subset of markets available through the beta API. If you are interested in a market that is not visible in the API, please contact our team at [email protected].

API Endpoints

Place Category

  • Geography Details – Return a geojson object representing the boundary coordinates for a given parcl_id.
  • Markets – Get parcl_ids for all available Parcl Labs Markets in the API. Use this endpoint as the starting point to interact with other Parcl Labs API endpoints.

Housing Stock Category

  • Housing Stock Current – Return housing stock for owner occupied single family residences, townhomes and condos for any given parcl_id in most recent year.
  • Housing Stock History – Return historical annual housing stock for owner occupied single family residences, townhomes and condos for any given parcl_id. Historical housing stock goes back to 2010.
    Financials Category
  • Volatility – After defining the date interval, we calculate the daily returns over the period, and determine the annualized standard deviation. Ultimately, this tool is designed to help real estate professionals adjust their investment strategies as necessary to optimize risk and reward.
  • Financials Current – Return financial metrics for a given parcl_id. Metrics include:
    • CAGR (Compound Annual Growth Rate)
    • Avg Return (Average Return)
    • Sharpe Ratio
    • Kurtosis
    • Annual Volatility
    • Alpha Beta
    • Correlation_coefficient – correlation of price feed with mortgage 30 year rates, at
      2, 4, 6, and 9 week lags.
  • Financials History – Return historical monthly financial metrics for a given parcl_id.
    Financial historical metrics goes back to 1/2021.

Price Feed Category

  • Price Feed Latest – Return the last daily price point for an array of parcl_id's. Price is Price per square foot for given market.
  • Price Feed History – Return the daily real estate price change for a given parcl_id. Specify start and end dates in YYYY-MM-DD format.
  • Price Feed Stats – Return statistics of Parcl Price Feed series for a given parcl_id. This includes 52 week high/low, 24 hr, 7, 30, 60, 90, 180, 365 day percent and dollar change.

Demographics Category

  • Demographics Age – Return age variables for a given parcl_id.
  • Demographics Income – Return income variables for a given parcl_id.
  • Demographics Friendly – Custom collections of demographic variables for a given
    parcl_id to align with modern definitions of demographics.
  • Demographics Employment – Return employment variables for a given parcl_id.
  • Demographics Population – Return population variables for a given parcl_id.

Sales Category

  • Sales Current – Return number of homes sold in last 30 days for a given parcl_id.
  • Sales History – Return the historical number of homes sold in last 30 days from a
    specified date for a given parcl_id. Sales data dates back to 1/1/2020.
    Listings Category
  • Listings Current – Return number of unique active homes listed in last 30 days for a given parcl_id. Listings information is currently available for roughly half of the markets. National coverage is coming soon.
  • Listings History – Return historical number of unique active homes listed in last 30 days from specified date for a given parcl_id. The start date of active listings historical data varies by parcl_id. Listings history is currently available for roughly half of the markets. National coverage is coming soon.
  • Listings New Current – Return number of unique new homes listed in last 30 days for a given parcl_id. Listings information is currently available for roughly half of the markets. National coverage is coming soon.
  • Listings New History – Return historical number of unique new homes listed in last 30 days from specified date for a given parcl_id. The start date of new listings historical data varies by parcl_id. Listings history is currently available for roughly half of the markets. National coverage is coming soon.
    Absorption Category.
  • Absorption Current – The current absorption rate (homes sold over past 30 days from latest date / available homes over past 30 days from latest date) for a given parcl_id. Absorption rate is available for roughly half of the markets, depending on historical data coverage. Full coverage is coming soon.
  • Absorption History – Historical absorption rates (homes sold over past 30 days from specified date / available homes over past 30 days from specified date) for a given parcl_id. Start date varies by parcl_id. Data is available for roughly half of the markets. Full coverage is coming soon.