Skip to content
Docs navigation

Forecaster guidance

Smarter Weather covers the 50 US states and DC only. Coverage details

Forecaster guidance products as GeoJSON overlays — SPC mesoscale discussions and WPC precipitation discussions. Structured fields and bulletin text live on each feature's properties.

A map or briefing tool uses this 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.

For the full bulletin text, GET /v1/text-products lists the newest NWS text products of one type (for example AFD or HWO) for a point, a forecast office, or the nation. See the reference below or the full API reference.

curl "https://api.smarterweather.com/v1/guidance/mesoscale" \
  -H "Authorization: Bearer ${SMARTERWEATHER_API_KEY:?set SMARTERWEATHER_API_KEY first, see developers.smarterweather.com/quickstart}"
// save as sample.mjs; run: node --env-file=.env sample.mjs (Node 20.6+, ESM top-level await)
const res = await fetch(
  "https://api.smarterweather.com/v1/guidance/mesoscale",
  { headers: { Authorization: `Bearer ${process.env.SMARTERWEATHER_API_KEY}` } },
);
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();
console.log(JSON.stringify(data, null, 2));
# pip install requests python-dotenv
import os, sys, requests
from dotenv import load_dotenv

load_dotenv(".env")  # ./.env in the current directory; variables already set are kept

r = requests.get(
    "https://api.smarterweather.com/v1/guidance/mesoscale",
    headers={"Authorization": f"Bearer {os.environ['SMARTERWEATHER_API_KEY']}"},
)
if not r.ok:
    sys.exit(f"{r.status_code} {r.text}")
data = r.json()
print(data)
package main

import (
	"fmt"
	"io"
	"log"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.smarterweather.com/v1/guidance/mesoscale", nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("SMARTERWEATHER_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	body, err := io.ReadAll(res.Body)
	if err != nil {
		log.Fatal(err)
	}
	if res.StatusCode < 200 || res.StatusCode > 299 {
		log.Fatalf("%s %s", res.Status, body)
	}
	fmt.Println(string(body))
}

Samples read your key from SMARTERWEATHER_API_KEY. Set it up in the Quickstart.

Forecaster guidance reference

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

Paste a test key (sw_test_*) from your dashboard into Test Request. Test keys are never billed; their calls still count toward the key's rate limits and daily cap. Calls with your own live key count toward your plan.

Loading the API reference… The spec is also in openapi.yaml.