EIA State Electricity API — Generation and Consumption Data

Query US EIA state-level electricity generation (66 000) and consumption (27 000) records for 1990–2025, across 54 states, 6 producer types, 14 energy sources. Renewable transition, fossil fuel share, and YoY change helpers. Built for energy analysts, policy researchers, and AI agents that need structured US electricity data.

Free trial

A free Apify account gives you about 5 USD of monthly credits, more than enough to compute several state-level timeseries before paying.

Use cases

1. Renewable transition watch — for each state, pull yearly generation by energy_source_category == "Renewable" and compute renewable_share_pct from 2010 to most recent.
2. Fossil fuel divestment screen — for a portfolio of utilities, fetch the state-level fossil_share_pct and yoy_change_pct to track decarbonisation pace.
3. State ranking — order states by renewable_share_pct in year = 2024 to support a policy brief.

Input

{
  "year": 2024,
  "state": "TX",
  "producer_type": "Total Electric Power Industry",
  "energy_source_category": "Renewable",
  "max_results": 100
}

Field	Type	Default	Description
dataset	string	generation	generation or consumption.
year	integer	0	Filter to one year. 0 = all years (1990–2025).
state	string	""	2-letter state code (e.g. TX, CA).
state_division	string	""	Census division (e.g. West South Central).
state_region	string	""	Census region.
producer_type	string	""	Total Electric Power Industry, Electric Utility, Independent Power Producer, Combined Heat and Power, …
energy_source	string	""	Wind, Solar, Coal, Natural Gas, …
energy_source_category	string	""	Renewable, Fossil, Nuclear, …
min_value_gwh	number	0	Post-filter minimum value in GWh.
max_results	integer	100	Cap on returned records.

Output (real run)

[
  {
    "year": 2024,
    "state": "TX",
    "state_name": "Texas",
    "state_fips": "48",
    "state_region": "South",
    "state_division": "West South Central",
    "producer_type": "Total Electric Power Industry",
    "energy_source": "Wind",
    "energy_source_category": "Renewable",
    "value_raw": 124277504,
    "value_unit": "Megawatthours",
    "value_gwh": 124277.504,
    "value_twh": 124.277504,
    "is_renewable": true,
    "is_fossil": false,
    "is_nuclear": false,
    "is_zero_emission": true,
    "is_recent_year": true,
    "rank_in_state": 1,
    "state_total_mwh": 539000000,
    "source_share_of_state_pct": 23.06,
    "renewable_share_pct": 28.4,
    "fossil_share_pct": 56.7,
    "decade_change_pct": 84.3,
    "yoy_change_pct": 6.2,
    "year_min": 1990,
    "year_max": 2025,
    "value_tier": "very_high",
    "resource": "wind"
  },
  {
    "year": 2024,
    "state": "TX",
    "state_name": "Texas",
    "state_fips": "48",
    "state_region": "South",
    "state_division": "West South Central",
    "producer_type": "Total Electric Power Industry",
    "energy_source": "Solar",
    "energy_source_category": "Renewable",
    "value_raw": 43800000,
    "value_unit": "Megawatthours",
    "value_gwh": 43800,
    "value_twh": 43.8,
    "is_renewable": true,
    "is_fossil": false,
    "is_nuclear": false,
    "is_zero_emission": true,
    "is_recent_year": true,
    "rank_in_state": 2,
    "state_total_mwh": 539000000,
    "source_share_of_state_pct": 8.13,
    "renewable_share_pct": 28.4,
    "fossil_share_pct": 56.7,
    "decade_change_pct": 1240.0,
    "yoy_change_pct": 28.5,
    "year_min": 1990,
    "year_max": 2025,
    "value_tier": "high",
    "resource": "solar"
  }
]

Field	Type	Description
year	integer	Calendar year (1990–2025).
state / state_name / state_fips	string	2-letter code, full name, FIPS code.
state_region / state_division	string	Census region / division.
producer_type	string	Reporting sector.
energy_source / energy_source_category	string	Source (Wind) and category (Renewable).
value_raw / value_unit	integer / string	Raw value and unit.
value_gwh / value_twh	number	Same value, scaled.
is_renewable / is_fossil / is_nuclear / is_zero_emission	boolean	Category flags.
is_recent_year	boolean	True when within the last 3 years.
rank_in_state	integer	Rank by value_gwh within the state for that year.
state_total_mwh	integer	Total state generation in the year (MWh).
source_share_of_state_pct	number	Source share of state total.
renewable_share_pct	number	Renewable share of state total.
fossil_share_pct	number	Fossil share of state total.
decade_change_pct	number	10-year change percentage.
yoy_change_pct	number	Year-over-year change percentage.
year_min / year_max	integer	Dataset coverage.
value_tier	string	very_high, high, medium, low, very_low.
resource	string	Normalised resource slug.

Pricing (pay-per-event)

• No subscription. Free monthly credits apply first.
• 1 result = $0.001 USD (about $1 per 1 000 results).
• Charged per item returned in the dataset; failed runs are not charged.

Source, licence, limits

• Source: US EIA Open Data API (https://www.eia.gov/opendata/browser/electricity/).
• Licence: EIA Open Data is free to use with attribution.
• Update frequency: monthly. This Actor reflects the upstream API at the moment of the run.
• Limits: requires no API key for the public endpoint; rate limits are generous but we use exponential backoff to be polite.

FAQ

Why is state_division empty for some states? Each state belongs to exactly one census division; some territories (PR, DC, VI) are not in the official divisions and may return null.

How is renewable_share_pct computed? It sums value_gwh for all records in the same (state, year) where is_renewable=true, divided by state_total_mwh. Non-energy records (e.g. hydroelectric pumped storage) are excluded.

What's value_tier? A categorical bucket of value_gwh (very_high, high, medium, low, very_low) — useful for legends and filters.

How do I get a full timeseries for one source? Leave year empty and filter by state + energy_source. The Actor returns every annual record.

Why does some years have gaps? EIA does not always publish every state×source×producer for every year — the Actor returns only what EIA provides.

How do I export to a chart? Run with state = "TX" and energy_source_category = "Renewable", then chart value_gwh over year in your tool of choice.

Other Actors from DevOne-Studio

• ted-tenders-api — TED (Tenders Electronic Daily) EU public procurement search.
• pdf-to-text-api — PDF to text + tables extraction via pdfplumber, no external calls.
• pubmed-articles-api — NCBI PubMed biomedical literature with MeSH/DOI/year filters.
• federal-register-api — US federal agency rules, proposed rules, notices, presidential docs.
• sec-company-tickers — Resolve SEC CIK from ticker or company name (10,400+ issuers).
• sec-edgar-fulltext-search-api — Full-text search across 35M+ SEC EDGAR filings and exhibits.
• sec-edgar-xbrl-frames-api — XBRL frames (Revenues, Assets, NetIncomeLoss) for ~6000 US issuers.
• cfpb-consumer-complaints-api — 18M+ US CFPB consumer complaints since 2011.
• nhtsa-safety-ratings-api — NHTSA NCAP 5-star vehicle safety ratings.
• openfda-udi-api — FDA Unique Device Identifier database by device/manufacturer.

Changelog

• 2026-10-12 — SEO metadata (seoTitle, seoDescription); README rewritten with real output sample, FAQ, cross-links.
• 2026-10-05 — Pricing switched to Apify pay-per-event ($0.001 per dataset item).
• 2026-09-30 — Initial public release on the Apify Store.