Guidance

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.

get/v1/text-products

Request

  • Base URL: https://api.smarterweather.com
  • URL: https://api.smarterweather.com/v1/text-products
  • Auth: HTTP bearer

Query parameters

product_typestring required

3-character NWS product code (e.g. AFD, HWO, NOW). Upper-cased by the server.

latnumber double

Latitude. Requires lon; mutually exclusive with wfo.

lonnumber double

Longitude. Requires lat; mutually exclusive with wfo.

wfostring

3-letter NWS Weather Forecast Office identifier. Upper-cased by the server.

awips_idstring

Exact AWIPS product identifier (4-9 letters or digits). Upper-cased by the server.

startstring date-time

RFC 3339 instant. Only products issued after it are returned.

limitinteger

Maximum products to return (1-10, default 1).

omit_bodyboolean

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.