# US National Weather Service Forecast API

> US weather forecasts and active alerts from NOAA's National Weather Service, by point or state

- Vendor: `usnationalweatherserviceforeca` · version 1.0 · category Weather · tags weather api, nws api, weather forecast api, weather alerts api, noaa weather api, us weather api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/usnationalweatherserviceforeca
- This document: https://apiclay.com/docs/usnationalweatherserviceforeca.md
- OpenAPI 3.1: https://apiclay.com/api/usnationalweatherserviceforeca/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `usnationalweatherserviceforeca`
- Updated: 2026-11-18

## About

## US National Weather Service Forecast API

Official US weather from the National Weather Service (NOAA): resolve a latitude/longitude to its forecast office and grid, the 7-day and hourly forecasts for that grid (temperature, wind, precipitation chance, short and detailed forecast text), and active watches, warnings and advisories by state.

Data comes from **weather.gov** (https://www.weather.gov). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/point?lat=38.8894&amp;lon=-77.0352` gives `gridId`, `gridX`, `gridY`, then `/forecast?office=LWX&amp;x=97&amp;y=71`.

### Routes

#### GET `/point` - Point lookup
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| lat | path | number | yes | Latitude. |
| lon | path | number | yes | Longitude. |

Returns: `properties` with `gridId`, `gridX`, `gridY`, `forecast`, `relativeLocation`, `timeZone`.

#### GET `/forecast` - 7-day forecast
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| office | path | string | yes | `gridId`, e.g. `LWX`. |
| x | path | number | yes | `gridX`. |
| y | path | number | yes | `gridY`. |

Returns: `properties.periods[]` with `name`, `temperature`, `windSpeed`, `probabilityOfPrecipitation`, `shortForecast`, `detailedForecast`.

#### GET `/forecast-hourly` - Hourly forecast
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| office | path | string | yes | `gridId`. |
| x | path | number | yes | `gridX`. |
| y | path | number | yes | `gridY`. |

Returns: hourly `periods[]`.

#### GET `/alerts` - Active alerts
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| area | query | string | no | Two-letter state, e.g. `TX`. |

Returns: `features[]` with `properties` (`event`, `severity`, `headline`, `description`, `areaDesc`, `expires`).

### Caveats

- US locations only. NWS data is public domain.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by weather.gov.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /point — Point lookup
- Gateway: `GET https://api.apiclay.com/v1/api/usnationalweatherserviceforeca/point`
- Public query params: `lat` (string, required), `lon` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /forecast — 7-day forecast
- Gateway: `GET https://api.apiclay.com/v1/api/usnationalweatherserviceforeca/forecast`
- Public query params: `office` (string, required), `x` (string, required), `y` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /forecast-hourly — Hourly forecast
- Gateway: `GET https://api.apiclay.com/v1/api/usnationalweatherserviceforeca/forecast-hourly`
- Public query params: `office` (string, required), `x` (string, required), `y` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /alerts — Active alerts
- Gateway: `GET https://api.apiclay.com/v1/api/usnationalweatherserviceforeca/alerts`
- Public query params: `area` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/usnationalweatherserviceforeca/point?lat=<lat>&lon=<lon>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
