EIA Energy Market & Fuel Price Tracker – Energy Data API

An EIA API v2 wrapper and energy-data feed that pulls any EIA series — gasoline and diesel prices, electricity generation, natural-gas storage, crude inventories and more — and normalizes each observation into a clean record with period, numeric value, units and dimensions. Use it to build an energy-price dashboard, a commodity signal, a utility/cleantech data feed, or macro-energy monitoring.

Who uses it

Energy traders and analysts, utilities and cleantech companies, logistics and fleet operators tracking fuel costs, and fintech/dashboard products.

Why this is worth charging for

EIA's v2 API is powerful but its route/facet/sort query model and mixed-shape rows are a barrier. This actor lets you point at any route with a facet filter and returns clean, numeric, deduplicated observations sorted newest-first, ready to chart or monitor on a schedule.

Output

Each dataset item is one normalized record:

{
  "route": "petroleum/pri/gnd",
  "period": "2024-05",
  "value": 3.612,
  "units": "$/GAL",
  "dimensions": {
    "duoarea": "NUS",
    "area-name": "U.S.",
    "product": "EPMR",
    "product-name": "Regular Gasoline"
  },
  "source": "EIA"
}

Input

Field	Description
apiKey	Free key from https://www.eia.gov/opendata/register.php. Required.
route	EIA v2 data route, e.g. petroleum/pri/gnd (gas prices), electricity/rto/region-data, natural-gas/stor/wkly.
frequency	e.g. weekly, monthly, annual (must match the route).
facetKey	Optional facet to filter by, e.g. duoarea, product, respondent.
facetValue	Value for the facet key, e.g. NUS for national.
start	Start period, format matching the frequency (e.g. 2023-01).
end	End period.
length	Observations per page (EIA max 5000).
maxPagesToScan	Pages per run.
onlyNewSinceLastRun	Recommended for schedules — skips records already returned by a previous run using persisted state, so you're only charged for genuinely new items.
maxItems	Stop after this many normalized records.

Pricing (Pay-Per-Event)

• query — $0.02, charged once per run for the API query/poll.
• observation-record — $0.005 per normalized record pushed. This is the primary event.
• apify-actor-start (Apify-managed) — covers baseline compute per run.

One run pulls hundreds to thousands of observations for a few dollars; scheduled runs to append the latest period cost pennies with onlyNewSinceLastRun.

Source & reliability

Data comes from the official api.eia.gov/v2 service; a free API key is required. Values are coerced to numbers and dimensions preserved. No proxies required. Run npm test for the offline self-test covering the normalizer, including edge cases and missing-field handling.

FAQ

Do I need an API key?

Yes — a free EIA key. It goes straight into the input.

Which series can I pull?

Any EIA v2 route — set route (and optional facet) to gas prices, electricity, natural gas, coal, renewables and more.

---

Need the rest of the record on these companies?

This actor returns one source. KYB Company Data Enrichment takes a company name and returns what the public record says about it across up to nine sources — state business registries, UCC lien filings, tax warrants and WARN layoff notices, the FMCSA motor-carrier census, the CMS NPI Registry, USAspending federal awards, EPA ECHO compliance, SEC EDGAR filings and CourtListener federal dockets.

Every enriched field carries its source and its match confidence. Only matches above the accept threshold are merged — anything weaker is surfaced as a suggestion and never folded into the record, because a false join is worse than returning nothing.

---

SEO keywords: EIA API, energy data API, gas price API, electricity generation data, natural gas storage feed, commodity energy scraper