US Weather API
Overview
The US Weather API is the official National Weather Service (NWS) REST API provided by the US government, offering free and unlimited access to forecasts, alerts, and observation data for the United States. It requires no API key, making it the easiest way to add weather data to any US-focused application. Beginners can retrieve a 7-day forecast for any US location using just the geographic coordinates.
Beginner Tip
No API key or registration is needed. Use a two-step process: first get the grid point from coordinates, then fetch the forecast from the returned forecast URL.
Available Data
Example Response
{
"location": "Tokyo",
"temperature": {
"current": 22,
"feels_like": 24,
"min": 18,
"max": 26
},
"condition": "Partly Cloudy",
"humidity": 65,
"wind": {
"speed": 12,
"direction": "NE"
},
"forecast": [
{
"date": "2025-01-16",
"high": 25,
"low": 17,
"condition": "Sunny"
}
]
} Field Reference
properties.forecast URL to call to retrieve the 7-day forecast for this location properties.forecastHourly URL to retrieve hourly forecast data for the next 156 hours properties.gridId NWS office identifier (e.g. TOP) responsible for this location properties.gridX X coordinate on the NWS grid for this location properties.gridY Y coordinate on the NWS grid for this location properties.relativeLocation.properties.city Name of the nearest city to the queried coordinates Implementation Example
const url = "https://www.weather.gov/documentation/services-web-api";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
Common Errors & Troubleshooting
Matrix Score Breakdown
Fully tested on Apr 5, 2026
Technical Specifications
Related Tags
Similar APIs
View All →7Timer!
⭐ Beginner's Pick7Timer!
AviationWeather
AviationWeather.gov is a free NOAA service that provides official aviation weather data including METARs, TAFs, PIREPs, and SIGMETs used by pilots and flight planners.
Hong Kong Obervatory
⭐ Beginner's PickThe Hong Kong Observatory Open Data API provides free access to weather observations, forecasts, earthquake reports, and climate data for Hong Kong and the surrounding region.
MetaWeather
MetaWeather provides programmatic access to weather via REST API.
ODWeather
⭐ Beginner's PickODWeather is a free weather and webcam API from OceanDrivers that provides real-time marine and coastal weather data including wind, waves, and temperature.