Weather API Endpoints

To access Lightning, Lightning Summary, Lightning Threats, lightning mapping features, or historical lightning data, select our Lightning Add-On when building your Flex subscription or contact us to add it to your existing plan.
Lightning Flash data and mapping layers can be accessed from your Flex subscription.

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. The following endpoints are currently supported within AerisWeather.

To query multiple endpoints with a single weather API request review the Batch Requests feature.

All endpoints support the Schema Action, which will return the JSON specification for the endpoint.

All
Most Popular
Severe
Lightning
Current Conditions
Forecasts
Historical
Geographical
Endpoint Description Actions
airquality/forecasts

Future Air Quality Index around the globe including each individual pollutant.

Data CoverageGlobal

Included WithFlex, API, 

Update IntervalHourly

:id
alerts/summary

Summary of active weather events across Canada, the US, and Europe. This endpoint is derived from the /alerts endpoint.

Data CoverageUSA, Canada, Europe

Included WithAPI, Flex, 

Update IntervalNear Real Time

:id
search
within
convective/outlook

SPC’s outlook for convective activity across the US. This includes the SPC’s convective, hail, tornado, wind, and thunderstorm product.

Data CoverageContinental US

Included WithAPI, Flex, 

Update Interval~Every 6-12 hours (based on SPC)

:id
affects
contains
search
countries

Geographical data related to countries around the world.

Data CoverageGlobal

Included WithAPI, Flex, 

Update IntervalN/A

:id
search
droughts/monitor

Official drought areas per the National Drought Mitigation Center.

Data CoverageContinental US

Included WithAPI, Flex, 

Update IntervalWeekly (Thursdays)

:id
affects
contains
search
earthquakes

Global earthquake data including magnitude, depth, and type.

Data CoverageGlobal

Included WithAPI, Flex, 

Update IntervalEvery 2-3 minutes

:id
closest
within
search
affects
energy/farm

The energy farm endpoint provides energy output data for energy producing sites.

Data CoverageContinental US, Canada

Included WithAPI Developer, 

Update IntervalHourly

:id
fires

Wildfires across the U.S. and Canada with data including type, cause, area, and percent contained.

Data CoverageUSA, Canada

Included WithAPI, Flex, 

Update IntervalTen Minutes

:id
closest
within
search
fires/outlook

SPC’s outlook for weather conditions that will promote the spread of fires.

Data CoverageContinental US

Included WithAPI, Flex, 

Update Interval2x Daily

:id
affects
contains
search
within
indices

Global index for a variety of health and outdoor activities. Endpoint can provide current and forecast indices.

Data CoverageGlobal

Included WithAPI, Flex, 

Update IntervalReal Time

:id
route
lightning/summary

A summary of lightning strikes that took place across the globe. Search can be limited by intracloud, cloud-to-ground, or both.

Data CoverageGlobal

Included WithLightning Add-On, 

Update IntervalReal Time

:id
closest
lightning/threats

Lightning nowcasts providing global potential thunderstorm activity.

Data CoverageGlobal

Included WithLightning Add-On, 

Update IntervalEvery 2 minutes

:id
contains
closest
affects
route
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.

Data CoverageGlobal

Included WithFlex, API, 

Update IntervalEvery 6 Hours

:id
route
normals

The 30-year climate normals collected by NOAA across the United States.

Data CoverageContinental US, Alaska, Hawaii

Included WithAPI, Flex, 

Update IntervalN/A

:id
closest
within
search
normals/stations

Stations associated with collecting the climate data for the /normals endpoint.

Data CoverageContinental US, Alaska, Hawaii

Included WithAPI, Flex, 

Update IntervalN/A

:id
closest
within
search
observations

Current conditions provided by the closest weather station.

Data CoverageGlobal

Included WithAPI, Flex, 

Update Interval1 - 60+ minutes; varies by individual station

:id
closest
within
search
route
observations/archive

Historical observations by day are available through 2011.

Data CoverageGlobal

Included WithFlex, API, 

Update Interval1 - 60+ minutes; varies by individual station

