EIA US Energy Data Search

Pricing

Rating

Developer

Actor stats

Categories

Share

US energy data from the Energy Information Administration: electricity prices, natural gas, petroleum, and state energy profiles.

What does this actor do?

This actor queries the EIA Open Data API v2 across multiple energy datasets to build a comprehensive energy intelligence report:

1. Electricity Retail Sales — Prices, revenue, sales volume, and customer counts by state and sector (residential, commercial, industrial)
2. Natural Gas Prices — Spot prices, wellhead prices, and consumer prices
3. Petroleum Prices — Weekly retail gasoline and diesel prices (regular, midgrade, premium)
4. State Energy Profiles (SEDS) — Annual state-level production, consumption, prices, and expenditures

Each report includes a market insight score assessing energy cost conditions based on residential and industrial electricity prices.

Input parameters

Output format

{
"reportType":"comprehensive",
"electricity":{
"records":[
{
"period":"2025-12",
"state":"CA",
"sector":"RES",
"price":28.52,
"sales":24680.3,
"revenue":4521.5,
"customers":14200000,
"priceUnits":"cents per kilowatt-hour"
}
],
"summary":{
"avgResidentialPrice":22.05,
"topExpensiveStates":[
{"state":"CA","price":28.52}
]
}
},
"naturalGas":{
"records":[
{
"period":"2025-11",
"description":"Henry Hub Natural Gas Spot Price",
"value":3.42,
"unit":"Dollars per Million Btu"
}
]
},
"petroleum":{
"records":[
{
"period":"2025-12",
"description":"Weekly US Regular Gasoline Retail Price",
"value":3.24,
"unit":"Dollars per Gallon"
}
]
},
"marketInsight":{
"score":40,
"level":"Moderate",
"factors":[
"High avg residential electricity: 22.05 cents/kWh (-15)",
"Low avg industrial electricity: 7.82 cents/kWh (+8)"
]
}
}

Market insight scoring

Energy cost assessment (0–100):

Levels: Favorable (65+), Moderate (45–64), Elevated (25–44), High Cost (<25)

Use cases

• Energy analysts: Track electricity, gas, and petroleum price trends
• Businesses: Compare energy costs across states for site selection
• Economists: Monitor energy market conditions and price inflation
• Utilities: Benchmark rates against national and state averages
• Policy researchers: Analyze energy affordability by state and sector
• Commodity traders: Track natural gas and petroleum price movements

API key

Register for a free EIA API key at https://www.eia.gov/opendata/register.php

Without an API key, the actor returns realistic sample data in dry run mode.

Data sources

US Energy Information Administration (EIA) Open Data API v2:

• electricity/retail-sales — Electricity prices, sales, revenue by state/sector
• natural-gas/pri/sum — Natural gas price summaries
• petroleum/pri/gnd — Petroleum retail prices (gasoline, diesel)
• seds — State Energy Data System (consumption, production, expenditures)