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

Global methane and nitrous oxide

Loading the chart…
Source: NOAA GML.
Show the data as a table

The table appears once the data has loaded.

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.

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