Skip to content

NOAA datasets

Provider access notes.

Released is included in usdata 0.34.0. Source only is implemented in this checkout and requires a source installation. Planned cannot fetch data yet.

Implemented datasets

Dataset Availability Files What gets selected
Whole monthly station records, one file per station Released CSV One whole file per named station, every month and element it holds
Storm Events details, fatalities, and locations Released gzip CSV Whole annual archives of one table; filter rows locally after downloading
SPC tornado, hail, and wind databases Released CSV Whole annual, half-decade, or decade files of one table; filter rows locally after downloading
NWS warnings and watches by county Released CSV Events issued for one county or UGC inside an inclusive UTC window; optionally one event type
NWS watch, warning, and advisory polygons and areas Source only zipped shapefile and CSV (no reader) Events starting inside an inclusive UTC window, one zip per UTC month; optionally one state or offices, event types, and polygon options
SPC convective and fire weather outlook areas Source only zipped shapefile (no reader) Outlooks issued inside an inclusive UTC window, one zip per UTC month; optionally outlook types, days, and geometry form
MRMS gridded radar products Released GRIB2 (gzipped) Whole two-minute CONUS grids of one product by inclusive UTC file stamp, at most one day
Tropical cyclone best tracks Released HURDAT2 fixed-format text The newest or a named revision of one whole basin file; filter track points locally
Global tropical cyclone best tracks Released CSV with a units row, NetCDF4 One whole subset file per query, from the newest or a pinned product version
Seasonal El Niño indices, the official RONI and the traditional ONI Released whitespace-delimited text (no reader) One whole index table, every season from DJF 1950; select seasons locally
Monthly global 2 degree sea surface temperature since 1850 Released NetCDF4 Whole global monthly files, one for every month the window touches
Sea-surface temperature Released CSV with units row Grid centers and timestamps inside the requested bounds; optional stride
Post-event aerial imagery tiles Released GeoTIFF Whole GeoTIFFs of one event folder, optionally by subfolder and by the footprint that tile names give

NCEI Access Data Service

Dataset Availability Files What gets selected
Daily station weather Released CSV Station observations within inclusive calendar dates; selected elements
Monthly station climate Released CSV Complete UTC calendar months touched by the query; station and element filters
Annual station climate Released CSV Complete UTC calendar years touched by the query; station and element filters
Hourly airport observations Released CSV Every report on whole calendar days per station; optional column filters
30-year station climate normals Released CSV Hourly, daily, monthly, or annual/seasonal normals per station; optional month-day window except annual/seasonal; hourly returns whole days

NWS Damage Assessment Toolkit (DAT)

Dataset Availability Files What gets selected
Photos from NWS damage surveys, one file per damage point attachment Released JPEG, PNG Each JPEG or PNG attached to a damage point with storm time in an inclusive UTC window of at most 7 days
NWS damage survey points, tornado tracks, and damage areas Released GeoJSON One layer's features with storm time in an inclusive UTC window, optionally in a box; one page per object-id run

Next Generation Weather Radar (NEXRAD)

Dataset Availability Files What gets selected
NEXRAD radar scans Released NEXRAD Level II Whole radar scans by site and inclusive UTC scan-start time
NEXRAD derived radar products Released NEXRAD Level III (no reader) Whole product files by site, product code, and inclusive UTC scan time since 2020-03-30

GOES-R Series

Dataset Availability Files What gets selected
GOES ABI imagery, multiband scenes, and cloud-top products Released NetCDF4 Whole scenes of one ABI product by inclusive UTC scan-start time, with one channel or mesoscale sector where the product has them
GOES lightning detections Released NetCDF4 Whole 20-second detection files by inclusive UTC file-start time, at most one day

NCEP model output

Dataset Availability Files What gets selected
GFS model output Released GRIB2 Global files, whole or by named GRIB2 message, chosen by run initialization window, cycle hour, forecast hours, and grid resolution
HRRR model output Released GRIB2 CONUS files, whole or by named GRIB2 message, chosen by run initialization window, cycle hour, forecast hours, and file variant
NBM forecast guidance Released GRIB2 Regional core files, whole or by named GRIB2 message, chosen by run initialization window, cycle hour, forecast hours, and region
RAP model output Released GRIB2 Files, whole or by named GRIB2 message, chosen by run initialization window, cycle hour, forecast hours, and file family

