Weather

US Weather

weather.gov API

Maps & location#weather

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

weather.gov API

Endpoints 69

  • GETalerts_query/alertsReturns all alerts
  • GETalerts_active/alerts/activeReturns all currently active alerts
  • GETalerts_active_count/alerts/active/countReturns info on the number of active alerts
  • GETalerts_active_zone/alerts/active/zone/:zoneIdReturns active alerts for the given NWS public zone or county
  • GETalerts_active_area/alerts/active/area/:areaReturns active alerts for the given area (state or marine area)
  • GETalerts_active_region/alerts/active/region/:regionReturns active alerts for the given marine region
  • GETalerts_types/alerts/typesReturns a list of alert types
  • GETalerts_single/alerts/:idReturns a specific alert
  • GETcwsu/aviation/cwsus/:cwsuIdReturns metadata about a Center Weather Service Unit
  • GETcwas/aviation/cwsus/:cwsuId/cwasReturns a list of Center Weather Advisories from a CWSU
  • GETcwa/aviation/cwsus/:cwsuId/cwas/:date/:sequenceReturns a list of Center Weather Advisories from a CWSU
  • GETsigmetQuery/aviation/sigmetsReturns a list of SIGMET/AIRMETs
  • GETsigmetsByATSU/aviation/sigmets/:atsuReturns a list of SIGMET/AIRMETs for the specified ATSU
  • GETsigmetsByATSUByDate/aviation/sigmets/:atsu/:dateReturns a list of SIGMET/AIRMETs for the specified ATSU for the specified date
  • GETsigmet/aviation/sigmets/:atsu/:date/:timeReturns a specific SIGMET/AIRMET
  • GETglossary/glossaryReturns glossary terms
  • GETgridpoint/gridpoints/:wfo/:x,:yReturns raw numerical forecast data for a 2.5km grid area
  • GETgridpoint_forecast/gridpoints/:wfo/:x,:y/forecastReturns a textual forecast for a 2.5km grid area
  • GETgridpoint_forecast_hourly/gridpoints/:wfo/:x,:y/forecast/hourlyReturns a textual hourly forecast for a 2.5km grid area
  • GETgridpoint_stations/gridpoints/:wfo/:x,:y/stationsReturns a list of observation stations usable for a given 2.5km grid area
  • GETicons/icons/:set/:timeOfDay/:firstDeprecated. Returns a forecast icon. Icon services in API are deprecated.
  • GETiconsDualCondition/icons/:set/:timeOfDay/:first/:secondDeprecated. Returns a forecast icon. Icon services in API are deprecated.
  • GETicons_summary/iconsDeprecated. Returns a list of icon codes and textual descriptions. Icon services in API are deprecated.
  • GETsatellite_thumbnails/thumbnails/satellite/:areaDeprecated. Returns a thumbnail image for a satellite region. Image services in API are deprecated.
  • GETstation_observation_list/stations/:stationId/observationsReturns a list of observations for a given station
  • GETstation_observation_latest/stations/:stationId/observations/latestReturns the latest observation for a station
  • GETstation_observation_time/stations/:stationId/observations/:timeReturns a single observation.
  • GETtafs/stations/:stationId/tafsReturns Terminal Aerodrome Forecasts for the specified airport station.
  • GETtaf/stations/:stationId/tafs/:date/:timeReturns a single Terminal Aerodrome Forecast.
  • GETobs_stations/stationsReturns a list of observation stations.
  • GETobs_station/stations/:stationIdReturns metadata about a given observation station
  • GEToffice/offices/:officeIdReturns metadata about a NWS forecast office
  • GEToffice_briefing/offices/:officeId/briefingReturns active briefing for an NWS office
  • GEToffice_briefing_download_latest/offices/:officeId/briefing/download/latestReturns the latest briefing for an office
  • GEToffice_briefing_download/offices/:officeId/briefing/download/:briefingIdReturns a briefing for an office
  • GEToffice_headline/offices/:officeId/headlines/:headlineIdReturns a specific news headline for a given NWS office
  • GEToffice_headlines/offices/:officeId/headlinesReturns a list of news headlines for a given NWS office
  • GEToffice_weatherstory/offices/:officeId/weatherstoriesReturns active weather stories for an NWS office
  • GEToffice_weatherstory_image/offices/:officeId/weatherstories/download/:imageIdReturns the image for a weather story
  • GETpoint/points/:latitude,:longitudeReturns metadata about a given latitude/longitude point
  • GETpoint_radio/points/:latitude,:longitude/radioReturns NOAA Weather Radio broadcast script for a latitude/longitude point
  • GETpoint_stations/points/:latitude,:longitude/stationsDeprecated. Returns a list of observation stations for a given point
  • GETradar_servers/radar/serversReturns a list of radar servers
  • GETradar_server/radar/servers/:idReturns metadata about a given radar server
  • GETradar_spgds/radar/spgdsReturns a list of radar spgds
  • GETradar_stations/radar/stationsReturns a list of radar stations
  • GETradar_station/radar/stations/:stationIdReturns metadata about a given radar station
  • GETradar_station_alarms/radar/stations/:stationId/alarmsReturns metadata about a given radar station alarms
  • GETradar_queue/radar/queues/:hostReturns metadata about a given radar queue
  • GETradar_profiler/radar/profilers/:stationIdReturns metadata about a given radar wind profiler
  • GETtransmitters/radioReturns a collection of transmitters
  • GETtransmitter/radio/:callSignReturns a single transmitter
  • GETarea_radio/radio/:callSign/broadcastReturns NOAA Weather Radio broadcast script for a transmitter
  • GETproducts_query/productsReturns a list of text products
  • GETproduct_locations/products/locationsReturns a list of valid text product issuance locations
  • GETproduct_types/products/typesReturns a list of valid text product types and codes
  • GETproduct/products/:productIdReturns a specific text product
  • GETproducts_type/products/types/:typeIdReturns a list of text products of a given type
  • GETproducts_type_locations/products/types/:typeId/locationsReturns a list of valid text product issuance locations for a given product type
  • GETlocation_products/products/locations/:locationId/typesReturns a list of valid text product types for a given issuance location
  • GETproducts_type_location/products/types/:typeId/locations/:locationIdReturns a list of text products of a given type for a given issuance location
  • GETlatest_product_type_location/products/types/:typeId/locations/:locationId/latestReturns latest text products of a given type for a given issuance location with product text
  • GETzone_list/zonesReturns a list of zones
  • GETzone_list_type/zones/:typeReturns a list of zones of a given type
  • GETzone/zones/:type/:zoneIdReturns metadata about a given zone
  • GETzone_forecast/zones/:type/:zoneId/forecastReturns the current zone forecast for a given zone
  • GETtransmitter_zone/zones/:type/:zoneId/radioReturns transmitter object for a given zone
  • GETzone_obs/zones/forecast/:zoneId/observationsReturns a list of observations for a given zone
  • GETzone_stations/zones/forecast/:zoneId/stationsReturns a list of observation stations for a given zone

API details

Base URL
https://api.weather.gov
Authentication
An API key in the User-Agent header
An API key in the API-Key header
Operations
69 operations on 69 pathsGET 69
5 marked deprecated
Response formats
application/ld+json application/geo+json application/ssml+xml application/vnd.noaa.uswx+xml
Description format
OpenAPI 3.1.2, API version 3.12.2

How to test the US Weather in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the US Weather collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the User-Agent header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “alerts_query” (GET /alerts), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the US Weather?

weather.gov API It is listed under Maps & location and has 69 endpoints.

Who publishes the US Weather?

It is listed from Weather's public API description (an OpenAPI document), not published by Weather on Swastik Codes. Anyone who controls weather.gov can claim the profile by adding a DNS TXT record.

What is the base URL of the US Weather?

Requests go to https://api.weather.gov. Endpoint paths are added to this base URL.

How do I authenticate with the US Weather?

It accepts 2 methods: an API key in the User-Agent header; an API key in the API-Key header.

How many endpoints does the US Weather have?

69 operations on 69 paths (69 GET).

Is forking the US Weather free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.