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 README.md for full context
Data Views
Data Files
Explore with AItop-emitters
| Field | Type | Description |
|---|---|---|
| country | string | Name of the country |
| year | year | Calendar year of observation |
| total_mt | number | CO₂ emissions in megatonnes |
Download
Download CSVAbout
- CO₂ emissions (fossil fuel and cement) for the ten highest cumulative emitters since 1950, with annual totals in megatonnes. Derived from the main fossil-fuel-co2-emissions-by-nation dataset.
- Last updated
- 20 March 2026
- Total rows
- ...
- Format
- CSV
- File size
- 15 kB
fossil-fuel-co2-emissions-by-nation
| Field | Type | Description |
|---|---|---|
| Year | year | Year |
| Country | string | Nation |
| Total | integer | Total carbon emissions from fossil fuel consumption and cement production (million metric tons of C) |
| Solid Fuel | integer | Carbon emissions from solid fuel consumption |
| Liquid Fuel | integer | Carbon emissions from liquid fuel consumption |
| Gas Fuel | integer | Carbon emissions from gas fuel consumption |
| Cement | integer | Carbon emissions from cement production |
| Gas Flaring | integer | Carbon emissions from gas flaring; null for many countries where flaring data is unavailable |
| Per Capita | number | Per capita carbon emissions (metric tons of carbon; after 1949 only) |
| Bunker fuels (Not in Total) | integer | Carbon emissions from bunker fuels (not included in total) |
Download
Download CSVAbout
- Annual CO2 emissions from fossil fuel combustion and cement manufacture for over 200 nations, 1751–2020. Values are in thousand metric tons of carbon. Per-capita figures are only available from 1950 onwards. Gas Flaring values are null for many countries where flaring data is unavailable.
- Last updated
- 9 February 2026
- Total rows
- ...
- Format
- CSV
- File size
- 969 kB
About this dataset
Per Country CO2 Emissions from fossil-fuels annually since 1751 till 2020.
Data
Data comes from the Carbon Dioxide Information Analysis Center (CDIAC at AppState). original xlsx: https://rieee.appstate.edu/wp-content/uploads/2024/07/nation.1751_2020.xlsx
Preparation
The data was prepared by the datahub.io project. You could find it here:
https://datahub.io/core/co2-fossil-by-nation
On the github (including the processing script):
https://github.com/datasets/co2-fossil-by-nation
Data quirks
- Per Capita: values are only available from 1950 onwards; earlier rows contain null.
- Gas Flaring: null for many countries where flaring measurements are unavailable.
Citation
Please cite as:
Hefner, M., and G. Marland. 2023. Global, Regional, and National Fossil-Fuel CO2 Emissions: 1751-2020. CDIAC-FF, Research Institute for Environment, Energy, and Economics, Appalachian State University.
Automation
Automation is not required as the data is only up to 2020.
License
This Data Package is licensed by its maintainers under the Public Domain Dedication and License (PDDL).