WeatherPower logoWeatherPower Developers

SOUNDING API · FREE

Atmospheric soundings for any point in the US.

The same data behind WeatherPower Radar's point soundings: NOAA HRRR model profiles and the nearest real weather balloon, as clean JSON or a finished SounderPy chart.

  • HRRRAnalysis + forecast hours F000–F018, 39 pressure levels, 3 km grid
  • BalloonsNearest NWS radiosonde launch (00Z / 12Z), with skipped launches noted
  • ImagesFull Skew-T + hodograph PNGs rendered with SounderPy
  • CostFree for non-commercial use, with attribution
Get a free API keyEmail sign-up. Key in under a minute.
Example SounderPy sounding: HRRR F006 forecast profile near Idabel, Oklahoma
HRRR F006 near Idabel, OK, from /v1/sounding.png

Quick start

Send your key in the X-API-Key header (or ?key=). Coordinates are decimal degrees.

JSON — observed + HRRR forecast profiles
curl -H "X-API-Key: wp_your_key" \
  "https://weatherpower.app/wpcc-api/v1/sounding?lat=35.22&lon=-97.44&hours=6"
PNG — SounderPy chart for one forecast hour
curl -H "X-API-Key: wp_your_key" -o sounding.png \
  "https://weatherpower.app/wpcc-render/v1/sounding.png?lat=35.22&lon=-97.44&fhr=3"
JavaScript
const res = await fetch("https://weatherpower.app/wpcc-api/v1/sounding?lat=33.9&lon=-94.83", {
  headers: { "X-API-Key": "wp_your_key" },
});
const { observed, forecast } = await res.json();
// forecast.profiles[0].levels → [{ p, z, t, td, wd, ws }, …]  (hPa, m, °C, °, kt)

Endpoints

All responses are JSON unless noted. Errors look like {"error": "…"} with a matching HTTP status.

Base URLs: https://weatherpower.app/wpcc-api for JSON/account endpoints · https://weatherpower.app/wpcc-render for rendered sounding images.

PathParametersReturns
GEThttps://weatherpower.app/wpcc-api/v1/soundinglat, lon, model hrrr|gfs, hours 1–48 (hrrr) / 1–120 (gfs), include observed,forecastobserved: nearest balloon (station, distance, levels, derived). forecast: hourly model profiles with model CAPE/CIN/LI and derived indices.
GEThttps://weatherpower.app/wpcc-render/v1/sounding.pnglat, lon, fhr 0–18image/png SounderPy chart. Headers X-HRRR-Run, X-HRRR-Valid, X-Grid-Lat, X-Grid-Lon. First render of a new hour can take ~15 s.
GEThttps://weatherpower.app/wpcc-api/v1/limits—Current per-key limits. No key needed.

Levels are ordered surface-first. Units: pressure hPa, height m above sea level, temperature/dewpoint °C, wind direction °, speed kt.

Derived values (precipitable water, 700–500 lapse rate, freezing level, 0–6 km shear, LCL, surface CAPE/CIN) are computed by WeatherPower from each profile. CAPE/CIN there are approximate; the HRRR model's own CAPE/CIN/LI are included separately.

Coverage. HRRR covers the contiguous US. Balloon soundings come from active sites within 900 km. Points with no data return available: false and a reason instead of a guess.

Freshness. HRRR analyses appear ~1.5–2 h after each hourly run; forecasts use the newest run that has the requested hour.

Limits

Per key. Up to 3 keys per account. Days reset at 00:00 UTC.

KindPer minutePer day
JSON data605,000
PNG images10500

Terms & attribution

Free for non-commercial use. Please credit the data where you show it:

“Soundings: NOAA HRRR & NWS radiosondes via WeatherPower. Forecast profiles by Open-Meteo (CC BY 4.0). Balloon data via Iowa Environmental Mesonet. Charts by SounderPy.”

Not for life-safety decisions. Data can be late or missing; we return what the sources publish and never fill gaps with made-up values.

Your API key

Create an account with your email, verify it, then generate a key. Keys are shown once — store them somewhere safe.

Loading…