# MassOutage

> US power data for every county and utility: live outages aggregated from many
> sources, utility reliability (SAIDI/SAIFI/CAIDI), how long outages typically last,
> electricity prices, and a decade of history — from ODIN, DOE/ORNL EAGLE-I, the US
> EIA and DOE.

## What this site is
MassOutage aggregates US electricity data across all 50 states + DC at the county and
utility level. Every county page shows current outage status (when a utility reports
live), a data-driven restoration estimate (how long outages of this size have
historically taken here, from past episodes), historical reliability (yearly outage
counts, a SAIDI-like "average hours without power per customer", worst events, monthly
trends), and an estimated residential electricity price with its multi-year change.
Every electric utility has a page with EIA reliability (SAIDI/SAIFI/CAIDI), its
residential price, and the counties it serves; utilities are ranked most/least
reliable. Outages are only reported at county granularity, so there are no per-city
pages — each county page lists the cities/towns and ZIP codes it covers, and a city
URL redirects to its county. Outage severity is a 0-5 level blending magnitude, % of
customers out, and neighboring-county concentration.

## Data sources
- Live outages: ODIN real-time county feed (opt-in utilities; partial coverage), polled ~every 10 min.
- Historical outages: DOE/ORNL EAGLE-I county-level, 15-minute resolution (full years 2014-2025).
- Reliability: US EIA Form 861 — per-utility SAIDI/SAIFI (+ derived CAIDI) and service territory.
- Major disturbances: DOE OE-417 (large grid events), refreshed daily.
- Weather context: US NWS active alerts, mapped to counties.
- Electricity prices: US EIA monthly retail price by state (API) + EIA-861 utility-level prices (revenue ÷ sales) → customer-weighted county estimate + multi-year change.
- Restoration estimates: median duration of a county's past outage episodes (folded from ODIN), conditioned on the current outage's size.
- Data-center demand context: LBNL 2024 U.S. Data Center Energy Usage Report (national aggregates only — there is no public county-level datacenter dataset).
- Denominators: EAGLE-I modeled county customer counts (MCC).

## JSON API (open CORS, cacheable)
- [national + per-state live totals](https://massoutage.com/api/v1/live/summary)
- [live severity map](https://massoutage.com/api/v1/live/map) — `{ counties: {FIPS:[out,pct,level]}, states: {SF:[out,pct,level]} }`, level 0-5
- [ranked live leaders (states, counties, providers)](https://massoutage.com/api/v1/live/top)
- [24h state severity timeline for the map animation](https://massoutage.com/api/v1/live/timeline?hours=24)
- [live status for one county](https://massoutage.com/api/v1/live/counties/48201) — any 5-digit county FIPS
- [county metadata + live + yearly history](https://massoutage.com/api/v1/counties/48201)
- [county monthly series + worst events](https://massoutage.com/api/v1/counties/48201/history)
- [DOE OE-417 major disturbances](https://massoutage.com/api/v1/disturbances)

FIPS is the 5-digit county code (e.g. 48201 = Harris County, TX); swap it into any /counties or /embed/county URL.

## Charts & embeds (free for newsrooms)
- [branded county PNG chart](https://massoutage.com/api/v1/counties/48201/chart/decade) — chart type decade|monthly|live
- [branded annual report PNG chart](https://massoutage.com/api/v1/reports/2024/chart) — also /reports/{year}/{state}/chart
- [auto-updating county iframe widget](https://massoutage.com/embed/county/48201/live) — type live|decade|monthly
- [embeddable annual report chart](https://massoutage.com/embed/reports/2024) — also /embed/reports/{year}/{state}
- [embeddable live US outage map](https://massoutage.com/embed/map) — add ?state={state-slug} for one state
- [live event wire + copy-paste embed snippets](https://massoutage.com/newsrooms) — charts, map, and live county status export as branded PNG (dark/light) or iframe

## Pages
- [national live severity map + summary](https://massoutage.com/)
- [state page](https://massoutage.com/texas) — e.g. /texas
- [county page](https://massoutage.com/texas/harris-county) — live status + restoration estimate, reliability, electricity cost, utilities, cities/towns, ZIPs
- [provider page](https://massoutage.com/provider/duke-energy-carolinas-llc) — reliability rank, residential price, territory
- [utilities ranked by reliability](https://massoutage.com/providers) — SAIDI/SAIFI/CAIDI
- [most reliable US utilities](https://massoutage.com/providers/most-reliable) and [least reliable](https://massoutage.com/providers/least-reliable) — full SAIDI ranking
- [power outages by state](https://massoutage.com/reports/outages-by-state) — states ranked by decade-average SAIDI, total events, worst year
- [biggest power outages in US history](https://massoutage.com/reports/biggest-power-outages-in-us-history) — DOE OE-417 federal record + largest EAGLE-I county outages
- [energy & cost](https://massoutage.com/energy) — per-state & county electricity prices, where prices are rising fastest, and national data-center (AI) demand context
- [outage-event wire for reporters](https://massoutage.com/newsrooms) — embeds, citations, alerts, DOE OE-417 record
- [how long power outages last](https://massoutage.com/how-long-do-power-outages-last) — typical restoration times by cause and severity, from a decade of EAGLE-I history

## Citation
Please cite as "MassOutage (https://massoutage.com)" and link to the specific county page or API URL.
Data is aggregated from public government sources and may be incomplete or delayed.