Crude Oil Imports API — EIA Monthly by Country & Grade
Who sells crude to the United States, how much, and what quality? This API serves the official EIA company-level import statistics aggregated by origin and grade, as clean versioned JSON with monthly history since 2009. The market stories are right there in the data: Canada's ~70% dominance, the Venezuela embargo gap (May 2019 - January 2023) and Guyana's arrival in 2020. **What you get** -…
2 subscribers
8.6/10 popularity
447 ms avg latency
100% success rate
8 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Crude Oil Imports API — EIA Monthly by Country & Grade endpoints
| Method | Endpoint | Description |
|---|---|---|
| imports | ||
| GET |
/v1/imports/{origin}/history /v1/imports/{origin}/history |
Period-range pagination (keyset): request the next page by passing `meta.next_end` as the `end` parameter. `next_end` is null on the last page. Periods are calendar months… |
| GET |
/v1/imports/latest /v1/imports/latest |
For each origin, the all-grades total of its most recent month, ordered by volume — who sold the US how much crude, in one call. Rows carry `grade: all` (the sum of the five… |
| GET |
/v1/imports/{origin} /v1/imports/{origin} |
|
| Other endpoints | ||
| GET |
/health/deep /health/deep |
Verifies database connectivity and that the latest world-total month is at most 130 days old (threshold calibrated to the monthly release calendar and its two-month data lag).… |
| GET |
/v1/imports/latest /v1/imports/latest |
For each origin, the all-grades total of its most recent month, ordered by volume — who sold the US how much crude, in one call. Rows carry `grade: all` (the sum of the five… |
| GET |
/v1/imports/{origin} /v1/imports/{origin} |
|
| GET |
/health /health |
Cheap process check. Does not touch the database. Not rate limited. |
| GET |
/v1/imports/{origin}/history /v1/imports/{origin}/history |
Period-range pagination (keyset): request the next page by passing `meta.next_end` as the `end` parameter. `next_end` is null on the last page. Periods are calendar months… |
Crude Oil Imports API — EIA Monthly by Country & Grade pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO Recommended | $9.99 / month | 60 / minute |
|
| ULTRA | $29.99 / month | 240 / minute |
|
