We're on a mission to create the world's best API developer experience and community for housing data. Our Cookbook open-sources our housing market research, empowering you to go from idea to analytics to insight.
The Cookbook repository provides ready-to-use code snippets and notebooks to help you easily use the Parcl Labs API for its top use cases: real estate trading and housing market analysis.
- Sign up for a free API key: To use the examples in this repository, get a Parcl Labs API key here.
- Review the API documentation: Understand the data points, markets, and resources available. For help, check out these links:
- Set up to use example notebooks: Use Google Colab for quick setup and execution, or run the code locally or your preferred environment. Google Colab is embedded in primary notebooks for easy use.
Parcl Labs examples are categorized into three main sections:
- Getting Started: Introductory resources to help you navigate the Parcl Labs API, search markets, and download data into CSVs.
- Housing Market Research: Notebooks for analyzing the US housing market, including sales, listings, rentals, and investor trends.
- Parcl Price Feed and Trader Resources: Resources for traders to leverage the Parcl Labs API, understand Parcl markets, access price feed time series, build models.
For the brave, explore the experimental folder where the Parcl Labs team tests new ideas. See and contribute to ongoing projects.
If you’re new to the Parcl Labs API, start here!:
-
Introduction to Search: Learn how to get the unique
parcl_id(market level identifiers) for the markets you want to analyze. This is a key concept that will help you understand how to pull market-level datapoints across the API. -
Data Downloader: Download data across all Parcl Labs endpoints into a CSV. This is a great resource for users who want access to Parcl Labs data but may be less familiar with using an API.
-
Bulk Data Downloader: For upgraded API users, learn how to pull down thousands of markets across the country and load into a CSV or database. This is a great resource for users who want to analyze many markets at once.
-
Property Data Downloader: Retrieve unit-level information from Parcl Labs’ Property API endpoints and export to CSV.
-
Address Search: Search single or a list of property addresses to fetch historical sales, listings, and rental events.
Parcl Labs produces and open sources cutting-edge research on the housing market. The intent of these notebooks is to make this type of analysis accessible to everyone, from curating datasets to generating user-friendly charts.
These notebooks fall into two subsections: Supply and Demand and Investor Analytics.
Inventory and Price Cut Analysis
New construction analysis
Notebooks:
- Total Supply and Price Changes: Select a market and explore total supply changes and price changes over time.
- New Construction Trends: Select a market and explore new construction supply, demand, and pricing characteristics related to listings, sales, and rental prices.
- New Construction Trends (Advanced): Explore the current state of new construction market dynamics across the country.
Analyze investor behavior, portfolio sizes, and their impact on the housing market.
Notebooks:
- Institutional Investor Acitivity: Learn how to analyze what 1000+ portfolio owners, i.e. large institutional investors, are doing in the housing market.
Parcl Labs developed its Parcl Price Feed to support the Parcl trading platform, enabling billions in trading volume. Price Feed data serves Parcl Traders and other applications by offering a real-time market indicator of U.S. and global housing market movements.
Price Action and Sales Volume Technical Chart
These resources range from core tasks like downloading price feed data to advanced charting.
Notebooks:
- Retrieve and Download Historical Price Feeds: Learn how to retrieve all historical price feeds for markets currently tradeable on the Parcl Exchange. This is useful for backtesting and analyzing past market trends.
- Technical Price Feed and Volume Chart: Create a financial chart that visualizes price feed action and and sales volume.
More advanced topics and ongoing projects are located in the experimental folder. These notebooks are for the curious and those looking to contribute to ongoing housing research.
YoY Shifts in Supply and Demand Skew
YoY Shifts in Supply and Demand Skew for Many Markets
Inventory Price Cut Analysis Across Many Marketes
New Construction Impact on New Listings Coming to Market
Notebooks:
- YoY Shifts in Supply and Demand for a Specific Market: Learn how to analyze YoY shifts in supply and demand for a given market
- Comprehensive US Housing Analysis Identifying Markets Setup for Price Declines: Analyze the entire US housing market and identifying markets that are poised for downward price pressure