# National Weather Service API (api.weather.gov)

The official US weather service API: forecasts for any US grid point, hourly forecasts, station observations and active watches and warnings, served as GeoJSON and other formats.

- Category: Weather and climate · by NOAA National Weather Service (US Government)
- Website: https://www.weather.gov/documentation/services-web-api
- Live data: yes
- Checked on the official pages: 2026-10-23

## API

- Official API: yes, docs https://www.weather.gov/documentation/services-web-api
- Key needed: no
- Price: Free; limits: User-Agent required; rate limit not public but 'generous for typical use'; over the limit, retry after it clears (typically within 5 seconds)
- Base URL: https://api.weather.gov
- Formats: geojson, json-ld, xml, cap, atom

Example request:

```
https://api.weather.gov/points/39.7456,-97.0892
```

## Data and license

- License: public domain (US Government work) (https://www.weather.gov/disclaimer); covers Information on NWS web pages and API data, unless noted otherwise; do not claim it as your own, imply NOAA endorsement, or present modified content as official
- Commercial use OK
- No credit needed
- Embedding with conditions
- Quote (api_official): "The API is based upon of JSON-LD to promote machine data discovery. The API is located at: https://api.weather.gov" (https://www.weather.gov/documentation/services-web-api)
- Quote (api_price): "All of the information presented via the API is intended to be open data, free to use for any purpose. As a public service of the United States Government, we do not charge any fees for the usage of this service" (https://www.weather.gov/documentation/services-web-api)
- Quote (api_key): "A User Agent is required to identify your application. This string can be anything, and the more unique to your application the less likely it will be affected by a security event." (https://www.weather.gov/documentation/services-web-api)
- Quote (api_key_future): "This will be replaced with an API key in the future." (https://www.weather.gov/documentation/services-web-api)
- Quote (limits): "The rate limit is not public information, but allows a generous amount for typical use. If the rate limit is execeed a request will return with an error, and may be retried after the limit clears (typically within 5 seconds)." (https://www.weather.gov/documentation/services-web-api)
- Quote (formats): "GeoJSON: application/geo+json JSON-LD: application/ld+json DWML: application/vnd.noaa.dwml+xml OXML: application/vnd.noaa.obs+xml CAP: application/cap+xml ATOM: application/atom+xml" (https://www.weather.gov/documentation/services-web-api)
- Quote (license): "The information on National Weather Service (NWS) Web pages are in the public domain, unless specifically noted otherwise, and may be used without charge for any lawful purpose" (https://www.weather.gov/disclaimer)
- Quote (commercial): "All of the information presented via the API is intended to be open data, free to use for any purpose." (https://www.weather.gov/documentation/services-web-api)
- Quote (embed): "so long as you do not: 1) claim it is your own (e.g., by claiming copyright for NWS information -- see below), 2) use it in a manner that implies an endorsement or affiliation with NOAA/NWS, or 3) modify its content and then present it as official government material." (https://www.weather.gov/disclaimer)
- Quote (attribution): "third parties producing copyrighted works consisting predominantly of the material appearing in NWS Web pages must provide notice with such work(s) identifying the NWS material incorporated and stating that such material is not subject to copyright protection." (https://www.weather.gov/disclaimer)
- Quote (example): "For example: https://api.weather.gov/points/39.7456,-97.0892 This will provide the grid forecast endpoints for three format options" (https://www.weather.gov/documentation/services-web-api)

## Rules for an agent

- Two steps: GET /points/{lat},{lon} to get the forecast and forecastHourly URLs for that grid cell, then GET those; send a unique User-Agent, and note coverage is the US and its territories only.
- Send an identifying User-Agent header on every request.
- Do not present NWS data as your own, imply NOAA/NWS endorsement, or show edited products as official warnings.
- On rate-limit errors back off a few seconds and retry; cache responses, the API is designed to be cache-friendly.

Human page: https://agentgid.com/resources/nws-api/
Source: AgentGid (agentgid.com). Facts are quoted from the site's own pages; check the license page before you ship.