List recent NWS text products of one type.
Returns the newest NWS text products of one type (for example AFD area forecast discussions or HWO hazardous weather outlooks), newest issued_at first, with the bulletin text in body. For distilled fields from the same products, use GET /v1/weather?include=guidance.
Scope
At most one of:
- lat + lon — products from the office that serves the point, or whose area contains it.
- wfo — products from one NWS Weather Forecast Office.
With neither, the query is national (for example SPC or WPC products, narrowed with awips_id).
Filters
- awips_id — exact AWIPS identifier (e.g. AFDLOT).
- start — RFC 3339 instant; only products issued after it.
- limit — 1 to 10, default 1. There is no pagination.
- omit_body — true returns metadata and properties with an empty body.
Caching
Successful responses carry Cache-Control: max-age=60, stale-while-revalidate=60, public for first-party keys and private for partner keys.
Coverage
With lat/lon, a point outside the 50 US states and DC returns 404 outside-coverage with next_steps; wfo and national queries are not filtered by point.
Auth
Standard sw-api Bearer auth applies.
Request
- Base URL: https://api.smarterweather.com
- URL: https://api.smarterweather.com/v1/text-products
- Auth: HTTP bearer
Query parameters
3-character NWS product code (e.g. AFD, HWO, NOW). Upper-cased by the server.
Latitude. Requires lon; mutually exclusive with wfo.
Longitude. Requires lat; mutually exclusive with wfo.
3-letter NWS Weather Forecast Office identifier. Upper-cased by the server.
Exact AWIPS product identifier (4-9 letters or digits). Upper-cased by the server.
RFC 3339 instant. Only products issued after it are returned.
Maximum products to return (1-10, default 1).
When true, body is empty and only metadata and properties are returned.
Response
Matching products. products is an empty array when nothing matches.
Example response
{
"products": [
{
"product_type": "AFD",
"wfo": "LOT",
"awips_id": "AFDLOT",
"wmo_header": "FXUS63 KLOT"
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.