Total Energy — U.S. (EIA)

Catalog

Browse and search all available datasets.

• Catalog — browse all datasets
• GET /api/catalog — catalog in JSON
• GET /api/catalog?q=… — search the catalog

Dataset API

Endpoints for this dataset — schema, filter values, preview, and querying.

• GET /api/datasets/eia_total — schema and filters
• Sample preview (table) · GET /api/datasets/eia_total/sample — free sample (up to 100 rows)
• GET /api/datasets/eia_total/members/{col} — valid values for a filterable column
• GET /api/datasets/eia_total/query — query with filters (API key required)

Access

BotMarket is free — query this dataset at no cost.

• Get your free API key — one per email, no payment required
• GET /api/datasets/eia_total/query — query with your key as Bearer token

Source

Name

U.S. Energy Information Administration - Total Energy

URL

https://www.eia.gov/opendata/

License

Public Domain (U.S. Government)

Size and Format

Rows

560,570

Columns

7

Size (bytes)

2,036,296

Formats

parquet, csv

Access

Queries

Free

Max rows per query

1000

Free sample

Yes

Temporal Coverage

end

2025

start

1949

frequency

monthly

Geographic Coverage

level

country

coding

n/a

region

usa

Query Filters

Columns you can use as query params in GET /api/datasets/eia_total/query.

• series_id Members (JSON)
• frequency Members (JSON)
• year Members (JSON)

Schema (Columns)