eia_total_energy
Retrieve comprehensive U.S. energy data including production, consumption, imports, exports, and prices across all major energy sources from official government datasets.
Instructions
Get the monthly/annual U.S. energy overview — total production, consumption, imports, exports, and prices across all energy sources.
MSN codes:
ELETPUS: Electricity net generation
ELNIPUS: Electricity net imports
CLTCPUS: Coal consumption
NNTCPUS: Natural gas consumption
PATCPUS: All petroleum consumption
RETCPUS: Renewable energy consumption
NUETPUS: Nuclear electric power
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| msn | No | MSN code to filter by. Omit for overview of major categories. | |
| frequency | No | Frequency (default: monthly) | |
| start | No | Start date (YYYY-MM or YYYY). Default: 2 years ago | |
| end | No | End date (YYYY-MM or YYYY). Default: latest available | |
| length | No | Max rows (API max: 5000). Omit to let date range control volume. | |
| offset | No | Row offset for pagination |