Skip to content

NWS API

NWS (weather.gov) has 4 public methods: get National Weather Service forecast, get hourly forecast, list weather alerts and get current conditions. Each costs 1 credit per completed run (1¢ with pay as you go); failed runs are free.

weather.gov (opens in a new tab)

Unofficial. Not affiliated with or endorsed by NWS.

Methods

4

  • Get National Weather Service forecast

    Looks up the National Weather Service seven-day day and night forecast for a U.S. city, address, or ZIP code. Forecast availability depends on NWS land-grid coverage.

    Returns matched place, forecast office, update time, grid position, coordinates, and day and night forecast periods

    Readweather.gov/get_forecast

  • Get hourly forecast

    Looks up a US city, street address or ZIP code and returns up to 156 hourly National Weather Service forecasts for it.

    Returns matched place, coordinates, forecast office, hourly temperature, precipitation, humidity, dew point, wind and conditions

    Readweather.gov/get_hourly_forecast

  • List weather alerts

    Lists active US weather watches, warnings and advisories for a city, address, ZIP code or state, most severe first, then newest.

    Returns event, severity, urgency, headline, areas affected, effective and expiry times, description, instructions, issuing office, page URL, alert ID

    Readweather.gov/list_weather_alerts

  • Get current conditions

    Gets the latest observed weather from a nearby National Weather Service station for a US city, address, or ZIP code. Measurements the station does not report are null.

    Returns station name and code, distance, observation time, conditions, temperature, feels-like, humidity, dew point, wind, gust, pressure, visibility, page URL

    Readweather.gov/get_current_conditions