:id
closest
within
search
observations/summary Daily summaries based on previously recorded observations. Daily summaries are available through 2011.

Data CoverageGlobal

Included WithAPI, Flex, 

Update IntervalEvery 20 minutes

:id
closest
search
within
phrases/summary

Phrase related to the current and expected conditions for the next several hours.

Data CoverageGlobal (Except Australia)

Included WithAPI, Flex, 

Update IntervalNear Real Time

:id
places

Geographical information for a given location. Including elevation, population, region, country, continent, etc.

Data CoverageGlobal

Included WithAPI, Flex, 

Update IntervalMonthly

:id
closest
within
search
places/airports

Geographical information about airports around the world.

Data CoverageGlobal

Included WithAPI, Flex, 

Update IntervalNear Real Time

:id
closest
within
search
places/postalcodes

Provides geographical information for US and Canadian postal codes.

Data CoverageUSA, Canada

Included WithAPI, Flex, 

Update IntervalN/A

:id
closest
within
search
rivers

U.S. lake and river gauges collected and distributed by NOAA’s AHPS department.

Data CoverageContinental US, Alaska, Hawaii

Included WithAPI, Flex, 

Update IntervalHourly

:id
closest
within
search
rivers/gauges

Enhanced data from rivers and lake gauges per the /rivers endpoint. Data includes recent crests, historical crests, and flood impacts.

Data CoverageContinental US, Alaska, Hawaii

Included WithAPI, Flex, 

Update IntervalN/A

:id
closest
search
within
roadweather

AerisWeather’s roadweather endpoint offers real-time, accurate road condition insights powered by Vaisala Xweather forecasts, enhancing user safety and decision-making for optimal driving experiences.

Data CoverageNorth America, Europe, Japan

Included WithFlex, API, 

Update IntervalEvery 15 Minutes

:id
route
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.

Data CoverageContinental US, Alaska, Hawaii, Puerto Rico, Guam

Included WithAPI, Flex, 

Update IntervalEvery 2-3 minutes

:id
closest
within
search
affects
stormcells/summary

A summary of active storm cells per the /stormcells endpoint.

Data CoverageContinental US, Alaska, Hawaii, Puerto Rico, Guam

Included WithAPI, Flex, 

Update IntervalEvery 2-3 minutes

:id
affects
search
within
stormreports

Local storm reports transmitted by the National Weather Service in the U.S.

Data CoverageContinental US, Alaska, Hawaii

Included WithAPI, Flex, 

Update IntervalEvery 15 minutes

:id
closest
within
search
stormreports/summary

A summary of storm reports derived from the /stormreports endpoint.

Data CoverageContinental US, Alaska, Hawaii

Included WithAPI, Flex, 

Update IntervalEvery 15 minutes

:id
search
within
sunmoon

Global sun and moon rise / set data.

Data CoverageGlobal

Included WithAPI, Flex, 

Update IntervalN/A

:id
sunmoon/moonphases

Current phase of the moon.

Data CoverageGlobal

Included WithAPI, Flex, 

Update IntervalN/A

:id
search
contains
threats

Localized threat summary based on the location provided. Endpoint currently supports U.S. locations.

Data CoverageContinental US, Alaska, Hawaii

Included WithAPI, Flex, 

Update IntervalNear Real Time

:id
tides

Current and forecast tide levels for US coasts.

Data CoverageContinental US, Alaska, Hawaii

Included WithAPI, Flex, 

Update IntervalMonthly

:id
closest
within
search
tides/stations

General information about a specific tides station.

Data CoverageContinental US, Alaska, Hawaii, Puerto Rico, Guam

Included WithAPI, Flex, 

Update IntervalN/A

:id
closest
within
search
tropicalcyclones/archive

Provides archive information on global tropical cyclones.

Data CoverageGlobal

Included WithAPI, Flex, 

Update IntervalEvery 6 hours; NHC storms up to 1-3 hours near landfall

:id
closest
search
within
affects
version

Weather API current version.

Included WithAPI, Flex, 

Last modified: May 15, 2023