REST API

The SmarterWeather API provides a unified interface to weather data across the contiguous United States. All endpoints return JSON, serve errors as RFC 7807 problem details, and authenticate via an HTTP Bearer token.

Single source of truth

Every endpoint, parameter, and response shape is rendered live from the canonical OpenAPI document. Each resource page below pairs that machine-rendered spec with the narrative context for when to reach for the endpoint and which data sources back it.

Authentication

Pass your developer key as an HTTP Bearer token. Keys come in two flavors: sw_live_* for production traffic and sw_test_* for CI and local development. The full scheme is rendered on every resource page below.

Rate limits

Rate limits vary by plan. Free tier allows 100 requests/day; Pro and Enterprise plans include higher limits. See pricing for details.

Resources

Each page pairs the canonical spec for a resource with the narrative context for when to use it.

Full spec and tooling

For SDK generation, full-text search across every operation, or feeding the spec into another tool.