WeatherTotals JSON API
The WeatherTotals JSON API serves the same figures that appear on the site's pages as structured data. It is free, requires no key or signup, and uses only GET requests.
Endpoints
| Endpoint | Returns |
|---|---|
| /api/v1/snow/season | Season-to-date snowfall by state, with the highest measured city per state and the normal to date, in inches. |
| /api/v1/snow/reports | For the last 24 hours, nationwide snowfall reports are sorted newest first and include place, amount, source, and time. |
| /api/v1/snow/:state/:city | A single city's snowfall data: season to date versus normal, snow days, biggest day, the day-by-day season, all-time records, and monthly normals. |
| /api/v1/aurora/now | For every state, the current verdict and required Kp are shown, along with the planetary Kp, its time, and the forecast peak. |
| /api/v1/rain/:state/:city | A single city's rain data: yesterday's official climate report, year to date versus normal, rain days, records, and monthly normals. |
| /api/v1/hail/week | For the last seven days, state-by-state hail reports include the largest stone and the most recent 24 hours. |
| /api/v1/yesterday | Each tracked city's entry includes yesterday's official high and low, the times they were recorded, departures from normal, records, and rain. |
Example
Request the current aurora data with this curl command:
curl https://weathertotals.com/api/v1/aurora/now
Response envelope
Every response uses the same JSON envelope. The fields are api, asOf, page, docs, attribution, and data.
{
"api": "v1",
"asOf": "2026-08-23T10:40:12.000Z",
"page": "https://weathertotals.com/aurora",
"docs": "https://weathertotals.com/api",
"attribution": {
"notice": "Contains NWS/NOAA material in the public domain (17 U.S.C. 403). ...",
"sources": ["NOAA Space Weather Prediction Center planetary Kp"],
"requested": "A link to the page above when you publish these figures."
},
"data": { "kp": 1.0, "observedAt": "2026-08-23T10:39:00.000Z", "states": [ ... ] }
}Usage terms
- The data is public domain, so you may use it for anything, including commercial work.
- Each response includes an attribution block; carry that block along when you republish the figures.
- When you publish those figures, please include a link to the page named in the response.
- The feeds are cached for ordinary use. Anyone who needs more can use the contact form; one request per minute per endpoint should suffice.