EIA US Energy Data Search

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

Parameter	Type	Description
apiKey	string	EIA API key (free at https://www.eia.gov/opendata/register.php)
dryRun	boolean	Return sample data (default: true unless apiKey provided)
sector	string	all, electricity, natural-gas, petroleum, or coal
state	string	Two-letter state abbreviation
frequency	string	weekly, monthly, quarterly, or annual
dateFrom	string	Start date (YYYY-MM or YYYY)
dateTo	string	End date (YYYY-MM or YYYY)
includeElectricity	boolean	Include electricity data (default: true)
includeNaturalGas	boolean	Include natural gas data (default: true)
includePetroleum	boolean	Include petroleum data (default: true)
includeStateProfiles	boolean	Include SEDS state profiles (default: false)
maxResults	integer	Max records per dataset (1–5000, default: 500)

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):

Factor	Impact
Residential electricity > 20 cents/kWh	-15
Residential electricity > 15 cents/kWh	-5
Residential electricity < 10 cents/kWh	+10
Industrial electricity > 12 cents/kWh	-10
Industrial electricity < 6 cents/kWh	+8

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)