Endpoints

Endpoints

Endpoints refer to the types of data to request, such as a place, observation, forecast, or advisory, and will be the basis for any request made to the Weather API. Some of our endpoints are only available as part of add-ons to your subscription and may incur additional costs. See our pricing page (opens in a new tab) for more information about the add-ons currently available.

All
All available datasets.
/airquality
Air Quality Index (AQI), Health Index (AQHI) and pollutant information globally.
5x Multiplier
Actions
:id, route
Updates
Hourly
Range
Latest
Regions
Global
/airquality/forecasts
Future air quality around the globe including each individual pollutant.
5x Multiplier
Actions
:id, route
Updates
Hourly
Range
+5 days
Regions
Global
/airquality/index
Air Quality Index for locations around the world
Actions
:id, route
Updates
Hourly
Range
Latest
Regions
Global
/alerts
Mild to severe weather events issued to the public from the Canadian, Eurpoean, and US governments.
Actions
:id, route
Updates
Near real-time
Range
Latest
Regions
US, Canada, Europe
/alerts/summary
Summary of active weather events across Canada, the US, and Europe. This endpoint is derived from the /alerts endpoint.
Actions
:id, search, within
Updates
Near real-time
Range
Latest
Regions
US, Europe, Canada
/conditions
Global current, forecast, and past conditions for a specific date/time or in hourly intervals. Minutely precipitation forecasts are also available.
Actions
:id, route
Updates
Near real-time
Range
2011-01-01 to +15days
Regions
Global
/conditions/summary
Global current and past conditions as a daily summary or a summary in specified intervals.
Actions
:id, route
Updates
Near Real Time
Range
2011-01-01 to +15 days
Regions
Global
/convective/outlook
SPC's outlook for convective activity across the US. This includes the SPC's convective, hail, tornado, wind, and thunderstorm product.
Actions
:id, affects, contains, search
Updates
Range
+8 days
Regions
Continental US
/countries
Geographical data related to countries around the world.
Actions
:id, search
Updates
Variable
Range
-
Regions
Global
/droughts/monitor
Official drought areas per the National Drought Mitigation Center.
Actions
:id, affects, contains, search
Updates
Weekly
Range
Latest
Regions
Continental US
/earthquakes
Global earthquake data including magnitude, depth, and type.
Actions
:id, closest, within, search, affects
Updates
Near real-time
Range
From 1568-01-01
Regions
Global
/energy/farm
The energy farm endpoint provides energy output data for energy producing sites.
Actions
:id
Updates
Near real-time
Range
-24 hours
Regions
Continental US
/fires
Wildfires across the U.S. and Canada with data including type, cause, area, and percent contained.
Actions
:id, closest, within, search
Updates
Near real-time
Range
Latest
Regions
US, Canada
/fires/outlook
SPC's outlook for weather conditions that will promote the spread of fires.
Actions
:id, affects, contains, search, within
Updates
2x Daily
Range
+8 days
Regions
Continental US
/forecasts
Future weather conditions around the globe. We support daily, hourly, and many other forecast intervals.
Actions
:id, route
Updates
Hourly
Range
+15 days
Regions
Global
/indices/:type
Indices for health and outdoor activities as based on common weather observations and forecasts.
Actions
:id, route
Updates
Real Time
Range
+15 days
Regions
Global
/lightning
Global lightning data based on location queries. Endpoint provides data such as location, amperage, and type of strike.
10x Multiplier
Actions
:id, closest, route
Updates
Real Time
Range
-5 minutes
Regions
Global
/lightning/archive
Global lightning data based on location queries. Endpoint provides data such as location, amperage, and type of strike. Archive data is available from Jan 2016 through the current date/time.
10x Multiplier
Actions
:id, closest, route
Updates
Real Time
Range
From 2016-01-01
Regions
Global
/lightning/flash
Global lightning flash data based on location queries.
Actions
:id, closest, route
Updates
Real Time
Range
-5 minutes
Regions
Global
/lightning/summary
A summary of lightning strikes that took place across the globe. Search can be limited by intracloud, cloud-to-ground, or both.
Actions
:id, closest
Updates
Real Time
Range
-5min
Regions
Global
/lightning/threats
Lightning nowcasts providing global potential thunderstorm activity.
10x Multiplier
Actions
:id, closest, contains, affects, route
Updates
Every 2 minutes
Range
+1 hour
Regions
Global
/maritime
The maritime API provides essential global marine weather data for navigation, offshore operations, coastal monitoring, and recreational activities, with flexible hourly or other intervals.
Actions
:id, route
Updates
Every 6 Hours
Range
-48 hrs to +15 days
Regions
Global
/normals
The normals endpoint provides access to the 30-year climate normals for US locations. This endpoint allows the receipt of up to one month of information per request.
Actions
:id, closest, within, search, route
Updates
N/A
Range
-
Regions
Continental US, Alaska, Hawaii
/normals/stations
The normals/stations dataset provides access to the complete co-op/station information that normals are available for.
Actions
:id, closest, within, search, route
Updates
N/A
Range
-
Regions
Continental US, Alaska, Hawaii
/observations
The observations data set provides access to current and archived weather observations from a variety of reporting stations.
Actions
:id, closest, within, search, route
Updates
1 to 60+ minutes; varies by individual station
Range
Latest
Regions
Global
/observations/archive
Historical observations by day are available through 2011.
Actions
:id, closest, within
Updates
1 - 60+ minutes; varies by individual station
Range
From 2011-08-02
Regions
Global
/observations/summary
Daily summaries based on previously recorded observations. Daily summaries are available through 2011.
Actions
:id, closest, within
Updates
Every 20 minutes
Range
From 2011-08-02
Regions
Global
/phrases/summary
Phrase related to the current and expected conditions for the next several hours.
Actions
:id
Updates
Near Real Time
Range
Latest
Regions
Global
/places
Geographical information for a given location. Including elevation, population, region, country, continent, etc.
Actions
:id, closest, within, search
Updates
Monthly
Range
-
Regions
Global
/places/airports
Geographical information about airports around the world.
Actions
:id, closest, within, search
Updates
Near Real Time
Range
-
Regions
Global
/places/postalcodes
Provides geographical information for US and Canadian postal codes.
Actions
:id, closest, within, search
Updates
N/A
Range
-
Regions
US, Canada
/rivers
U.S. lake and river gauges collected and distributed by NOAA's AHPS department.
Actions
:id, closest, within, search
Updates
Hourly
Range
Latest
Regions
Continental US, Alaska, Hawaii
/rivers/gauges
Enhanced data from rivers and lake gauges per the /rivers endpoint. Data includes recent crests, historical crests, and flood impacts.
Actions
:id, closest, search, within
Updates
N/A
Range
-
Regions
Continental US, Alaska, Hawaii
/roadweather
The roadweather endpoint offers real-time, accurate road condition insights powered by Vaisala Xweather forecasts, enhancing user safety and decision-making for optimal driving experiences.
Actions
:id, route
Updates
Every 15 Minutes
Range
-12 hours to +12 hours
Regions
US, Europe, Japan, Canada, Australia, New Zealand
/roadweather/analytics
The roadweather/analytics endpoint offers real-time, accurate road condition insights powered by Vaisala Xweather forecasts, enhancing user safety and decision-making for optimal driving experiences.
10x Multiplier
Actions
:id, route
Updates
Every 15 Minutes
Range
-12 hours to +12 hours
Regions
US, Canada, Europe, Japan, New Zealand, Australia
/roadweather/conditions
The roadweather/conditions endpoint offers real-time, accurate road condition insights powered by Vaisala Xweather forecasts, enhancing user safety and decision-making for optimal driving experiences.
5x Multiplier
Actions
:id, route
Updates
Every 15 Minutes
Range
-12 hours to +12 hours
Regions
US, Canada, Japan, Europe, Australia, New Zealand
/stormcells
Observed storm cells and their forecast tracks per the NEXRAD radar system in the U.S. Data will include general, hail, rotating, and tornadic storm cells.
Actions
:id, closest, within, search, affects
Updates
Every 2 - 3 Minutes
Range
Latest
Regions
US, Puerto Rico, Guam
/stormcells/summary
A summary of active storm cells per the /stormcells endpoint.
Actions
:id, affects, search, within
Updates
Every 2 - 3 Minutes
Range
Latest
Regions
US, Puerto Rico, Guam
/stormreports
Local storm reports transmitted by the National Weather Service in the U.S.
Actions
:id, closest, within, search
Updates
Every 15 Minutes
Range
From 1950-01-03
Regions
US
/stormreports/summary
A summary of storm reports derived from the /stormreports endpoint.
Actions
:id, within, search
Updates
Every 15 Minutes
Range
From 1950-01-03
Regions
US
/sunmoon
Global sun and moon rise / set data.
Actions
:id
Updates
N/A
Range
-
Regions
Global
/sunmoon/moonphases
Current phase of the moon.
Actions
:id, search, contains
Updates
N/A
Range
-
Regions
Global
/threats
Localized threat summary based on the location provided. Endpoint currently supports U.S. locations.
Actions
:id
Updates
Near Real Time
Range
Latest
Regions
US, Puerto Rico, Guam
/tides
Current and forecast tide levels for US coasts.
Actions
:id, closest, within, search
Updates
Monthly
Range
-
Regions
US
/tides/stations
General information about a specific tides station.
Actions
:id, closest, within, search
Updates
N/A
Range
-
Regions
US, Guam, Puerto Rico
/tropicalcyclones
Provides information on active tropical cyclones across the globe.
Actions
:all, closest, search, within, affects
Updates
Every 6 hours; NHC storms up to 1-3 hours near landfall
Range
Latest
Regions
Global
/tropicalcyclones/archive
Provides archive information on global tropical cyclones.
Actions
:all, closest, search, within, affects
Updates
Every 6 hours; NHC storms up to 1-3 hours near landfall
Range
From 1851-06-25
Regions
Global
IntroductionActions
support

Need help? Contact support (opens in a new tab).

c-question

Have questions? Contact sales (opens in a new tab).

© 2024 Xweather (opens in a new tab)Terms of Service (opens in a new tab)Privacy Policy (opens in a new tab)