API Access
Access dataset files directly from scripts, code, or AI agents.
Browse dataset files
API Access
Access dataset files directly from scripts, code, or AI agents.
Each file has a stable URL (r-link) that you can use directly in scripts, apps, or AI agents. These URLs are permanent and safe to hardcode.
Start with these files — they give you everything you need to understand and access the dataset.
- 1. Fetch datapackage.json to inspect schema and resources
- 2. Download data resources listed in datapackage.json
- 3. Read .beads/README.md for full context
Data Views
Global CO2 Emissions from Fossil Fuels since 1750
Data Files
Explore with AIfuel-breakdown
| Field | Type | Description |
|---|---|---|
| year | integer | |
| fuel | string | |
| emissions_mt | number | CO₂ emissions in megatonnes |
Download
Download CSVAbout
- Last updated
- 6 May 2026
- Total rows
- ...
- Format
- CSV
- File size
- 17.8 kB
global
| Field | Type | Description |
|---|---|---|
| Year | year | Year |
| Total | number | Total carbon emissions from fossil fuel consumption and cement production (million metric tons of C) |
| Gas Fuel | number | Carbon emissions from gas fuel consumption |
| Liquid Fuel | number | Carbon emissions from liquid fuel consumption |
| Solid Fuel | number | Carbon emissions from solid fuel consumption |
| Cement | number | Carbon emissions from cement production |
| Gas Flaring | number | Carbon emissions from gas flaring |
| Per Capita | number | Per capita carbon emissions (metric tons of carbon; after 1949 only) |
Download
Download CSVAbout
- Last updated
- 6 May 2026
- Total rows
- ...
- Format
- CSV
- File size
- 7.14 kB
About this dataset
Global CO2 emissions from fossil fuels annually since 1750 through 2024.
Data
Data comes from the Global Carbon Project (GCP) annual Global Carbon Budget release.
- Source: Andrew, R. M., & Peters, G. P. (2025). The Global Carbon Project's fossil CO2 emissions dataset (2025v15). Zenodo. https://doi.org/10.5281/zenodo.17417124
- Coverage: 1750–2024 (updated annually each December after the GCP release)
- Units:
global.csvvalues are in million metric tonnes of Carbon (MtC).data/fuel-breakdown.csvvalues are in million metric tonnes of CO2 (MtCO2).
Updating
Run the update script to fetch the latest GCP data:
python3 scripts/update.py
This fetches the GCP flat CSV from Zenodo, filters for global aggregates, converts units, and overwrites global.csv and data/fuel-breakdown.csv. A GitHub Actions workflow runs this automatically each December.
To update to a specific GCP release, edit the GCP_URL constant in scripts/update.py.
Citation
Please cite the upstream source as:
Andrew, R. M., & Peters, G. P. (2025). The Global Carbon Project's fossil CO2 emissions dataset (2025v15). Zenodo. https://doi.org/10.5281/zenodo.17417124
License
This Data Package is licensed by its maintainers under the Public Domain Dedication and License (PDDL).
Upstream data is licensed under Creative Commons Attribution 4.0 International (CC-BY 4.0).