Time series · greenhouse-gases
Global methane and nitrous oxide
Monthly global mean atmospheric methane (from July 1983) and nitrous oxide (from January 2001) at the marine surface, from NOAA's global air sampling network, with the seasonal-cycle-removed trend.
- Updates
- Monthly
- Coverage
- —
- Current version
- —
- Last published
- —
- Validation
- —
- License
- US Government work
- 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.climatedata.dev/v1/greenhouse-gases/ch4/world.json"
# Every series and place in one file
curl -sO "https://api.climatedata.dev/v1/greenhouse-gases/download/greenhouse-gases.csv" Python (polars)
import polars as pl
# One series for one place
df = pl.read_csv("https://api.climatedata.dev/v1/greenhouse-gases/ch4/world.csv")
# Every series and place, with series and location columns
everything = pl.read_parquet("https://api.climatedata.dev/v1/greenhouse-gases/download/greenhouse-gases.parquet") JavaScript
const res = await fetch("https://api.climatedata.dev/v1/greenhouse-gases/ch4/world.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.
- greenhouse-gases.csv CSV
- greenhouse-gases.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 | month (YYYY-MM) | — | no | — |
| value | number | ppb | no | Dry-air mole fraction in nanomol/mol |
| uncertainty | number | ppb | yes | NOAA's estimated uncertainty of the monthly value |
Series
| Series id | Name |
|---|---|
| ch4 | Methane (CH4), monthly global mean |
| ch4-trend | Methane (CH4), monthly global mean with the average seasonal cycle removed |
| n2o | Nitrous oxide (N2O), monthly global mean |
| n2o-trend | Nitrous oxide (N2O), monthly global mean with the average seasonal cycle removed |
Locations
Covers one place.
| Location id | Name |
|---|---|
| world | Global marine surface average |
Source and license
- Source
- NOAA Global Monitoring Laboratory, Trends in Atmospheric Methane and Nitrous Oxide
- Publisher
- NOAA GML
- License
- US Government work (public domain in the United States) (
LicenseRef-US-Government-Work) - Commercial use
- Allowed
Credit the source with this exact text:
Lan, X., K.W. Thoning, and E.J. Dlugokencky: Trends in globally-averaged CH4, N2O, and SF6 determined from NOAA Global Monitoring Laboratory measurements. Version of the retrieved_at month of this dataset version, https://doi.org/10.15138/P8XG-AA10
Checked every 1 day. If the source hasn't changed in 60 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/greenhouse-gases@<version>.
The API reference describes each response.
| What | URL |
|---|---|
| Metadata: version, coverage, downloads, validation | /v1/greenhouse-gases |
| Versions and monthly snapshots | /v1/greenhouse-gases/versions |
| Series and locations | /v1/greenhouse-gases/locations |
| Methane (CH4), monthly global mean (JSON) | /v1/greenhouse-gases/ch4/{location}.json |
| Methane (CH4), monthly global mean (CSV) | /v1/greenhouse-gases/ch4/{location}.csv |
| Methane (CH4), monthly global mean with the average seasonal cycle removed (JSON) | /v1/greenhouse-gases/ch4-trend/{location}.json |
| Methane (CH4), monthly global mean with the average seasonal cycle removed (CSV) | /v1/greenhouse-gases/ch4-trend/{location}.csv |
| Nitrous oxide (N2O), monthly global mean (JSON) | /v1/greenhouse-gases/n2o/{location}.json |
| Nitrous oxide (N2O), monthly global mean (CSV) | /v1/greenhouse-gases/n2o/{location}.csv |
| Nitrous oxide (N2O), monthly global mean with the average seasonal cycle removed (JSON) | /v1/greenhouse-gases/n2o-trend/{location}.json |
| Nitrous oxide (N2O), monthly global mean with the average seasonal cycle removed (CSV) | /v1/greenhouse-gases/n2o-trend/{location}.csv |
| Whole dataset (CSV) | /v1/greenhouse-gases/download/greenhouse-gases.csv |
| Whole dataset (Parquet) | /v1/greenhouse-gases/download/greenhouse-gases.parquet |