[May 8, 2024] API Live 🚀
The Parcl Labs API is now live 🚀. Data and endpoints available from day 1 of the new API (May 8, 2024) are detailed below. We'll be regularly shipping new features—please check back on the changelog to see what's new.
Data Coverage
| Category | Coverage |
|---|---|
| Property Types | 🏘️ All Residential Assets: ✅ Single Family ✅ Townhouses ✅ Condos ✅ Other |
| Markets | 🇺🇸 Complete National Coverage, 70k+ Unique Markets at Any Level of Granularity: ✅ Regions ✅ States ✅ Metros ✅ Cities ✅ Counties ✅ Towns ✅ Zips ✅ Census Places |
| Housing Events | 🔄 The Full Property Lifecycle: ✅ Sales ✅ For Sale Listings ✅ Rentals |
New Endpoints
We’re launching with 14 insight-packed endpoints across six categories:
Search Category: Search markets by keywords, geographic identifiers, or boundary types to retrieve market IDs (parcl_id). Endpoints:
- Search Markets: Gets a list of unique identifiers (<parcl_id>) for markets that correspond to specific keywords or parameters defined by the user. The <parcl_id> is key to navigating the Parcl Labs API, serving as the core mechanism for retrieving market-level information.
Market Metrics Category: Get overall housing stock information, and analyze supply and price trends across sales, listings, and rentals for markets (parcl_id). Endpoints:
- Housing Event Counts: Gets monthly counts of housing events, including sales, new for sale listings, and new rental listings, based on a specified <parcl_id>.
- Housing Event Prices: Gets monthly statistics on prices for housing events, including sales, new for sale listings, and new rental listings, based on a specified <parcl_id>.
- Housing Stock: Gets housing stock for a specified <parcl_id>. Housing stock represents the total number of properties, broken out by single family homes, townhouses, and condos.
Rental Market Metrics: Get rental market analytics for markets (parcl_id). Endpoints:
- Gross Yield: Gets the percent gross yield for a specified <parcl_id>. At the market level, identified by <parcl_id>, gross yield is calculated by dividing the annual median rental income—derived from multiplying the monthly median new rental listing price by 12—by its median new listings for sale price.
- New Listings For Rent Rolling Counts: Gets weekly updated rolling counts of newly listed for rent properties, segmented into 7, 30, 60, and 90 day periods ending on a specified date, based on a given <parcl_id>.
- Rental Units Concentration: Gets the number of rental units, total units, and percent rental unit concentration for a specified <parcl_id>.
For Sale Market Metrics: Get for sale listing analytics for markets (parcl_id). Endpoints:
- New Listings Rolling Counts: Gets weekly updated rolling counts of newly listed for sale properties, segmented into 7, 30, 60, and 90 day periods ending on a specified date, based on a given <parcl_id>.
Investor Metrics: Get analytics on overall investor ownership and transaction activity for markets (parcl_id). Endpoints:
- Housing Event Counts: Gets monthly counts of investor housing events, including acquisitions, dispositions, new for sale listings, and new rental listings, based on a specified <parcl_id>.
- Housing Stock Ownership: Gets counts of investor-owned properties and their corresponding percentage ownership share of the total housing stock, for a specified <parcl_id>.
- New Listings For Sale Rolling Counts: Gets weekly updated rolling counts of investor-owned properties newly listed for sale, and their corresponding percentage share of the total for sale listings market. These metrics are segmented into 7, 30, 60, and 90 day periods ending on a specified date, based on a given <parcl_id>.
- Purchase To Sale Ratio: Gets the monthly investor purchase to sale ratio for a specified <parcl_id>.
Portfolio Metrics: Get analytics on investor ownership and transaction activity for single family homes in markets (parcl_id), segmented by the unit size of the investor's portfolio. Endpoints:
- Sf Housing Stock Ownership: Gets counts of investor-owned single family properties and their corresponding percentage of the total single family housing stock, segmented by portfolio size, for a specified <parcl_id>. The data series for portfolio metrics begins on March 1, 2024 (2024-03-01).
- Sf New Listings For Sale Rolling Counts: Gets counts of investor-owned single family properties and their corresponding percentage of the total single family housing stock, segmented by portfolio size, for a specified <parcl_id>. The data series for portfolio metrics begins on April 15, 2024 (2024-04-15).