🌐
Weather-gov
weather-gov.github.io › api › general-faqs
api.weather.gov: General FAQs
We’re still working on documentation for the JSON that API returns, but we think it’s pretty easy to understand if you just look at it. If you need more reference, the forecast JSON very closely aligns with the information you’d see on a web page on forecast.weather.gov.
🌐
Weather-gov
weather-gov.github.io › api
api.weather.gov: Community discussion and documentation for the US National Weather Service API
Welcome! This GitHub Pages site is here to answer some of the most frequently asked questions about the National Weather Service public data API (api.weather.gov).
Discussions

Where do you get the API Key for National Weather Service?
Ha, I just did this. The API key can be anything, docs suggest using an e-mail address. More on reddit.com
🌐 r/homeassistant
8
5
August 8, 2022
json - How do I get the hourly forecast from api.weather.gov for Texas stations or zones or offices or gridpoints or anything else? - Stack Overflow
I have one gridpoint working for Indiana. https://api.weather.gov/gridpoints/IND/56,65/forecast/hourly More on stackoverflow.com
🌐 stackoverflow.com
NWS Integration API Key - Where to obtain ley?
I’ve been trying to integrate an alternative that still provides a free API. I’m attempting to integrate National Weather Service (NWS). The problem is that when I go to add the integration it requires an API Key. But going to the NWS webiste (https://www.weather.gov/... More on community.home-assistant.io
🌐 community.home-assistant.io
0
0
December 7, 2020
Best API or DB for historical weather?
ERA5: https://www.ecmwf.int/en/forecasts/dataset/ecmwf-reanalysis-v5 More on reddit.com
🌐 r/meteorology
11
3
June 27, 2025
🌐
GitHub
github.com › weather-gov › api
GitHub - weather-gov/api: Community discussion and documentation for the NWS API · GitHub
Community discussion and documentation for the NWS API - weather-gov/api
Starred by 297 users
Forked by 15 users
Languages   HTML 51.4% | SCSS 47.7% | Ruby 0.9%
🌐
National Weather Service
weather.gov › documentation
Web Services Documentation
Weather.gov > Documentation · Services · API Web Service · Alerts Web Service · Technical Bulletins · This page provides documentation for the National Weather Service. Please select the documentation that you are looking for using the menu above or the list below.
🌐
National Climatic Data Center
ncdc.noaa.gov › cdo-web › webservices › v2
Web Services API (version 2) Documentation | Climate Data Online (CDO) | National Climatic Data Center (NCDC)
An access token is required to use the API, and each token will be limited to five requests per second and 10,000 requests per day. In order to access the CDO web services a token must first be obtained from the token request page. To make a request use the base url with one of the endpoint ...
🌐
OpenWeatherMap
openweathermap.org › api
Weather API
Create an account on OpenWeather to access your dashboard and generate your unique API key.
🌐
Reddit
reddit.com › r/homeassistant › where do you get the api key for national weather service?
r/homeassistant on Reddit: Where do you get the API Key for National Weather Service?
August 8, 2022 -

I want to use the NWS integration and it is asking for a API Key. I tried going to https://www.weather.gov/documentation/services-web-api but it doesn't tell me how to get the key. I see it says there's a link to the API, but it just goes to a site that doesn't have much to it. How do I get the API Key to use for the integration?

Find elsewhere
Top answer
1 of 2
5

Looking at the api documentation found HERE and HERE, you are calling the /gridpoints/{wfo}/{x},{y}/forecast/hourly call which will return the hourly weather forecast for the specified weather office {wfo} at the specified x-y coordinates. You can find a list of the weather offices HERE. Finding the X-Y coordinates for the weather offices may be a bit more tedious to find on the web.

If you happen have access to the GPS coordinates that you are working with you can use the /points/{x},{y} API call to get the information on the closest weather office to then pass to the /gridpoints/{wfo}/{x},{y}/forecast/hourly API call.

The flow of your application can look something like this:

Step 1: Get your map Geo coordinates. In my case, I am at 35,-106

Step 2: Make a call to the weather.gov API: https://api.weather.gov/points/35,-106. You will be presented with some JSON data. Look for the cwa key in the properties object. That will be the forecast office to pass into the next api call. In my case, the key is ABQ. You also need to find the gridX and gridY keys in the properties. These are the XY coordinates that you will use for the {X},{Y} parameters in the API call. In my case X = 121 and Y = 112.

Step 3: Make the final call to the weather.gov API: https://api.weather.gov/gridpoints/ABQ/121,112/forecast/hourly

2 of 2
4

As long as you have the latitude/longitude of the location you want the forecast for, then:

  1. Get the point metadata from https://api.weather.gov/points/{lat},{lon}
  2. Follow the link in the forecastHourly property to get the forecast

This is preferable to constructing the URL as in the other answer, as your program won't break if the URL scheme changes in the future.

🌐
Aviation Weather
aviationweather.gov › data › api
Data API
Documentation and examples for the Data API offered by AviationWeather
🌐
GitHub
github.com › weather-gov › api › discussions › 558
Retrieving Current Temps via API · weather-gov/api · Discussion #558
It takes a little more footwork with the weather.gov API to answer that kind of question, especially since no geocoding features are provided. This is how you'd get a measured temperature near to a given point. If you call /points/XXXXXX,YYYYYYY, with the lat/lon, the properties/observationStations key provides another API call, /gridpoints/AA,BB/stations, that returns a list of weather stations near that point, sorted by distance.
Author   weather-gov
🌐
Home Assistant
community.home-assistant.io › configuration
NWS Integration API Key - Where to obtain ley? - Configuration - Home Assistant Community
December 7, 2020 - I’ve been trying to integrate an alternative that still provides a free API. I’m attempting to integrate National Weather Service (NWS). The problem is that when I go to add the integration it requires an API Key. But going to the NWS webiste (https://www.weather.gov/...
🌐
Weather
api.weather.gov
Weather API - Weather.gov
Secure .gov websites use HTTPS A lock ( ) or https:// means you’ve safely connected to the .gov website.
🌐
Zenoss
zenpacks.zenoss.io › zdk › start › http › nws-api
NWS API - ZenPack Documentation
{ "@context": [ "https://raw.githubusercontent.com/geojson/geojson-ld/master/contexts/geojson-base.jsonld", { "wx": "https://api.weather.gov/ontology#", "s": "https://schema.org/", "geo": "http://www.opengis.net/ont/geosparql#", "unit": "http://codes.wmo.int/common/unit/", "@vocab": "https://api.weather.gov/ontology#", "geometry": { "@id": "s:GeoCoordinates", "@type": "geo:wktLiteral" }, "city": "s:addressLocality", "state": "s:addressRegion", "distance": { "@id": "s:Distance", "@type": "s:QuantitativeValue" }, "bearing": { "@type": "s:QuantitativeValue" }, "value": { "@id": "s:value" }, "unit
🌐
Adafruit Playground
adafruit-playground.com › u › CGrover › pages › weather-gov-a-truly-free-weather-api
weather.gov: A Truly Free Weather API | Adafruit Playground
July 26, 2024 - After reviewing many of the free-ish weather API offerings, I stumbled on the mythological metrological holy grail, the NOAA National Weather Service (NWS) API Web Service. The NWS API provides free access to alerts, observations, and forecasts without the need for a user account or API key.
🌐
WeatherUSA
weatherusa.net › services › weather-api › docs
Documentation: Weather API | weatherUSA
The Weather API is also used to communicate with our databases for WeatherNet Aware and our white-label alerting service, allowing you to create and modify weather alert subscriptions for your locations by remote calls. All API requests must use an access token (key).
🌐
National Weather Service
weather.gov › media › owp › oh › docs › NWPS_API_Flyer_V6.pdf pdf
National Water Prediction Service (NWPS) API Data ...
Information shared through the new National Weather Service (NWS) National Water Prediction Service (NWPS) is · now fully accessible through an Application Programming Interface (API) via the web link provided below. From the