International Energy Data (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_intl — schema, filters, and pricing
• Sample preview (table) · GET /api/datasets/eia_intl/sample — free sample (up to 100 rows)
• GET /api/datasets/eia_intl/members/{col} — valid values for a filterable column
• GET /api/datasets/eia_intl/query — query with filters (API key required)

Purchase

Add balance or buy access to start querying.

• POST /api/checkout/x402 — agents: add balance via x402 (USDC)
• Sign in at /account — humans: add balance via Stripe (card, Apple Pay, bank transfer)
• POST /api/ap2/intent → /api/ap2/purchase — agents: AP2 mandate-based payment

Source

Name

U.S. Energy Information Administration - International Energy Data

URL

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

License

Public Domain (U.S. Government)

Size and Format

Rows

3,475,287

Columns

11

Size (bytes)

12,288,947

Formats

parquet, csv

Pricing

Per query (USD)

0.0100 USD

Max rows per query

1000

Free

No

Free sample

Yes

Temporal Coverage

end

2025

start

1949

frequency

annual

Geographic Coverage

level

country

coding

ISO Alpha-3

region

global

Query Filters

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

• series_id Members (JSON)
• geography Members (JSON)
• product_code Members (JSON)
• flow_code Members (JSON)
• year Members (JSON)

Schema (Columns)