Pricing

Rating

Developer

Actor stats

Categories

Share

EIA Energy Data Scraper

Extract structured energy data from the US Energy Information Administration (EIA) API v2. Access petroleum gasoline and diesel prices, natural gas spot prices, coal production, electricity generation and retail rates, nuclear reactor outages, state-level energy statistics, crude oil imports, and short-term energy outlook projections — all from a single Actor.

This Actor wraps the official EIA open data API and provides full support for pagination, facet filtering, date range queries, and route discovery. Output is delivered as clean, camelCase-normalized JSON ready for dashboards, analytics pipelines, and RAG ingestion.

Features

How to Scrape EIA Energy Data

Step 1: Get an API Key (Recommended)

Register for a free API key at eia.gov/opendata/register.php. The DEMO_KEY works for testing but is rate-limited to 30 requests per hour.

Step 2: Discover Available Data Routes

Set the route to your category of interest (e.g., petroleum) and leave subRoute empty. The Actor will return all available sub-routes with descriptions:

{
"route":"petroleum",
"subRoute":"",
"maxResults":100
}

This returns items like:

• pri — Prices (gasoline, diesel, spot, futures, heating oil)
• sum — Summary (supply, disposition, production)
• crd — Crude Reserves and Production
• stoc — Stocks
• cons — Consumption/Sales

Step 3: Drill Into a Sub-Route

Set the subRoute to drill deeper. For example, pri under petroleum has further sub-routes:

{
"route":"petroleum",
"subRoute":"pri",
"maxResults":100
}

Step 4: Fetch Data

Once you reach a data endpoint, provide frequency, data columns, and optional facets:

{
"apiKey":"YOUR_EIA_API_KEY",
"route":"petroleum",
"subRoute":"pri/gnd",
"frequency":"weekly",
"dataColumns":["value"],
"facets":{
"product":["EPM0"],
"duoarea":["NUS"]
},
"startDate":"2024-01",
"maxResults":100
}

Input Parameters

Output Example

Each data record is output as a normalized JSON object:

{
"period":"2026-03-09",
"duoarea":"NUS",
"areaName":"U.S.",
"product":"EPM0",
"productName":"Total Gasoline",
"process":"PTE",
"processName":"Retail Sales",
"series":"EMM_EPM0_PTE_NUS_DPG",
"seriesDescription":"U.S. All Grades All Formulations Retail Gasoline Prices (Dollars per Gallon)",
"value":3.633,
"units":"$/GAL",
"frequency":"weekly"
}

When in browse/discovery mode (no subRoute), the output contains route metadata:

{
"type":"route",
"routeId":"pri",
"routeName":"Prices",
"routeDescription":"Petroleum price data...",
"fullPath":"petroleum/pri",
"hint":"Set subRoute to \"pri\" to browse deeper."
}

Common Data Routes

Pricing

• Per result: $0.002 per data record
• Actor start: Free (default platform event cost applies)
• Users pay standard Apify compute costs on top of per-result pricing

Typical costs: 1,000 petroleum price records costs approximately $2.00 in Actor fees plus minimal compute (~$0.01).

Use Cases

• Commodity Trading Dashboards: Track weekly gasoline, diesel, and crude oil price movements
• Energy Analytics Pipelines: Ingest petroleum supply/demand data into BI tools
• Utility Planning: Monitor state-level electricity generation and consumption trends
• ESG Reporting: Pull CO2 emissions and renewable energy data by state
• Academic Research: Access decades of historical energy production and pricing data
• RAG/LLM Pipelines: Feed normalized energy data into retrieval-augmented generation systems

Integrations

Connect this Actor with Zapier, Make, Google Sheets, or use the Apify API to schedule runs and retrieve data programmatically.

FAQ

Is it legal to scrape EIA energy data?

Yes. This Actor uses the official EIA Open Data API, a free public government data service provided by the U.S. Energy Information Administration. The data is in the public domain and freely available for any use. A free API key is recommended for higher rate limits.

How Much Does It Cost to Scrape EIA Energy Data?

See the pricing table above. At $0.002 per result, fetching 1,000 petroleum price records costs approximately $2.00 in Actor fees plus minimal Apify compute costs.

Can I export EIA data to Excel or CSV?

Yes. Apify supports exporting results in JSON, CSV, Excel, XML, and other formats directly from the Dataset tab after a run completes.

How often is the EIA data updated?

Update frequency varies by dataset. Petroleum prices are updated weekly, natural gas data monthly, and electricity data monthly or quarterly. You can schedule this Actor to run at any interval.

What data categories are available?

The EIA API provides 14 data categories including petroleum, natural gas, coal, electricity, nuclear outages, state energy data (SEDS), short-term energy outlook (STEO), international energy data, crude oil imports, total energy, and CO2 emissions.

Other Scrapers by SeatSignal

• NREL Alternative Fuel Stations Scraper — Extract EV charging and alternative fuel station data
• Fuel Economy Scraper — Extract EPA fuel economy and MPG data for any vehicle
• EnergyStar Scraper — Extract certified energy-efficient product data
• EPA TRI Scraper — Extract toxic release inventory data from the EPA
• NRC Reactor Status Scraper — Extract nuclear reactor status data

Legal Disclaimer

This Actor accesses the publicly available EIA Open Data API. The US Energy Information Administration provides this data freely for public use. Users are responsible for complying with the EIA API Terms of Service. Rate limits should be respected — register for a free API key to avoid DEMO_KEY throttling. This Actor does not bypass any authentication or access controls.

Support

For issues or feature requests, contact the developer through the Apify Store or open an issue on the Actor's page.