Skip to content
Docs navigation

Forecaster guidance

Forecaster guidance products as GeoJSON overlays — SPC mesoscale discussions and WPC precipitation discussions. Structured fields and bulletin text live on each feature's properties. Prefer /v1/guidance/mesoscale for new clients; GET /v1/discussions/mesoscale is a deprecated alias of the same mesoscale product.

A map or briefing tool reaches here when it needs the polygons and language a human forecaster already wrote, not a model grid. The weather endpoint can also return a distilled include=guidance block at a point.

curl "https://api.smarterweather.com/v1/guidance/mesoscale" \
  -H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch(
  "https://api.smarterweather.com/v1/guidance/mesoscale",
  { headers: { Authorization: `Bearer ${process.env.SMARTERWEATHER_API_KEY}` } },
);
const data = await res.json();
import os, requests

data = requests.get(
    "https://api.smarterweather.com/v1/guidance/mesoscale",
    headers={"Authorization": f"Bearer {os.environ['SMARTERWEATHER_API_KEY']}"},
).json()
req, _ := http.NewRequest("GET",
  "https://api.smarterweather.com/v1/guidance/mesoscale",
  nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("SMARTERWEATHER_API_KEY"))
res, _ := http.DefaultClient.Do(req)

Forecaster guidance reference

Rendered live from the canonical OpenAPI document. This is the canonical reference for the forecaster guidance resource.

Loading API reference…