Skip to content
Docs navigation

Climate and agriculture

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

Climatology and agriculture-derived indices. Climate normals describe what is typical at a location for each calendar day — a 30-year base period, not a forecast. Growing degree days are computed on read from stored daily temperature extremes for a crop's thresholds.

A scheduling or farming integration uses this to ask “is tomorrow warmer than usual?” or to track season-to-date heat units against a growth-stage milestone. Pair normals with the weather daily block when you want departure from typical.

curl "https://api.smarterweather.com/v1/climate/normals?lat=42.3601&lon=-71.0589" \
  -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/climate/normals?lat=42.3601&lon=-71.0589",
  { 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/climate/normals",
    params={"lat":"42.3601","lon":"-71.0589"},
    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/climate/normals?lat=42.3601&lon=-71.0589", 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.

Climate and agriculture reference

Rendered live from the canonical OpenAPI document. This is the canonical reference for the climate and agriculture 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.