The same data the page uses, as JSON, for anyone building something. No key, no sign-up, CORS enabled, HTTPS only. Current version 1.4.0.
curl 'https://straightweather.com/v1/current?lat=30.42&lon=-87.22&units=us'
{
"ok": true,
"data": {
"place": {
"name": "Pensacola",
"region": "FL",
"lat": 30.42,
"lon": -87.22,
"timezone": "America/Chicago",
"timezoneAbbreviation": "GMT-6",
"utcOffsetSeconds": -21600,
"elevation": 21.0,
"countryCode": "US"
},
"units": {
"system": "us",
"temperature": "F",
"wind": "mph",
"precipitation": "in",
"pressure": "inHg",
"visibility": "mi",
"snow": "in",
"height": "ft"
},
"current": {
"time": "2026-11-11T10:15:00-06:00",
"epoch": 1794413700,
"isDay": true,
"temperature": 63.5,
"feelsLike": 60.9,
"humidity": 71,
"dewPoint": 54.0,
"pressure": 30.07,
"cloudCover": 100,
"precipitation": 0.0,
"wind": {
"speed": 9.1,
"gust": 17.7,
"direction": 288,
"cardinal": "WNW"
},
"uvIndex": 0.6,
"uvBand": "low",
"visibility": 14.9,
"condition": {
"code": 3,
"kind": "cloud",
"label": "Overcast",
"icon": "cloud-day"
},
"airQuality": {
"usAqi": 34,
"band": "good",
"label": "Good",
"pm25": 5.3,
"pm10": 5.6,
"ozone": 77.0,
"outlook": [
{
"date": "2026-11-11",
"usAqi": 41,
"band": "good",
…
Everything is GET under https://straightweather.com/v1/. units=us gives °F, mph, inches and feet; units=si gives °C, km/h, millimetres, centimetres of snow and metres. lang=es returns Spanish labels wherever an endpoint emits them. The index at /v1/ lists the same table as JSON.
GET /v1/current | lat, lon (required, or auto=ip); units=us|si; lang=en|esCurrent conditions for a point, plus `totals` and a small `tropical` block. Cached 5 minutes. (1.4.0) `auto=ip` places the request from the caller's address. |
|---|---|
GET /v1/forecast | lat, lon (required, or auto=ip); units=us|si; hours=48 (max 384); days=10 (max 16); lang=en|esHourly and daily forecast plus current conditions, air quality, alerts, the NWS narrative, (1.2.0) totals, winter, severeOutlook, tropical and marine, (1.3.0) normals, outdoors and rivers, and (1.4.0) wear, heat, cold, fire, stormReports, aurora, garden and the nowcast summary. One request paints the whole page. |
GET /v1/search | q (required); limit=8 (max 20); lang=en|es; country=USPlace search by name or postcode; returns candidates with coordinates. (1.4.0) `country` keeps one ISO country, and US results sort first. |
GET /v1/trip | lat, lon, from=YYYY-MM-DD, to=YYYY-MM-DD (required); units=us|si; lang=en|es1.4.0. The forecast days of a trip window that fall inside the 16-day range, plus the alerts at that place now. Days further out are listed as `{ date, available: false, availableFrom }`. No key, no account. |
GET /v1/storm-reports.geojson | —1.4.0. Today's SPC filtered storm reports (tornado, hail, wind) across the US as a GeoJSON FeatureCollection of points. Cached 5 minutes. |
GET /v1/reverse | lat, lon (required)Nearest place name for coordinates. |
GET /v1/alerts | lat, lon (required)Active US National Weather Service alerts for the point, full text. Empty outside the US. |
GET /v1/outlook | lat, lon (required)1.2.0. The SPC convective outlook for days 1–3 at the point: `{ severeOutlook }`. Empty outside the US. Cached 10 minutes. |
GET /v1/tropical | lat, lon (required); units=us|si1.2.0. Active Atlantic and East Pacific storms with their distance from the point: `{ tropical }`. Cached 10 minutes. |
GET /v1/tropical/geo | —1.2.0. GeoJSON FeatureCollection of every active storm: forecast cone, forecast track, forecast points and past track; since 1.3.0 also wind arrival lines, wind field and watches and warnings. Cached 10 minutes. |
GET /v1/marine | lat, lon (required); units=us|si1.2.0. Tides for the next 48 h, water temperature, waves and rip current risk: `{ marine }`. null inland. Cached 15 minutes. |
GET /v1/layers | lat, lon (required)1.2.0. Map layer sources for the point: GOES satellite tile frames, the NDFD temperature image template, the alerts GeoJSON URL, whether the tropical layer is active, (1.3.0) the storm surge image template and (1.4.0) the smoke image template and the storm reports GeoJSON URL. Cached 5 minutes. |
GET /v1/layers/alerts | lat, lon (required)1.2.0. GeoJSON FeatureCollection of active NWS alerts with polygons for the US state containing the point. Cached 2 minutes. |
GET /v1/radar | color=2 (0–8); size=256|512; smooth=1; snow=1Current RainViewer radar frame timestamps and tile URL templates. |
GET /v1/history | lat, lon (required); start=YYYY-MM-DDTHH:MM; hours=48; years=10; units=us|siWhat the same hours looked like in past years (ERA5 reanalysis): low, mean and high per hour. |
GET /v1/health | —Liveness, API version and upstream status. |
POST /v1/push/register | app onlyRegisters a device push token and its notification preferences. Used by the Straight Weather apps; not offered to third parties, and a request without the app's install header is refused. |
POST /v1/push/unregister | app onlyDeletes a device's token and everything stored with it. |
Additive and optional like every release before it: every number can be null, a section that does not apply is null, and none of it adds a request to /v1/forecast. National feeds (SPC outlooks and reports, SWPC) are cached once on the server for everyone.
nowcast.summary — rain by the minuteThe 2-hour, 15-minute nowcast gains the minutes until the first wet step (0.1 mm or more in the 15 minutes; probability alone never makes a step wet), how long that spell lasts, when it stops if it is wet now, and its peak intensity (light under 2.5 mm/h, moderate under 7.6, heavy above).
"nowcast": { "start": "2026-11-05T08:15", "startEpoch": 1793888100, "stepMinutes": 15,
"precipitation": [0.0, 0.0, 0.01, 0.04, ...], "probability": [10, 30, 60, 80, ...],
"summary": { "text": "Rain starting in 12 min", "changeEpoch": 1793888820, "wetNow": false,
"startsInMinutes": 12, "endsInMinutes": null, "durationMinutes": 45, "intensity": "moderate" } }
wear — what to wearFrom the feels-like temperature, wind, rain chance and UV over the waking hours left today (tomorrow after 20:00 local). items are stable ids: tshirt, long_sleeves, light_jacket, warm_coat, heavy_coat, hat_gloves, umbrella, rain_jacket, sunscreen, sunglasses. text follows lang.
"wear": { "date": "2026-11-05", "text": "Light jacket; umbrella after 3 PM",
"items": ["light_jacket", "umbrella"], "umbrellaFrom": "2026-11-05T15:00:00-06:00" }
heat and coldheat.level is the NWS HeatRisk 0–4 (source: "nws") for the contiguous US, otherwise derived from the forecast maximum heat index ("derived"). cold is the lowest wind chill today and tonight, banded cold, very_cold or dangerous.
"heat": { "level": 3, "label": "Major", "source": "nws", "peakHeatIndex": 108, "peakAt": "2026-07-14T15:00:00-05:00",
"advice": "Limit time in the sun from 1 to 5 PM; drink water" }, // null when level 0 and derived
"cold": { "minWindChill": 9, "at": "2026-11-05T05:00:00-09:00", "band": "cold",
"advice": "Dress in layers and cover your hands and ears" } // null unless below 32°F / 0°C
fire — fire weatherThe SPC fire weather outlook category at the point for days 1 and 2 (elevated, critical, extreme or null), whether a Red Flag Warning or Fire Weather Watch is among the alerts, and near-surface smoke from the PM2.5 forecast. US only.
"fire": { "outlook": [ { "day": 1, "category": "critical" }, { "day": 2, "category": "elevated" } ],
"redFlag": true, "smoke": { "pm25": 58, "level": "moderate" } } // null outside the US and when all calm
stormReportsToday's SPC filtered reports within 160 km. distance is in mi (units=us) or km. The same reports for the whole country are at /v1/storm-reports.geojson.
"stormReports": { "date": "2026-11-05", "reports": [
{ "type": "hail", "time": "2026-11-05T21:40:00Z", "lat": 30.5, "lon": -87.4, "distance": 12,
"magnitude": "1.75 in", "location": "2 W Pensacola", "remarks": "Golf ball sized hail." } ] } // within 160 km, newest first, max 10; null when none
auroraNOAA SWPC's 3-day Kp forecast and the OVATION nowcast probability at the point. viewLine is true when the point is inside the line from which the aurora may be seen on the horizon.
"aurora": { "tonightKp": 5.3, "chance": 60, "viewLine": true,
"bestFrom": "2026-11-05T22:00:00-09:00", "bestTo": "2026-11-06T02:00:00-09:00",
"text": "Likely overhead after 10 PM" } // only for |lat| >= 40 and a 10% chance or Kp >= 5
gardenMedian last spring and first fall frost (32°F / 0°C) from the same ten-year archive as normals, the first forecast hour at or below freezing in the 16 days, and growing degree days since 1 January (base 50°F, or 10°C with units=si). Like normals, a place not yet cached returns null and fills after the response.
"garden": { "lastSpringFrost": "05-19", "firstFallFrost": "08-30", "growingSeasonDays": 102,
"nextFreeze": "2026-11-06T02:00:00-09:00", "gdd": 1220, "gddBase": 50 } // MM-DD medians; null until cached
/v1/tripA trip window of up to 31 days; days already past are left out. Days inside the 16-day range carry the same fields as daily[]; later days say when they become available. Plus is not required, and nothing is stored.
curl 'https://straightweather.com/v1/trip?lat=30.39&lon=-86.5&from=2026-11-07&to=2026-11-24&units=us'
→ { "place": { ... }, "units": { ... }, "trip": { "from": "2026-11-07", "to": "2026-11-24" },
"days": [ { "available": true, "date": "2026-11-07", "high": 71.9, "low": 51.3, "condition": { ... }, ... },
{ "date": "2026-11-21", "available": false, "availableFrom": "2026-11-06" } ],
"alerts": [ ] }
auto=ip/v1/current and /v1/forecast accept auto=ip instead of lat/lon and place the request at the nearest city to the caller's address, from a local copy of IP Geolocation by DB-IP (CC BY 4.0); place.source is "ip". Nothing is sent to a third party. Meant for screens with no location of their own, such as a TV.
curl 'https://straightweather.com/v1/current?auto=ip&units=us'
→ "place": { "name": "Pensacola", "region": "FL", "lat": 30.54, "lon": -87.2, ..., "source": "ip" }
/v1/layers additionssmoke is an image template (same {bbox}, {w}, {h} as temperature); storms points at today's report GeoJSON.
"smoke": { "imageUrl": "https://mapservices.weather.noaa.gov/raster/rest/services/air_quality/ndgd_smoke_sfc_1hr_avg_time/ImageServer/exportImage?bbox={bbox}&...&size={w},{h}&...",
"attribution": "NOAA NWS NDGD smoke" },
"storms": { "url": "https://straightweather.com/v1/storm-reports.geojson", "attribution": "NOAA SPC" }
All additive and optional, and every number can be null. A section that does not apply is null and a client should show nothing for it. None of it adds a request or slows the response: a place whose averages are not cached yet returns normals: null and fills the cache after the response is sent.
normals — compared to normalToday's forecast high and low against the average of the same calendar day, give or take three days, over the last ten full years (Open-Meteo archive, ERA5). Temperatures in units.temperature.
"normals": { "date": "2026-11-05", "high": 71.4, "low": 52.3, "highDiff": 6.2, "lowDiff": 3.8,
"years": 10, "text": "6° warmer than usual" } // null until this place's averages are cached
outdoors — best time outsideThe best two contiguous daylight hours per activity (run, yard, water), today, or tomorrow once today has under two usable daylight hours left. score is 0–100 and rating is great, good or fair; an activity with no decent window has window: null. This is a weather-based suggestion. water scores calm, dry weather only and makes no claim about fish.
"outdoors": { "date": "2026-11-05", "activities": [
{ "id": "run", "label": "Run", "window": {
"start": "2026-11-05T08:00:00-06:00", "end": "2026-11-05T10:00:00-06:00",
"startEpoch": 1793944800, "endEpoch": 1793952000,
"score": 84, "rating": "great", "temperature": 61.0, "precipProbability": 5, "wind": 6.0, "reason": "Cool and dry" } },
{ "id": "water", "label": "Fishing & boating", "window": null } ] } // window null = nothing rated fair or better
rivers — NOAA gaugesThe nearest three river gauges within 40 km from the NOAA National Water Prediction Service, with tide stations left out and observations more than 24 hours old dropped. Any gauge at action stage or above sorts first. category is no_flooding, action, minor, moderate, major or unknown; heights in units.height. Cached 15 minutes.
"rivers": { "gauges": [
{ "id": "DTNO1", "name": "Great Miami River at Dayton", "distance": 0.5, "stage": 24.65, "observedAt": "2026-11-04T23:30:00-05:00",
"category": "no_flooding", "categoryLabel": "Normal", "floodStage": 41.0,
"forecastStage": 25.2, "forecastAt": "2026-11-05T13:00:00-05:00", "forecastCategory": "no_flooding",
"url": "https://water.noaa.gov/gauges/dtno1" } ] } // null when no gauge within 40 km
tropical.storms[] additionsWind arrival is for tropical-storm-force winds. watchWarning is for the coast nearest the place, when it is in or near a zone. surge appears only where the data gives a point value.
"windArrival": { "earliest": "2026-09-12T06:00:00Z", "mostLikely": "2026-09-12T18:00:00Z" },
"watchWarning": "Hurricane Warning",
"surge": { "inundationFt": 6, "text": "Storm surge could top 6 ft above ground" } // each one null when it does not apply
/v1/tropical/geo features gain the kinds arrival-earliest and arrival-likely (lines, with time), wind-field, and watch-warning (with tcww and label). These feeds are empty out of season.
/v1/layers additionSame {bbox}, {w}, {h} template as temperature.
"surge": { "imageUrl": "https://mapservices.weather.noaa.gov/...export?bbox={bbox}&bboxSR=4326&imageSR=3857&size={w},{h}&format=png32&transparent=true&f=image&layers=show:...",
"attribution": "NOAA NHC" } // null unless a surge product is active
lang=es additionsSpanish also translates normals.text, the outdoors labels and reasons, and categoryLabel.
Everything below is additive and optional: a client written for 1.1 ignores it. Every number is a number or null, and a whole section is null (or []) when it does not apply to the place, so a client can test the section and skip it. The server assembles the new sections from its upstreams in parallel and caches the national feeds (outlook, storms, satellite times, tide stations) once for everyone, so /v1/forecast stays one request.
"units": { "system": "us", "temperature": "F", "wind": "mph", "precipitation": "in",
"pressure": "inHg", "visibility": "mi", "snow": "in", "height": "ft" },
"place": { "name": "Pensacola", "region": "FL", "countryCode": "US", ... }
units.snow and units.height are new; place.countryCode is the ISO code or null when unknown.
"hourly": [ { "time": "2026-11-04T14:00:00-06:00", "temperature": 78.2, ...,
"snowfall": 0.0, "windSpeed": 12.4, "windGust": 16.6, "humidity": 91 } ],
"daily": [ { "date": "2026-11-04", "high": 80.9, "low": 70.0, ...,
"snowfallSum": 0.0, "windGustMax": 21.3 } ]
totals — rain so farOpen-Meteo's hourly series for the past seven days, summed up to the current hour. Model data, so "so far" rather than "measured". Also on /v1/current.
"totals": { "precipitation24h": 0.12, "precipitation7d": 1.86,
"snowfall24h": 0.0, "snowfall7d": 0.0, "since": "2026-10-28T14:00:00-06:00" }
winter — snow detailnull when there is no snow in the forecast window and none on the ground, which is why a Florida client never sees it. Depth and snowfall in units.snow, freezing level in units.height.
"winter": { "snowDepth": 3.1, "freezingLevel": 1850,
"snowfallNext24h": 1.2, "snowfallNext7d": 4.6 } // null when there is no snow at all
severeOutlook — SPC convective outlookDays 1, 2 and 3 from the NOAA Storm Prediction Center, point-in-polygon against the outlook areas. US only; [] elsewhere. Also available alone at /v1/outlook.
"severeOutlook": [
{ "day": 1, "date": "2026-11-04", "category": "slgt", "level": 2, "label": "Slight risk", "issued": "2026-11-04T12:30:00Z" },
{ "day": 2, "date": "2026-11-05", "category": "mrgl", "level": 1, "label": "Marginal risk", "issued": "2026-11-04T06:00:00Z" },
{ "day": 3, "date": "2026-11-06", "category": "none", "level": 0, "label": "No risk", "issued": "2026-11-04T07:30:00Z" }
] // category: none | tstm | mrgl | slgt | enh | mdt | high; level 0..5; [] outside the US
tropical — active stormsEvery active Atlantic and East Pacific storm from the National Hurricane Center with its distance from the point. classification is one of TD TS HU MH PTC STD SS OTHER. A small version (no headline or advisory URL) rides on /v1/current; the full block is on /v1/forecast and /v1/tropical.
"tropical": {
"storms": [ { "id": "al012026", "name": "Arlene", "classification": "TS", "classLabel": "Tropical Storm",
"intensityKt": 45, "intensityMph": 52, "pressureMb": 1002, "lat": 24.1, "lon": -86.2,
"movementDir": "NNW", "movementKt": 9, "lastUpdate": "2026-11-04T15:00:00Z",
"distance": 412, "inCone": true, "headline": "...", "advisoryUrl": "https://www.nhc.noaa.gov/..." } ],
"nearby": true, "updated": "2026-11-04T15:05:00Z"
} // distance in mi (units=us) or km (units=si); nearby = within 800 km or inside a cone; null = feed unavailable
The geometry is a separate call, /v1/tropical/geo, because it is the same for everyone and large: a GeoJSON FeatureCollection whose features carry kind (cone, track, point, past), stormId and name; points also carry time, intensityKt and classLabel.
{ "type": "FeatureCollection", "features": [
{ "type": "Feature", "properties": { "kind": "cone", "stormId": "al012026", "name": "Arlene" }, "geometry": { "type": "Polygon", ... } },
{ "type": "Feature", "properties": { "kind": "track", "stormId": "al012026", "name": "Arlene" }, "geometry": { "type": "LineString", ... } },
{ "type": "Feature", "properties": { "kind": "point", "stormId": "al012026", "name": "Arlene", "time": "2026-11-05T12:00:00Z",
"intensityKt": 55, "classLabel": "Tropical Storm" }, "geometry": { "type": "Point", ... } },
{ "type": "Feature", "properties": { "kind": "past", "stormId": "al012026", "name": "Arlene" }, "geometry": { "type": "LineString", ... } } ] }
marine — beach and waterTides for the next 48 hours from the nearest NOAA CO-OPS station within 60 km, water temperature and waves from the Open-Meteo Marine API, rip current risk from the NWS. null inland. Also at /v1/marine. Tide times are local to the place, with the offset; epoch is Unix seconds.
"marine": {
"station": { "id": "8729840", "name": "Pensacola", "distance": 2.1 },
"tides": [ { "time": "2026-11-04T15:12:00-06:00", "epoch": 1793826720, "type": "H", "height": 1.4 },
{ "time": "2026-11-05T03:48:00-06:00", "epoch": 1793872080, "type": "L", "height": 0.2 } ],
"waterTemperature": 72.5,
"waves": { "height": 1.6, "period": 5, "direction": "SSE" },
"ripCurrentRisk": "moderate", "ripCurrentText": "Moderate risk of rip currents",
"beachForecastUrl": "https://www.weather.gov/beach/mob"
} // null inland: no tide station within 60 km and no wave data
/v1/layers — map layer sourcesWhere a map can fetch its layers from, for a point. satellite.frames are the last six ten-minute GOES GeoColor times, each verified before it is listed, with a tile template for a Web Mercator map ({z}/{y}/{x}; use maxNativeZoom); west of 125°W the frames come from GOES-West. temperature.imageUrl is an image template: substitute {bbox} with west,south,east,north in degrees and {w},{h} with the pixel size (keep it at or under 1024). temperature is null outside the NDFD's coverage.
{ "satellite": { "frames": [ { "time": "2026-11-04T20:30:00Z", "epoch": 1793910600,
"tileUrl": "https://gibs.earthdata.nasa.gov/wmts/epsg3857/best/GOES-East_ABI_GeoColor/default/2026-11-04T20:30:00Z/GoogleMapsCompatible_Level7/{z}/{y}/{x}.png" } ],
"maxNativeZoom": 7, "attribution": "NASA GIBS · NOAA GOES-East" },
"temperature": { "imageUrl": "https://mapservices.weather.noaa.gov/raster/rest/services/NDFD/NDFD_temp/MapServer/export?bbox={bbox}&bboxSR=4326&imageSR=3857&size={w},{h}&format=png32&transparent=true&f=image",
"attribution": "NOAA NWS NDFD" },
"alerts": { "url": "https://straightweather.com/v1/layers/alerts?lat=30.42&lon=-87.22", "attribution": "NWS" },
"tropical": { "url": "https://straightweather.com/v1/tropical/geo", "active": false } }
/v1/layers/alerts returns the active NWS alerts with polygon geometry for the US state containing the point, as GeoJSON. Properties carry id, event, severity, headline, ends and a color hint.
{ "type": "FeatureCollection", "features": [ { "type": "Feature",
"properties": { "id": "urn:oid:...", "event": "Tornado Warning", "severity": "Extreme",
"headline": "Tornado Warning issued ...", "ends": "2026-11-04T18:30:00-06:00", "color": "#FF5E3A" },
"geometry": { "type": "Polygon", "coordinates": [ ... ] } } ] } // zone-only alerts (no polygon) are left out
lang=esAny endpoint that emits labels accepts lang. Spanish translates condition.label, nowcast.summary.text, daily[].moonLabel, airQuality.label and outlook[].label, severeOutlook[].label, tropical.storms[].classLabel and marine.ripCurrentText. The NWS narrative and alerts stay as the NWS wrote them. An unknown value falls back to English. The language is part of the cache key, so the two languages never mix.
curl 'https://straightweather.com/v1/current?lat=30.42&lon=-87.22&units=us&lang=es'
→ "condition": { "code": 2, "kind": "partly", "label": "Parcialmente nublado", ... },
"airQuality": { "usAqi": 30, "band": "good", "label": "Buena", ... }
POST /v1/push/register and POST /v1/push/unregister exist for the Straight Weather apps only: they carry an APNs or FCM token, rounded place coordinates and the notification preferences (severe alerts, rain starting soon, morning briefing hour, custom thresholds). They are not offered to third-party clients; a request without the app's install header is refused. What the server keeps for a registered device is described in the FAQ and on the privacy page.
Every answer is a JSON object with ok, data and meta. meta.generated is when the answer was built and meta.ttlSeconds how long it is good for; the same value is sent as Cache-Control: max-age, and the X-Sw-Cache header says whether nginx served it from cache. An error looks like this:
{
"ok": false,
"error": {
"code": "bad_request",
"message": "lat and lon are required and must be numbers."
}
}
429. Current conditions change every five minutes at most, so there is no reason to poll faster than that.User-Agent that names your project and a way to reach you. Apps should also send an X-SW-Install header with a random per-install token so we can count installs without identifying anyone./v1/) so that if something has to change, the old answers keep working for a while.Requests are logged by nginx (address, URL, time, headers you send) and deleted after 14 days. Nothing is sold, shared or joined to anything else. The privacy page applies to the API as well.