State and national climate

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.

# One series for one place (.json or .csv)
curl -s "https://api.climatedata.dev/v1/us-climate/tavg/usa.json"

# Every series and place in one file
curl -sO "https://api.climatedata.dev/v1/us-climate/download/us-climate.csv"

import polars as pl

# One series for one place
df = pl.read_csv("https://api.climatedata.dev/v1/us-climate/tavg/usa.csv")

# Every series and place, with series and location columns
everything = pl.read_parquet("https://api.climatedata.dev/v1/us-climate/download/us-climate.parquet")

const res = await fetch("https://api.climatedata.dev/v1/us-climate/tavg/usa.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.

• us-climate.csv CSV
• us-climate.parquet Parquet

Schema and series

Each series file has these columns. The bulk downloads add series and location columns in front.

Series

Locations

Covers all 57 US states and equivalents (ids: us- plus the USPS code (us-ca, us-dc)); 1 more named place.

Place names come from the shared location registry; see Sources.

Source and license

Source

NOAA Monthly U.S. Climate Divisional Database (nClimDiv), statewide and national files

Publisher

NOAA NCEI

License

US Government work (public domain in the United States) (LicenseRef-US-Government-Work)

Commercial use

Allowed

Credit the source with this exact text:

Checked every 1 day. If the source hasn't changed in 45 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/us-climate@<version>. The API reference describes each response.