us-housing-risk-data

US housing risk and water quality data by ZIP code and state. Derived from EPA, FEMA, Census, and 17 other federal sources.

Part of the ZipCheckup project.

Install

npm install us-housing-risk-data

Usage

const risk = require('us-housing-risk-data');

// State-level data (all 50 states + DC)
const ca = risk.getState('CA');
// → { state: 'CA', name: 'California', rank: 8, avgScore: 71, grade: 'B', ... }

const allStates = risk.getAllStates();
// → [{ state: 'AL', ... }, ...] sorted by rank

// Sample ZIP data (100 representative ZIPs — best + worst per state)
const nyc = risk.getSampleZip('10001');
// → { zip: '10001', city: 'New York', state: 'NY', homeSafetyScore: 50, ... } or null

const allSamples = risk.getSampleZips();
// → [...100 records]

// Filtering
risk.filterStates({ minViolations: 70 });
// → states where 70%+ of ZIPs have violations

risk.filterStates({ grade: 'A' });
// → states with grade A

risk.filterSamples({ minScore: 80 });
// → sample ZIPs with Home Safety Score 80+

risk.filterSamples({ state: 'TX' });
// → sample ZIPs in Texas

// Metadata
risk.meta;
// → { generated, nationalAvg, nationalGrade, totalZips, totalStates, sampleCount }

State record fields

| Field | Type | Description | |-------|------|-------------| | state | string | 2-letter abbreviation | | name | string | Full state name | | rank | number | National rank (1 = best) | | avgScore | number | Average Home Safety Score (0-100) | | grade | string | Letter grade (A-F) | | totalZips | number | Number of ZIP codes in state | | pctViolations | number | % of ZIPs with water violations | | pctAorB | number | % of ZIPs graded A or B | | distribution | object | Count of ZIPs per grade { A, B, C, D, F } | | topContaminants | array | Top 5 contaminants found |

Sample ZIP record fields

| Field | Type | Description | |-------|------|-------------| | zip | string | 5-digit ZIP code | | city | string | City name | | state | string | 2-letter state abbreviation | | county | string | County name | | homeSafetyScore | number | Overall score (0-100) | | homeSafetyGrade | string | Letter grade (A-F) | | totalViolations | number | Total water violations | | healthViolations | number | Health-based violations | | leadLevel | number | Lead level (mg/L) | | radonZone | number | EPA radon zone (1-3, 1 = highest risk) | | radonRisk | string | Risk label | | floodClaims | number | NFIP flood insurance claims | | floodDominantZone | string | FEMA flood zone | | totalPopulation | number | Served population |

Data sources

• EPA SDWIS — Safe Drinking Water Information System (violations, contaminants)
• EPA Lead & Copper Rule — Lead/copper sampling data
• EPA Radon Zones — County-level radon risk
• FEMA NFIP — National Flood Insurance Program claims
• FEMA Flood Zones — Flood zone designations
• US Census — Population, housing characteristics
• 12 additional federal and state sources

Full data for 41,000+ ZIP codes available at zipcheckup.com.

Rebuilding data

node scripts/build-housing-risk-package.js

License

Data: CC BY 4.0

When using this data, please credit: "Data from ZipCheckup"