Straight Weather ← Back to the forecast

The Straight Weather API

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",
  …

Endpoints

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/currentlat, lon (required, or auto=ip); units=us|si; lang=en|es
Current 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/forecastlat, lon (required, or auto=ip); units=us|si; hours=48 (max 384); days=10 (max 16); lang=en|es
Hourly 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/searchq (required); limit=8 (max 20); lang=en|es; country=US
Place search by name or postcode; returns candidates with coordinates. (1.4.0) `country` keeps one ISO country, and US results sort first.
GET /v1/triplat, lon, from=YYYY-MM-DD, to=YYYY-MM-DD (required); units=us|si; lang=en|es
1.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/reverselat, lon (required)
Nearest place name for coordinates.
GET /v1/alertslat, lon (required)
Active US National Weather Service alerts for the point, full text. Empty outside the US.
GET /v1/outlooklat, 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/tropicallat, lon (required); units=us|si
1.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/marinelat, lon (required); units=us|si
1.2.0. Tides for the next 48 h, water temperature, waves and rip current risk: `{ marine }`. null inland. Cached 15 minutes.
GET /v1/layerslat, 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/alertslat, 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/radarcolor=2 (0–8); size=256|512; smooth=1; snow=1
Current RainViewer radar frame timestamps and tile URL templates.
GET /v1/historylat, lon (required); start=YYYY-MM-DDTHH:MM; hours=48; years=10; units=us|si
What 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/registerapp only
Registers 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/unregisterapp only
Deletes a device's token and everything stored with it.

What is new in 1.4.0

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 minute

The 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 wear

From 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 cold

heat.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 weather

The 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

stormReports

Today'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

aurora

NOAA 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

garden

Median 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/trip

A 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 additions

smoke 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" }

What was new in 1.3.0

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 normal

Today'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 outside

The 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 gauges

The 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[] additions

Wind 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 addition

Same {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 additions

Spanish also translates normals.text, the outdoors labels and reasons, and categoryLabel.

What was new in 1.2.0

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 and place

"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 and daily additions

"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 far

Open-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 detail

null 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 outlook

Days 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 storms

Every 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 water

Tides 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 sources

Where 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=es

Any 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", ... }

Push registration

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.

Responses

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."
  }
}

Limits and terms

Privacy

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.