Time series · national-fossil-co2
National fossil CO2 emissions
Annual fossil CO2 emissions for every country and the world from 1750, in total and by source (coal, oil, gas, cement, flaring, other carbonates), from the Global Carbon Project's fossil CO2 dataset in the Global Carbon Budget.
- Updates
- Yearly
- Coverage
- —
- Current version
- —
- Last published
- —
- Validation
- —
- License
- CC BY 4.0
- Commercial use
- Allowed
Chart
Use the API
Each series and location is its own small file. The examples follow the series and location picked above. See the docs for versions, caching and errors.
curl
# One series for one place (.json or .csv)
curl -s "https://api.carbondata.dev/v1/national-fossil-co2/total/gcb-international-aviation.json"
# Every series and place in one file
curl -sO "https://api.carbondata.dev/v1/national-fossil-co2/download/national-fossil-co2.csv"Python (polars)
import polars as pl
# One series for one place
df = pl.read_csv("https://api.carbondata.dev/v1/national-fossil-co2/total/gcb-international-aviation.csv")
# Every series and place, with series and location columns
everything = pl.read_parquet("https://api.carbondata.dev/v1/national-fossil-co2/download/national-fossil-co2.parquet")JavaScript
const res = await fetch("https://api.carbondata.dev/v1/national-fossil-co2/total/gcb-international-aviation.json");
if (!res.ok) throw new Error((await res.json()).detail); // errors are problem+json
const { meta, data } = await res.json();
console.log(meta.location_name, data.at(-1)); // { date, value, ... }Downloads
The whole dataset in one file, with series and location columns. Parquet keeps the column types and is much smaller.
- national-fossil-co2.csv CSV
- national-fossil-co2.parquet Parquet
Schema and series
Each series file has these columns. The bulk downloads add series and location columns in
front.
| Column | Type | Unit | Can be empty | Description |
|---|---|---|---|---|
| date | year (YYYY) | — | no | — |
| value | number | MtCO2 | no | Million tonnes of CO2 |
Series
| Series id | Name |
|---|---|
| total | Total fossil CO2 emissions |
| coal | Fossil CO2 emissions from coal |
| oil | Fossil CO2 emissions from oil |
| gas | Fossil CO2 emissions from gas |
| cement | Fossil CO2 emissions from cement (process emissions) |
| flaring | Fossil CO2 emissions from flaring (includes vented methane) |
| other | Fossil CO2 emissions from other carbonates |
Locations
Covers the world as a whole (id world); all 249 countries (ids: ISO 3166-1 alpha-3, lowercase (usa, twn)); 6 more named places.
| Location id | Name |
|---|---|
| gcb-international-aviation | International aviation (bunker fuels) |
| gcb-international-shipping | International shipping (bunker fuels) |
| gcb-kuwaiti-oil-fires | Kuwaiti oil fires |
| gcb-kosovo | Kosovo |
| gcb-pacific-islands-palau | Pacific Islands (Palau) |
| gcb-ryukyu-islands | Ryukyu Islands |
Place names come from the shared location registry; see Sources.
Source and license
- Source
- The Global Carbon Project's fossil CO2 emissions dataset (Global Carbon Budget)
- Publisher
- Global Carbon Project (Robbie M. Andrew and Glen P. Peters, CICERO)
- License
- Creative Commons Attribution 4.0 (
CC-BY-4.0) - Commercial use
- Allowed
Credit the source with this exact text:
Andrew, R. M., & Peters, G. P. The Global Carbon Project's fossil CO2 emissions dataset [Dataset]. Zenodo. https://doi.org/10.5281/zenodo.5569234 (all releases; each published version names the release file it was built from, e.g. GCB2025v15_MtCO2_flat.csv, https://doi.org/10.5281/zenodo.17417124). Source: Global Carbon Budget, Global Carbon Project; citation: Friedlingstein et al 2020 (DOI: 10.5194/essd-12-3269-2020). Licensed under Creative Commons Attribution 4.0 International. Changes: reshaped to one series per source; locations mapped to ISO 3166 ids; per capita figures and empty cells left out.
Checked every 7 days. If the source hasn't changed in 400 days, the status page flags it as stale.
Endpoints
Every URL for this dataset. To pin the current version, put it after the id:
/v1/national-fossil-co2@<version>.
The API reference describes each response.