Skip to content
Docs navigation

Point data and exposure

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

Curated point values for a set of stored weather products, and population-exposure summaries for gridded or vector weather products. A single point request returns a friendly value, unit, and optional category; a product exposure summary answers how many people sit inside a risk zone.

Use this when a map, card, or alerting workflow needs one number at a location — soil moisture, radar-estimated rainfall (QPE, quantitative precipitation estimate), an outlook category — or the count of people under a hazard, without pulling the full weather envelope.

curl "https://api.smarterweather.com/v1/point?product=sport_rsm_0_2m_pct_conus&var=rsm_0_2m_pct&lat=41.9&lon=-93.6" \
  -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/point?product=sport_rsm_0_2m_pct_conus&var=rsm_0_2m_pct&lat=41.9&lon=-93.6",
  { 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/point",
    params={"product":"sport_rsm_0_2m_pct_conus","var":"rsm_0_2m_pct","lat":"41.9","lon":"-93.6"},
    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/point?product=sport_rsm_0_2m_pct_conus&var=rsm_0_2m_pct&lat=41.9&lon=-93.6", 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.

Point data and exposure reference

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