Skip to Content
Weather API1.43.5
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  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
Regions
Global
Actions
:id, route
Updates
1 hour
Range
Latest
/airquality/archive
A historical dataset providing comprehensive air quality data around the globe.
5x Multiplier
Regions
Global
Actions
:id, route
Updates
1 hour
Range
Jan 2024 to now
/airquality/forecasts
Future air quality around the globe including each individual pollutant.
5x Multiplier
Regions
Global
Actions
:id, route
Updates
1 hour
Range
+5 days
/airquality/index
Air Quality Index for locations around the world
Regions
Global
Actions
:id, route
Updates
Hourly
Range
Latest
/alerts
Mild to severe weather events issued to the public from the Canadian, European, and US governments.
Regions
Australia, Brazil, Canada, Europe, India, Japan, Mexico, South Africa, South Korea, US
Actions
:id, route
Updates
Near real-time
Range
Latest
/alerts/summary
Summary of active weather events across Canada, the US, and Europe. This endpoint is derived from the /alerts endpoint.
Regions
Australia, Brazil, Canada, Europe, India, Japan, Mexico, South Africa, South Korea, US
Actions
:id, search, within
Updates
Near real-time
Range
Latest
/conditions
Global current, forecast, and past conditions for a specific date/time or in hourly intervals. Minutely precipitation forecasts are also available.
Regions
Global
Actions
:id, route
Updates
Near real-time
Range
2004 to +15days
/conditions/summary
Global current and past conditions as a daily summary or a summary in specified intervals.
Regions
Global
Actions
:id, route
Updates
Near real-time
Range
2004 to +15 days
/convective/outlook
SPC's outlook for convective activity across the US. This includes the SPC's convective, hail, tornado, wind, and thunderstorm product.
Regions
Continental US
Actions
:id, affects, contains, search
Updates
Range
+8 days
/countries
Geographical data related to countries around the world.
Regions
Global
Actions
:id, search
Updates
Variable
Range
-
/droughts/monitor
Official drought areas per the National Drought Mitigation Center.
Regions
Continental US
Actions
:id, affects, contains, search
Updates
Weekly
Range
Latest
/earthquakes
Global earthquake data including magnitude, depth, and type.
Regions
Global
Actions
:id, closest, within, search, affects
Updates
Near real-time
Range
1568 to now
/fires
Wildfires across the U.S. and Canada with data including type, cause, area, and percent contained.
Regions
Canada, US
Actions
:id, closest, within, search
Updates
Near real-time
Range
Latest
/fires/outlook
SPC's outlook for weather conditions that will promote the spread of fires.
Regions
Continental US
Actions
:id, affects, contains, search, within
Updates
2x/day
Range
+8 days
/forecasts
Future weather conditions around the globe. We support daily, hourly, and many other forecast intervals.
Regions
Global
Actions
:id, route
Updates
1 hour
Range
+15 days
/hail/archive
Historical data providing hail occurrence and severity insight
12x Multiplier
Regions
Australia, Canada, Europe, Japan, US
Actions
:id
Updates
Hourly
Range
2024-01-01 (US), 2024-03-08 (Europe), and 2025-02-01 (Other Regions)
/hail/threats
Hail threats derived from Xweather's nowcast data
12x Multiplier
Regions
Australia, Canada, Europe, Japan, US
Actions
:id, closest, contains, route
Updates
Real-time
Range
Now to +60 minutes
/impacts/:activity
Global assessment of suboptimal weather conditions for a variety of business needs and activities.
25x Multiplier
Regions
Global
Actions
:id, route
Updates
Real-time
Range
Latest
/indices/:type
Indices for health and outdoor activities as based on common weather observations and forecasts.
Regions
Global
Actions
:id, route
Updates
Real-time
Range
+15 days
/lightning
Global lightning data based on location queries. Endpoint provides data such as location, amperage, and type of strike.
10x Multiplier
Regions
Global
Actions
:id, closest, route, within
Updates
Real-time
Range
2016 to now
/lightning/analytics
An extension of the global lightning endpoint which includes damage potential and an error ellipse for each strike.
12x Multiplier
Regions
Global
Actions
:id, closest, route, within
Updates
Real-time
Range
2016 to now
/lightning/density
Provides long-term lightning climatology by returning the 10-year average annual lightning strike density for a specific location, measured as strikes per square kilometer per year.
Regions
Global
Actions
:id
Updates
N/A
Range
-
/lightning/flash
Global lightning flash data based on location queries.
Regions
Global
Actions
:id, closest, route
Updates
Real-time
Range
-5 minutes
/lightning/summary
A summary of lightning strikes that took place across the globe. Search can be limited by intracloud, cloud-to-ground, or both.
Regions
Global
Actions
:id, closest
Updates
Real-time
Range
-5 minutes
/lightning/threats
Lightning nowcasts providing global potential thunderstorm activity.
10x Multiplier
Regions
Global
Actions
:id, closest, contains, affects, route
Updates
2 minutes
Range
+1 hour
/lightning/turbinerisk
Estimates the expected annual lightning strike frequency for a wind turbine at a specific location using long-term lightning climatology and turbine height.
Regions
Global
Actions
:id
Updates
N/A
Range
-
/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.
Regions
Global
Actions
:id, route
Updates
6 hours
Range
-48 hours to +15 days
/maritime/archive
Historical maritime data available around the globe.
5x Multiplier
Regions
Global
Actions
:id, route
Updates
1 hour
Range
2024 to now
/models/:model
Returns raw forecast model data for a single forecast model at a requested location. Each response is a time series of forecast periods drawn from one model run. Use the Models Catalog endpoint to discover which models, run times, and datasets are available before making a request.
Regions
Global
Actions
:id
Updates
Per model run cycle
Range
Varies by model
/models/catalog
Returns a catalog of the forecast models available through the API, including each model's accessible run times, forecast coverage, and the datasets (variables) it produces. Use this endpoint to discover what's available before requesting raw forecast data for a specific model from the /models/:model endpoint.
Regions
Global
Actions
:all
Updates
Per model run cycle
Range
+15 days
/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.
Regions
Alaska, Continental US, Hawaii
Actions
:id, closest, within, search, route
Updates
N/A
Range
-
/normals/stations
The normals/stations dataset provides access to the complete co-op/station information that normals are available for.
Regions
Alaska, Continental US, Hawaii
Actions
:id, closest, within, search, route
Updates
N/A
Range
-
/observations
The observations data set provides access to current weather observations from a variety of reporting stations.
Regions
Global
Actions
:id, closest, within, search, route
Updates
1-60+ minutes (varies by station)
Range
Latest
/observations/archive
Historical observations by day are available through 2011.
Regions
Global
Actions
:id, closest, within
Updates
1-60+ minutes (varies by station)
Range
2011-08-02 to now
/observations/summary
Daily summaries based on previously recorded observations. Daily summaries are available through 2011.
Regions
Global
Actions
:id, closest, within
Updates
20 minutes
Range
2011-08-02 to now
/places
Geographical information for a given location. Including elevation, population, region, country, continent, etc.
Regions
Global
Actions
:id, closest, within, search
Updates
Monthly
Range
-
/places/airports
Geographical information about airports around the world.
Regions
Global
Actions
:id, closest, within, search
Updates
Near Real Time
Range
-
/places/postalcodes
Provides geographical information for US and Canadian postal codes.
Regions
Canada, US
Actions
:id, closest, within, search
Updates
N/A
Range
-
/renewables/irradiance/archive
Retrieve historical solar irradiance data for any location and date range, including detailed time series of solar energy measurements to analyze past solar potential or validate solar performance.
Regions
Africa, Central America, Europe, North America, South America
Actions
:id
Updates
Hourly
Range
2004-01-20 to 2025-09-30
/renewables/irradiance/summary
Retrieve historical irradiance averages for a specific location at monthly, annual, and overall resolutions. The fullYears summary provides daily average kWh m/2 and annual average kWh m/2.
10x Multiplier
Regions
Africa, Central America, Europe, North America, South America
Actions
:id
Updates
N/A
Range
2004-01-20 to 2025-09-30
/renewables/irradiance/tmy
Retrieve historical solar irradiance data for a specific location and resolution represented as a typical meteorogical year (TMY)
Regions
Africa, Central America, Europe, North America, South America
Actions
:id
Updates
N/A
Range
-
/rivers
U.S. lake and river gauges collected and distributed by NOAA's AHPS department.
Regions
Alaska, Continental US, Hawaii
Actions
:id, closest, within, search
Updates
1 hour
Range
Latest
/rivers/gauges
Enhanced data from rivers and lake gauges per the /rivers endpoint. Data includes recent crests, historical crests, and flood impacts.
Regions
Alaska, Continental US, Hawaii
Actions
:id, closest, search, within
Updates
N/A
Range
-
/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.
Regions
Australia, Canada, Europe, Japan, New Zealand, US
Actions
:id, route
Updates
6 hours; 15 min the first +2 hours
Range
+24 hours
/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
Regions
Australia, Canada, Europe, Japan, New Zealand, US
Actions
:id, route
Updates
6 hours; 15 min the first +2 hours
Range
+24 hours
/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
Regions
Australia, Canada, Europe, Japan, New Zealand, US
Actions
:id, route
Updates
6 hours; 15 min the first +2 hours
Range
+24 hours
/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.
Regions
Guam, Puerto Rico, US
Actions
:id, closest, within, search, affects
Updates
2-3 Minutes
Range
Latest
/stormcells/summary
A summary of active storm cells per the /stormcells endpoint.
Regions
Guam, Puerto Rico, US
Actions
:id, affects, search, within
Updates
2-3 minutes
Range
Latest
/stormreports
Local storm reports transmitted by the National Weather Service in the U.S.
Regions
US
Actions
:id, closest, within, search
Updates
15 minutes
Range
1950-01-03 to now
/stormreports/summary
A summary of storm reports derived from the /stormreports endpoint.
Regions
US
Actions
:id, within, search
Updates
15 minutes
Range
1950-01-03 to now
/sunmoon
Global sun and moon rise / set data.
Regions
Global
Actions
:id
Updates
N/A
Range
-
/sunmoon/moonphases
Current phase of the moon.
Regions
Global
Actions
:id, search, contains
Updates
N/A
Range
-
/tides
Current and forecast tide levels for US coasts.
Regions
US
Actions
:id, closest, within, search
Updates
1 month
Range
-
/tides/stations
General information about a specific tides station.
Regions
Guam, Puerto Rico, US
Actions
:id, closest, within, search
Updates
N/A
Range
-
/tropicalcyclones
Provides information on active tropical cyclones across the globe.
Regions
Global
Actions
:all, closest, search, within, affects
Updates
6 hours; NHC storms up to 1-3 hours near landfall
Range
Latest
/tropicalcyclones/archive
Provides archive information on global tropical cyclones.
Regions
Global
Actions
closest, search, within, affects
Updates
6 hours; NHC storms up to 1-3 hours near landfall
Range
1851-06-25 to now
/xcast/forecasts
Hyperlocal forecast data derived from Xcast sensors
Regions
Global
Actions
:id
Updates
1 hour
Range
+15days
IntroductionActions
© 2026 Xweather (opens in a new tab)Terms of Service (opens in a new tab)Privacy Policy (opens in a new tab)