NOAA Climate Data Online API

www.ncdc.noaa.gov · Science

Science API Key Free Tier Climate Weather Historical Data

US National Oceanic and Atmospheric Administration — access 1.4 billion historical climate observations. Temperature, precipitation, wind, and more from 100,000+ stations. Free API token.

Authentication

API Key Free API token at ncdc.noaa.gov/cdo-web/token. Pass as token header.

Sample Requests

GET Get datasets

List available climate datasets.

https://www.ncdc.noaa.gov/cdo-web/api/v2/datasets

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

token

YOUR_TOKEN

curl -X GET "https://www.ncdc.noaa.gov/cdo-web/api/v2/datasets" \
  -H "token: YOUR_TOKEN"

import requests
headers = {
    "token": "YOUR_TOKEN"
}
response = requests.get(
    "https://www.ncdc.noaa.gov/cdo-web/api/v2/datasets",
    headers=headers,
)
print(response.json())

const url = 'https://www.ncdc.noaa.gov/cdo-web/api/v2/datasets';

const response = await fetch(url, {
  headers: {
    'token': 'YOUR_TOKEN'
  },
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://www.ncdc.noaa.gov/cdo-web/api/v2/datasets"
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("token", "YOUR_TOKEN")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://www.ncdc.noaa.gov/cdo-web/api/v2/datasets")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["token"] = "YOUR_TOKEN"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://www.ncdc.noaa.gov/cdo-web/api/v2/datasets";
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "token: YOUR_TOKEN"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Get historical data

Get max temperature for NYC (JFK) in Jan 2023.

https://www.ncdc.noaa.gov/cdo-web/api/v2/data?units=metric&enddate=2023-01-07&datasetid=GHCND&startdate=2023-01-01&stationid=GHCND:USW00094728&datatypeid=TMAX

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

token

YOUR_TOKEN

curl -X GET "https://www.ncdc.noaa.gov/cdo-web/api/v2/data?units=metric&enddate=2023-01-07&datasetid=GHCND&startdate=2023-01-01&stationid=GHCND%3AUSW00094728&datatypeid=TMAX" \
  -H "token: YOUR_TOKEN"

import requests
params = {
    "units": "metric",
    "enddate": "2023-01-07",
    "datasetid": "GHCND",
    "startdate": "2023-01-01",
    "stationid": "GHCND:USW00094728",
    "datatypeid": "TMAX"
}
headers = {
    "token": "YOUR_TOKEN"
}
response = requests.get(
    "https://www.ncdc.noaa.gov/cdo-web/api/v2/data",
    params=params,
    headers=headers,
)
print(response.json())

const url = new URL('https://www.ncdc.noaa.gov/cdo-web/api/v2/data');
url.searchParams.set('units', 'metric');
url.searchParams.set('enddate', '2023-01-07');
url.searchParams.set('datasetid', 'GHCND');
url.searchParams.set('startdate', '2023-01-01');
url.searchParams.set('stationid', 'GHCND:USW00094728');
url.searchParams.set('datatypeid', 'TMAX');

const response = await fetch(url, {
  headers: {
    'token': 'YOUR_TOKEN'
  },
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://www.ncdc.noaa.gov/cdo-web/api/v2/data")
	q := baseURL.Query()
	q.Set("units", "metric")
	q.Set("enddate", "2023-01-07")
	q.Set("datasetid", "GHCND")
	q.Set("startdate", "2023-01-01")
	q.Set("stationid", "GHCND:USW00094728")
	q.Set("datatypeid", "TMAX")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("token", "YOUR_TOKEN")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://www.ncdc.noaa.gov/cdo-web/api/v2/data")
uri.query = URI.encode_www_form({
  "units" => "metric",
  "enddate" => "2023-01-07",
  "datasetid" => "GHCND",
  "startdate" => "2023-01-01",
  "stationid" => "GHCND:USW00094728",
  "datatypeid" => "TMAX"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["token"] = "YOUR_TOKEN"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://www.ncdc.noaa.gov/cdo-web/api/v2/data?" . http_build_query([
    "units" => "metric",
    "enddate" => "2023-01-07",
    "datasetid" => "GHCND",
    "startdate" => "2023-01-01",
    "stationid" => "GHCND:USW00094728",
    "datatypeid" => "TMAX"
]);
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "token: YOUR_TOKEN"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

Get a free API token at ncdc.noaa.gov/cdo-web/token
Pass as token: YOUR_TOKEN header (not Authorization!)
Find stations: GET /stations?locationid=FIPS:US&limit=10
Datasets: GHCND=daily, GSOM=monthly, GSOY=annual
Datatypes: TMAX, TMIN, PRCP, SNOW, AWND

Open documentation ↗