[
  {
    "key": "census-pep-v2025",
    "label": "Census Bureau Vintage 2025 city and town estimates",
    "publisher": "U.S. Census Bureau Population Estimates Program",
    "vintage": "Vintage 2025",
    "reference_date": "2025-07-01",
    "geography": "City/place estimates processed for Every City in the USA",
    "url": "https://www.census.gov/data/datasets/time-series/demo/popest/2020s-total-cities-and-towns.html",
    "use_on_atlas": "Population estimates, one-year numeric change, one-year percent change, rankings, milestones, and state briefs.",
    "caveat": "These are July 1 population estimates inside one Census vintage, not net-migration counts and not a decennial count."
  },
  {
    "key": "census-gazetteer-2025",
    "label": "2025 Census Gazetteer",
    "publisher": "U.S. Census Bureau Geography Division",
    "vintage": "2025",
    "reference_date": "2025-01-01",
    "geography": "Census place centroids and area fields",
    "url": "https://www.census.gov/geographies/reference-files/time-series/geo/gazetteer-files.html",
    "use_on_atlas": "Latitude/longitude and map placement for city dots.",
    "caveat": "Centroids are used for map placement; they are not address-level or neighborhood-level coordinates."
  },
  {
    "key": "acs-2020-2024",
    "label": "American Community Survey 5-year estimates",
    "publisher": "U.S. Census Bureau",
    "vintage": "2020-2024",
    "reference_date": "2020-2024 5-year window",
    "geography": "Place, county, or joined geography depending on metric availability",
    "url": "https://www.census.gov/programs-surveys/acs/",
    "use_on_atlas": "Income, housing burden, home value, commute, tenure, and work-from-home context in story leads. Key tables include B08301, B19013, B25070, B25077, and commute-duration tables.",
    "caveat": "ACS values are estimates with margins of error and do not share the same reference date as Census PEP Vintage 2025. Treat joined ACS values as reporting context, not exact current-year measurements."
  },
  {
    "key": "bea-rpp-2024",
    "label": "BEA Regional Price Parities",
    "publisher": "U.S. Bureau of Economic Analysis",
    "vintage": "2024",
    "reference_date": "2024 annual",
    "geography": "Metro area or state nonmetro region",
    "url": "https://www.bea.gov/data/prices-inflation/regional-price-parities-state-and-metro-area",
    "use_on_atlas": "Regional cost-of-living context for affordability and shelter-pressure story leads.",
    "caveat": "RPP is regional context, not city-grain affordability and not an inflation rate."
  },
  {
    "key": "noaa-normals-1991-2020",
    "label": "NOAA U.S. Climate Normals",
    "publisher": "NOAA National Centers for Environmental Information",
    "vintage": "1991-2020 normals",
    "reference_date": "30-year climate normal",
    "geography": "Gridded or nearest-station climate normal joined to city coordinates",
    "url": "https://www.ncei.noaa.gov/products/land-based-station/us-climate-normals",
    "use_on_atlas": "July normal-high context for heat-growth story leads.",
    "caveat": "Normals describe historical climate, not a forecast or property-level risk."
  },
  {
    "key": "fema-nri-2025",
    "label": "FEMA National Risk Index",
    "publisher": "Federal Emergency Management Agency",
    "vintage": "December 2025 v1.20.0",
    "reference_date": "Historical risk model",
    "geography": "County-grain risk context",
    "url": "https://www.fema.gov/flood-maps/products-tools/national-risk-index",
    "use_on_atlas": "Heat and hazard context for story leads.",
    "caveat": "NRI is a planning index and not a property-level or forecast product."
  },
  {
    "key": "fcc-bdc-2025-06-30",
    "label": "FCC Broadband Data Collection",
    "publisher": "Federal Communications Commission",
    "vintage": "As of 2025-06-30",
    "reference_date": "2025-06-30",
    "geography": "Census place joined to broadband-serviceable units",
    "url": "https://help.bdc.fcc.gov/hc/en-us/articles/5290946484763-Fixed-Broadband-Availability-Data-Overview",
    "use_on_atlas": "Provider-reported gigabit availability context for opportunity story leads.",
    "caveat": "Availability is not adoption, actual speed, price, or reliability."
  },
  {
    "key": "bls-laus-2024",
    "label": "BLS Local Area Unemployment Statistics",
    "publisher": "U.S. Bureau of Labor Statistics",
    "vintage": "2024 annual averages",
    "reference_date": "2024 annual",
    "geography": "City or county, depending on LAUS coverage",
    "url": "https://www.bls.gov/lau/data-overview.htm",
    "use_on_atlas": "Unemployment context for commute and labor-market story leads.",
    "caveat": "LAUS geography and method differ from Census PEP place estimates."
  }
]