Skip to main content

Data catalog

Data Catalog

A transparent catalog of the public datasets, fixture snapshots, and computed signals used by Housing BuildDesignHub.

About this catalog

Housing BuildDesignHub production pages currently use source-attributed static fixtures. This catalog documents the fixture-backed data pipeline and the public datasets the system is structured around. It does not provide a public CSV/API download yet, and Housing BuildDesignHub does not claim ownership of or any official license on the upstream public datasets it cites.

Catalog summary

  • Wired source adapters

    6

    Adapters live in the ETL pipeline and contribute fixture metrics today.

  • Supported markets

    8

    City profiles covered by every wired adapter.

  • Fixture metrics

    240

    Source-attributed metrics rendered across markets.

  • Methodology version

    v5.0

    Public formulas, weights, and confidence levels.

  • Production mode

    Static fixtures

    Production pages do not call live data APIs.

  • Live ACS ingestion

    Manual

    Operator-only workflow; not yet the production source.

Source datasets

Public datasets currently wired as fixture sources. Each citation links to the agency's canonical landing page; upstream datasets retain their own licenses and terms.

  • American Community Survey

    U.S. Census Bureau

    Wiredannually

    Detailed demographic, housing, and economic estimates for U.S. geographies, including rent, home value, and tenure.

    Category
    Housing
    Precision
    City / Census place
    Confidence
    high
    Production
    Fixture-backed
    Source landing page ↗

    Fixture-backed in production; not live data.

  • Building Permits Survey

    U.S. Census Bureau

    Wiredmonthly

    Monthly counts of new residential construction permits authorized by local jurisdictions across the U.S.

    Category
    Supply & Permits
    Precision
    MSA / CBSA
    Confidence
    high
    Production
    Fixture-backed
    Source landing page ↗

    Fixture-backed in production; not live data.

  • House Price Index

    Federal Housing Finance Agency

    Wiredquarterly

    Measure of single-family home price changes based on repeat-sales and refinancings of mortgages purchased or securitized by Fannie Mae and Freddie Mac.

    Category
    Housing
    Precision
    MSA / CBSA
    Confidence
    high
    Production
    Fixture-backed
    Source landing page ↗

    Fixture-backed in production; not live data.

  • Local Area Unemployment Statistics

    U.S. Bureau of Labor Statistics

    Wiredmonthly

    Monthly estimates of labor force, employment, and unemployment for states, metros, counties, and cities.

    Category
    Jobs & Economy
    Precision
    County
    Confidence
    high
    Production
    Fixture-backed
    Source landing page ↗

    Fixture-backed in production; not live data.

  • Regional Economic Accounts

    U.S. Bureau of Economic Analysis

    Wiredquarterly

    GDP, personal income, and per-capita income for states, metros, and counties.

    Category
    Jobs & Economy
    Precision
    Metropolitan area
    Confidence
    high
    Production
    Fixture-backed
    Source landing page ↗

    Fixture-backed in production; not live data.

  • National Risk Index

    Federal Emergency Management Agency

    Wiredannually

    Composite risk index for 18 natural hazards at the census-tract and county level.

    Category
    Climate Risk
    Precision
    County
    Confidence
    high
    Production
    Fixture-backed
    Source landing page ↗

    Fixture-backed in production; not live data.

Planned sources

Catalogued for transparency. These sources are not yet wired as ETL adapters and do not contribute production metrics.

  • Primary Mortgage Market Survey

    Freddie Mac (via FRED)

    Planned

    Weekly U.S. average mortgage rates for 30-year and 15-year fixed-rate loans, sourced from Freddie Mac.

    Source landing page ↗

  • HUD Data

    U.S. Department of Housing and Urban Development

    Planned

    Fair Market Rents, Income Limits, and other affordability and assisted-housing datasets.

    Source landing page ↗

  • NOAA Climate Data

    National Oceanic and Atmospheric Administration

    Planned

    Historical climate, weather, and ocean datasets including temperature, precipitation, and severe weather records.

    Source landing page ↗

  • EPA Environmental Data

    U.S. Environmental Protection Agency

    Planned

    Environmental information on facilities, emissions, water quality, and air quality across the U.S.

    Source landing page ↗

Computed signals

Derived scores on city pages. Each signal lists its inputs and source dependencies. See methodology for formulas and weights.

  • Affordability

    Higher score = relatively more affordable for typical income.

    Inputs
    Median household income (ACS) · Median gross rent (ACS)
    Sources
    Census ACS

  • Supply

    Higher score = supply growing relative to existing stock.

    Inputs
    Trailing-12 building permits (BPS) · Housing units (ACS)
    Sources
    Census BPS · Census ACS

  • Price momentum

    Higher score = stronger recent price appreciation.

    Inputs
    Home Price Index year-over-year change (FHFA)
    Sources
    FHFA HPI

    Not a forward forecast.

  • Job market

    Higher score = lower / improving unemployment.

    Inputs
    Unemployment rate (BLS LAUS) · 12-month unemployment trend (BLS LAUS)
    Sources
    BLS LAUS

  • Economic strength

    Higher score = higher and growing per-capita income at metro level.

    Inputs
    Per-capita personal income (BEA) · Per-capita personal income growth (BEA)
    Sources
    BEA Regional

  • Climate risk

    Lower exposure = higher score. Mapped at the city's primary county.

    Inputs
    FEMA National Risk Index composite + classification
    Sources
    FEMA NRI

    County-level context, not property-level risk.

  • Overall score

    Composite balanced reading across all signal categories.

    Inputs
    Weighted composite of the six signals above (see /methodology).
    Sources
    All six wired adapters

Coverage

The platform reports 100% required fixture coverage when every required fixture field exists for the current supported reports. That is a structural completeness signal — it does not mean the platform represents every real-world fact about a market.

Per-source freshness and stale-snapshot warnings are surfaced at /data-status on every deploy.

Public data exports

Each supported market is exposed as a read-only fixture profile in two formats: JSON (full object response) and CSV (one row per metric). All endpoints are static, do not call live APIs, and explicitly set liveData: false (JSON) or live_data=false (CSV column). See /api-docs for the response schema, column reference, examples, and caveats.

Index (JSON)

Lists every market with its HTML and JSON URLs.

GET /api/markets ↗

Bulk CSV — all markets

One row per market metric across every supported market; same columns as the per-market CSV.

GET /api/markets/csv ↓

Access and licensing

  • Public exports are live in two formats. Each market exposes a fixture-backed JSON profile at /api/markets/<market-id> and a one-row-per-metric CSV at /api/markets/<market-id>/csv.
  • DataDownload schema. City-page Dataset JSON-LD references both the JSON and CSV endpoints via distribution.
  • Machine-readable contract. /api/schema/market-profile serves JSON Schema (draft-07) for the JSON profile; /api/schema/market-csv describes the CSV column contract.
  • Upstream licenses. Raw datasets cited above retain their own licenses, terms, and citation conventions — see each agency's landing page.
  • No standalone Housing BuildDesignHub license claim. Fixture profiles are shown for transparency, not offered as a standalone downloadable dataset. /methodology acts as the current usage/license caveat page.

Related transparency