EIA Energy Data Normalizer

Fetch and normalize US energy data from the U.S. Energy Information Administration (EIA) API v2. Get petroleum prices, natural gas, electricity, coal, renewables, and more — with human-readable labels, cleaned fields, and structured JSON output.

No web scraping required — pure REST API access to official government energy data. A free API key from eia.gov takes 30 seconds to register.

Features

• 9 data categories: Petroleum spot prices, natural gas prices, electricity retail, coal production, renewable generation, total energy, petroleum stocks, natural gas storage, crude oil production
• Smart normalization: Fuel type codes → readable names (WTI → "West Texas Intermediate"), region codes → full names (PADD3 → "Gulf Coast"), unit codes → labels (MWH → "Megawatt-hours")
• Flexible filtering: By state, date range, result count
• Three output formats: Dataset (JSON), human-readable summary table, and machine-readable statistics
• Free data source: EIA API v2 — register at eia.gov/opendata for a free key

Input Parameters

Parameter	Type	Required	Default	Description
apiKey	string	✅	—	Free API key from eia.gov/opendata/register.php
dataCategory	select	✅	petroleum-prices	Which EIA data category to fetch
stateFilter	string	❌	—	2-letter US state code (e.g. TX, CA)
maxResults	integer	❌	100	Maximum data points (1–5000)
dateFrom	string	❌	—	Start date in YYYY-MM format
dateTo	string	❌	—	End date in YYYY-MM format

Data Categories

Value	Label
petroleum-prices	Petroleum Spot Prices (WTI, Brent, etc.)
natural-gas-prices	Natural Gas Prices (Henry Hub, citygate)
electricity-retail	Electricity Retail Sales (by state/sector)
coal-production	Coal Production (by region/mine type)
renewable-generation	Renewable Energy Generation (solar, wind, hydro)
total-energy	Total Energy Overview (consumption, production)
petroleum-stocks	Petroleum Stocks (inventories, SPR)
natural-gas-storage	Natural Gas Storage (weekly)
crude-oil-production	Crude Oil Production (by state/region)

Example Input

{
  "apiKey": "YOUR_EIA_API_KEY",
  "dataCategory": "petroleum-prices",
  "maxResults": 20,
  "dateFrom": "2025-01",
  "dateTo": "2025-06"
}

Example Output

=====================================================================================
  EIA ENERGY DATA — Petroleum Spot Prices
=====================================================================================
  Retrieved:     20 data points
  Period range:  2025-06 → 2025-01
  Fuel types:    Brent Crude, West Texas Intermediate
  Regions:       United States

  #  Period      Fuel/Product                    Value         Unit               Region
───  ──────────  ─────────────────────────  ────────────  ──────────────────  ────────────────────
  1  2025-06     West Texas Intermediate          72.34     USD                 United States
  2  2025-05     West Texas Intermediate          68.91     USD                 United States
  3  2025-04     West Texas Intermediate          65.22     USD                 United States
  ...

Each dataset item contains: period, year, month, value, unit, fuel, region, sector, and seriesDescription (where available).

Use Cases

• Energy traders & analysts — Track spot prices across crude, gas, and products
• Commodity researchers — Historical price trends with normalized labels
• ESG & sustainability teams — Renewable generation data by state and fuel type
• Economic researchers — Energy cost inputs for inflation/economic models
• AI/ML pipelines — Clean, structured energy data for training and analysis
• Supply chain & logistics — Fuel price trends by region for cost forecasting

Data Source

Data sourced from the U.S. Energy Information Administration (EIA) Open Data API v2. The EIA is the statistical agency of the U.S. Department of Energy, providing independent and impartial energy data. All data is public domain and freely redistributable.

Free API key: Register at eia.gov/opendata/register.php — instant activation, generous free tier.