Weather API Endpoints

Our subscriptions have changed. Upgrade to one of our new AerisWeather API, Maps, or Flex (API + Maps) subscriptions to access all available features, including historical access. Contact our team with any questions or to migrate offline contracts. Legacy plans will continue to have access to the select endpoints and layers included in their original plans.

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
Featured
Most Popular
Severe
Current Conditions
Forecasts
Historical
Geographical
Beta
Endpoint Description Actions
airquality/forecasts

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

Data CoverageGlobal

Included WithFlex, API, 

:id
alerts/summary

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

Data CoverageUSA, Canada, Europe

Included WithAPI, Flex, 

: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, 

: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
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 WithAPI, Flex, 

Update IntervalReal Time

:id
closest
search
within
normals

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

Data CoverageContinental US, Alaska, Hawaii

Included WithAPI, Flex, 

: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, 

:id
closest
within
search
observations

Current conditions provided by the closest weather station.

Data CoverageGlobal

Included WithAPI, Flex, 

Update IntervalAirports - 60 minutes, Other - 1-15 minutes

:id
closest
within
search
route
observations/archive

Historical observations by day dating back to 2011.

For access to dates beyond yesterday, an Archive Add-On is required.

Data CoverageGlobal

Included WithAPI, Flex, 

Update IntervalAirports - 60 minutes, Other - 1-15 minutes

:id
closest
within
search
observations/summary

Daily summaries based on previously recorded observations. Daily summaries can go back as far as 2011.

For access to dates beyond yesterday, an Archive Add-On is required.

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, 

: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, 

:id
closest
within
search
places/postalcodes

Provides geographical information for US and Canadian postal codes.

Data CoverageUSA, Canada

Included WithAPI, Flex, 

: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, 

:id
closest
search
within
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, 

:id
search
within
sunmoon

Global sun and moon rise / set data.

Data CoverageGlobal

Included WithAPI, Flex, 

:id
sunmoon/moonphases

Current phase of the moon.

Data CoverageGlobal

Included WithAPI, Flex, 

: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

Included WithAPI, Flex, 

:id
closest
within
search
version

Weather API current version.

Included WithAPI, Flex, 

winter/snowdepth

Estimated snow depth across North America.

Data CoverageContinental US, Canada

Included WithAPI, Flex, 

Update IntervalDaily

:id
closest

Last modified: August 24, 2021