parsimony-eia

U.S. Energy Information Administration (EIA) connector — fetches energy data (petroleum, electricity, natural gas, coal, renewables) from the EIA v2 Open Data API.

Part of the parsimony-connectors monorepo. Distributed standalone on PyPI as parsimony-eia.

Connectors

Coverage

The catalog indexes all 232 leaf datasets across EIA's 14 top-level categories (petroleum, natural gas, electricity, coal, nuclear, renewables/ densified-biomass, total energy, emissions, international, SEDS, STEO, AEO, IEO, crude-oil imports), each carrying its measure and facet-dimension manifest. EIA's full series universe (~2M series) is the facet cartesian product of those datasets — too large to catalog individually, but every series is fetchable: by route + facets filters, or by its legacy series id via eia_fetch_series. So discovery is at the dataset tier and access is total.

EIA caps every data response at 5,000 rows; the fetch connectors page through to completeness automatically (a request matching more than 300,000 rows is refused with guidance to narrow it). Data is U.S. federal public domain — cite as "Source: U.S. Energy Information Administration".

Install

pip install parsimony-eia

Pulls in a compatible parsimony automatically. Verify discovery:

python -c "from parsimony import discover; print([p.name for p in discover.iter_providers()])"

Configuration

Set the following environment variable:

export EIA_API_KEY="<your-key>"

Get a free key at https://www.eia.gov/opendata/register.php.

Quick start

from parsimony_eia import CONNECTORS

result = CONNECTORS["eia_fetch"](route="petroleum/pri/spt", frequency="monthly")
print(result.raw.head())

For multi-plugin composition:

from parsimony import discover

connectors = discover.load_all()

Provider

• Homepage: https://www.eia.gov
• API docs: https://www.eia.gov/opendata/documentation.php

License

See LICENSE.