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
1 hour
Range
Latest
Regions
Global
/airquality/archive
A historical dataset providing comprehensive air quality data around the globe.
5x Multiplier
Actions
:id, route
Updates
1 hour
Range
Jan 2024 to now
Regions
Global
/airquality/forecasts
Future air quality around the globe including each individual pollutant.
5x Multiplier
Actions
:id, route
Updates
1 hour
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
Australia, Brazil, Canada, Europe, India, Mexico, South Africa, South Korea, US
/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
Canada, Europe, US
/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 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 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
1568 to now
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
Canada, US
/fires/outlook
SPC's outlook for weather conditions that will promote the spread of fires.
Actions
:id, affects, contains, search, within
Updates
2x/day
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
1 hour
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, within
Updates
Real-time
Range
2016 to now
Regions
Global
/lightning/analytics
An extension of the global lightning endpoint which includes damage potential and an error ellipse for each strike.
12x Multiplier
Actions
:id, closest, route, within
Updates
Real-time
Range
2016 to now
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
-5 minutes
Regions
Global
/lightning/threats
Lightning nowcasts providing global potential thunderstorm activity.
10x Multiplier
Actions
:id, closest, contains, affects, route
Updates
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
6 hours
Range
-48 hours to +15 days
Regions
Global
/maritime/archive
Historical maritime data available around the globe.
5x Multiplier
Actions
:id, route
Updates
1 hour
Range
2024 to now
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
Alaska, Continental US, 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
Alaska, Continental US, 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-60+ minutes (varies by 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 station)
Range
2011-08-02 to now
Regions
Global
/observations/summary
Daily summaries based on previously recorded observations. Daily summaries are available through 2011.
Actions
:id, closest, within
Updates
20 minutes
Range
2011-08-02 to now
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
Canada, US
/rivers
U.S. lake and river gauges collected and distributed by NOAA's AHPS department.
Actions
:id, closest, within, search
Updates
1 hour
Range
Latest
Regions
Alaska, Continental US, 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
Alaska, Continental US, 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
6 hours; 15 min the first +2 hours
Range
+24 hours
Regions
Australia, Canada, Europe, Japan, New Zealand, US
/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
6 hours; 15 min the first +2 hours
Range
+24 hours
Regions
Australia, Canada, Europe, Japan, New Zealand, US
/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
6 hours; 15 min the first +2 hours
Range
+24 hours
Regions
Australia, Canada, Europe, Japan, New Zealand, US
/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
2-3 Minutes
Range
Latest
Regions
Guam, Puerto Rico, US
/stormcells/summary
A summary of active storm cells per the /stormcells endpoint.
Actions
:id, affects, search, within
Updates
2-3 minutes
Range
Latest
Regions
Guam, Puerto Rico, US
/stormreports
Local storm reports transmitted by the National Weather Service in the U.S.
Actions
:id, closest, within, search
Updates
15 minutes
Range
1950-01-03 to now
Regions
US
/stormreports/summary
A summary of storm reports derived from the /stormreports endpoint.
Actions
:id, within, search
Updates
15 minutes
Range
1950-01-03 to now
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.
Actions
:id
Updates
Near real-time
Range
Latest
Regions
Global
/tides
Current and forecast tide levels for US coasts.
Actions
:id, closest, within, search
Updates
1 month
Range
-
Regions
US
/tides/stations
General information about a specific tides station.
Actions
:id, closest, within, search
Updates
N/A
Range
-
Regions
Guam, Puerto Rico, US
/tropicalcyclones
Provides information on active tropical cyclones across the globe.
Actions
:all, closest, search, within, affects
Updates
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
closest, search, within, affects
Updates
6 hours; NHC storms up to 1-3 hours near landfall
Range
1851-06-25 to now
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)