CO-OPS Data API

Dataset Availability Files What gets selected
Coastal current speed and direction Released CSV Native six-minute observations for one station and explicit bin; at most 28 days
Coastal water levels Released CSV Six-minute observations for one station and datum; at most 28 days
Coastal tide predictions Released CSV Predictions for one station and datum on a chosen interval; at most a year

Planned datasets

These entries are not implemented; they cannot fetch data.

noaa:ghcn-hourly

GHCN-Hourly Station Observations · Planned · target later

Global hourly and sub-hourly surface observations, the successor to ISD. Published as per-station and per-year bulk files by NCEI; the exact access path has not been confirmed yet and must be verified before an adapter is built.

Upstream information Domain: Surface weather.

noaa:igra

IGRA Radiosonde Observations · Planned · target later

Integrated Global Radiosonde Archive version 2: observed upper-air soundings from 2,931 stations as one zipped fixed-width text file per station for its full period of record (about 81 MB for Norman, Oklahoma), plus year-to-date and derived-parameter directories, from an NCEI HTTPS directory. Needs a fixed-width sounding reader.

Upstream information Domain: Surface weather.

noaa:nclimdiv

nClimDiv Climate Divisional Data · Planned · target later

Monthly temperature, precipitation, and drought indices for U.S. climate divisions, states, and regions since 1895, as fixed-width text files in an NCEI monitoring-content directory refreshed monthly.

Upstream information Domain: Climate.

noaa:sea-ice-index

Sea Ice Index · Planned · target later

Daily and monthly Arctic and Antarctic sea ice extent and concentration (NOAA@NSIDC G02135) as CSV, GeoTIFF, and shapefiles in an HTTPS directory hosted by NSIDC.

Upstream information Domain: Snow and ice.

noaa:oisst

OISST Daily Sea Surface Temperature · Planned · target later

Optimum Interpolation SST v2.1: daily global 0.25 degree analysis since September 1981 as one NetCDF per day, from the NOAA CDR S3 bucket (data/v2.1/avhrr/YYYYMM/) or the NCEI HTTPS mirror.

Upstream information Domain: Ocean physics.

noaa:ocads

Ocean Carbon and Acidification Data System · Planned · target later

Archived ocean carbon, pH, and related chemistry datasets (cruises, moorings, syntheses such as SOCAT and GLODAP) in an NCEI HTTPS directory organized by accession.

Upstream information Domain: Ocean chemistry.

noaa:etopo

ETOPO 2022 Global Relief · Planned · target later

Global topography and bathymetry at 15, 30, and 60 arc-seconds as NetCDF and GeoTIFF tiles, served through the NCEI THREDDS catalog with OPeNDAP access; the THREDDS pattern.

Upstream information Domain: Bathymetry and hydrography.

noaa:billion-dollar-disasters

Billion-Dollar Weather and Climate Disasters · Planned · target later

NCEI's list of U.S. disasters with CPI-adjusted and unadjusted costs, dates, and deaths since 1980, served as one CSV with two header comment lines from the NCEI access service (about 36 kB for all events).

Upstream information Domain: Natural hazards.

noaa:tsunami-events

Global Historical Tsunami Database · Planned · target later

Tsunami source events and runup observations since 2100 BCE from NCEI, served as JSON by the HazEL hazard-service API with year, magnitude, and location filters.

Upstream information Domain: Natural hazards.

World Data Service for Paleoclimatology · Planned · target later

Proxy climate records (tree rings, ice cores, sediments, corals) with a JSON study-search API from NCEI that returns study metadata and data file URLs filtered by data type, region, and time span.

Upstream information Domain: Paleoclimate.

noaa:swpc-realtime

SWPC Real-Time Space Weather Products · Planned · target later

Planetary K index, solar wind, and other real-time indices as small JSON files from the Space Weather Prediction Center services host. Rolling recent windows only; historical archives live elsewhere.

Upstream information Domain: Space weather.

noaa:cdr-ndvi

NDVI Climate Data Record · Planned · target later

Daily global normalized difference vegetation index from AVHRR and VIIRS since 1981, one NetCDF per day in the public noaa-cdr-ndvi-pds S3 bucket laid out as data/YYYY/.

Upstream information Domain: Land and environment.