1. Help Center
  2. Documentation
  3. Documentation

AerisWeather API

Common API Queries

The following list provides common API queries based on particular industries and/or applications.

Note: You will need to append your client credentials to the URLs provided below (e.g. &client_id=[ID]&client_secret=[SECRET]), which can be found under the Apps section of the members area. For queries that rely on specific date ranges, replace the [START_DATE] and [END_DATE] variables in the URLs below with a valid date string.

All
Agriculture
Digital Marketing
Energy & Utilities
Mobile Apps
Smart Home
Transportation & Logistics

https://api.aerisapi.com/tropicalcyclones?p=&filter=all&client_id=[ID]&client_secret=[SECRET]

Application Tropical Cyclone Alerts
Endpoint tropicalcyclones

https://api.aerisapi.com/airquality/beijing,cn?filter=china&client_id=[ID]&client_secret=[SECRET]

Application Current Air Quality (China Scale)
Endpoint airquality

https://api.aerisapi.com/airquality/closest?p=beijing,cn&limit=10&client_id=[ID]&client_secret=[SECRET]

Application Nearby Air Quality
Endpoint airquality

https://api.aerisapi.com/airquality/forecasts/dallas,texas?&from=[START_DATE]&client_id=[ID]&client_secret=[SECRET]

Application Air Health Forecast
Endpoint airquality/forecasts

https://api.aerisapi.com/airquality/forecasts/mexico%city,mx&client_id=[ID]&client_secret=[SECRET]

Application Air Quality Forecast
Endpoint airquality/forecasts

https://api.aerisapi.com/conditions/31.43799,121.186?&from=[START_DATE]&to=+1day&limit=24&client_id=[ID]&client_secret=[SECRET]

Application Machine Learning
Endpoint conditions

https://api.aerisapi.com/conditions/:auto?&client_id=[ID]&client_secret=[SECRET]

Application Dynamic Ads
Endpoint conditions

https://api.aerisapi.com/conditions/minneapolis,mn?from=[START DATE]&to=+1day&limit=24&client_id=[ID]&client_secret=[SECRET]

Application Hourly Energy Analytics
Endpoint conditions

https://api.aerisapi.com/conditions/summary/minneapolis,mn?from=[START_DATE]&to=[END_DATE]&client_id=[ID]&client_secret=[SECRET]

Application Historical Growth Analysis
Endpoint conditions/summary

https://api.aerisapi.com/conditions/summary/minneapolis,mn?from=[START_DATE]&client_id=[ID]&client_secret=[SECRET]

Application Historical Analysis
Endpoint conditions/summary

https://api.aerisapi.com/conditions/summary/minneapolis,mn?from=-1day&client_id=[ID]&client_secret=[SECRET]

Application Irrigation - Analytics (Global)
Endpoint conditions/summary

https://api.aerisapi.com/airquality/palm%20springs,ca&client_id=[ID]&client_secret=[SECRET]

Application Current Air Quality
Endpoint airquality

https://api.aerisapi.com/conditions/summary/indianapolis,in&client_id=[ID]&client_secret=[SECRET]

Application Daily Conditions Summary
Endpoint conditions/summary

https://api.aerisapi.com/earthquakes/within?p=25.425587018544316,-163.64201510020976,15.561843881489148,-151.16154749252362&limit=10&client_id=[ID]&client_secret=[SECRET]

Application Earthquake Alerts
Endpoint earthquakes

https://api.aerisapi.com/forecasts/berlin,de?filter=day&limit=15&client_id=[ID]&client_secret=[SECRET]

Application Extended Forecast
Endpoint forecasts

https://api.aerisapi.com/fires/closest?p=darwin,au&client_id=[ID]&client_secret=[SECRET]

Application Fire Alerts
Endpoint fires

https://api.aerisapi.com/forecasts/minneapolis,mn?filter=1hr&limit=168&fields=periods.dateTimeISO,periods.maxTempF,periods.maxTempC,periods.pop,periods.precipIN,periods.precipMM,periods.humidity,periods.sky,periods.solradWM2,periods.dewpointF,periods.dewpointC,periods.windDir,periods.windSpeedMaxMPH,periods.windSpeedMaxKPH,periods.weather&client_id=[ID]&client_secret=[SECRET]

Application In-Field Future Actions
Endpoint forecasts

https://api.aerisapi.com/forecasts/minneapolis,mn?filter=1hr&limit=72&fields=periods.dateTimeISO,periods.maxTempF,periods.maxTempC,periods.pop,periods.precipIN,periods.precipMM,periods.humidity,periods.sky,periods.solradWM2,periods.dewpointF,periods.dewpointC,periods.windDir,periods.windSpeedMaxMPH,periods.windSpeedMaxKPH,periods.windDir80m,periods.windSpeedMax80mMPH,periods.windSpeedMax80mKPH,periods.weather&client_id=[ID]&client_secret=[SECRET]

Application Grid Load / Energy Production
Endpoint forecasts

https://api.aerisapi.com/forecasts/minneapolis,mn?filter=1hr&limit=72&fields=periods.dateTimeISO,periods.maxTempF,periods.maxTempC,periods.pop,periods.precipIN,periods.precipMM,periods.humidity,periods.sky,periods.solradWM2,periods.dewpointF,periods.dewpointC,periods.windDir,periods.windSpeedMaxMPH,periods.windSpeedMaxKPH,periods.weather&client_id=[ID]&client_secret=[SECRET]

Application Irrigation - Forecast
Endpoint forecasts

https://api.aerisapi.com/forecasts/minneapolis,mn?filter=1hr&limit=72&fields=periods.dateTimeISO,periods.maxTempF,periods.maxTempC,periods.pop,periods.precipIN,periods.precipMM,periods.humidity,periods.dewpointF,periods.dewpointC,periods.weather&client_id=[ID]&client_secret=[SECRET]

Application Packaging Recommendations
Endpoint forecasts

https://api.aerisapi.com/conditions/chicago,il?to=+6hr&filter=1hr&client_id=[ID]&client_secret=[SECRET]

Application Hourly Conditions
Endpoint conditions

https://api.aerisapi.com/conditions/7.5344333566393615,-77.52957698454809?to=+3days&client_id=[ID]&client_secret=[SECRET]

Application Hyperlocal 3 Day Forecast
Endpoint conditions

https://api.aerisapi.com/conditions/paca,panama&client_id=[ID]&client_secret=[SECRET]

Application Hyperlocal Conditions
Endpoint conditions

https://api.aerisapi.com/threats/birmingham,al?fields=periods[#].storms.hail,periods[#].storms.tornadic&client_id=[ID]&client_secret=[SECRET]

Application Incoming Hail & Tornadic Threats
Endpoint threats

https://api.aerisapi.com/conditions/seattle,wa?filter=minutelyprecip,1min&client_id=[ID]&client_secret=[SECRET]

Application Minute-by-Minute Forecast
Endpoint conditions

https://api.aerisapi.com/sunmoon/moonphases/berlin,de&client_id=[ID]&client_secret=[SECRET]

Application Moonphases
Endpoint sunmoon/moonphases

https://api.aerisapi.com/lightning/closest?p=hyderabad,in&format=json&radius=25miles&filter=all&limit=10&client_id=[ID]&client_secret=[SECRET]

Application Nearby Lightning Strikes
Endpoint lightning

https://api.aerisapi.com/observations/39.630661,-105.709282?query=temp:!NULL,wind:!NULL,pressure:!NULL,winddir:!NULL&filter=allstations,hasprecip&fields=id,loc,relativeTo.distanceMI,ob.dateTimeISO,ob.weather,ob.tempF,ob.precipIN,ob.windSpeedMPH,ob.windDir,ob.pressureIN,ob.sunriseISO,ob.sunsetISO&client_id=[ID]&client_secret=[SECRET]

Application Current Conditions
Endpoint observations

https://api.aerisapi.com/alerts/denver,co?limit=10&client_id=[ID]&client_secret=[SECRET]

Application Severe Weather Alerts
Endpoint alerts

https://api.aerisapi.com/precip/summary/minneapolis,mn?from=-3days&plimit=4&client_id=[ID]&client_secret=[SECRET]

Application Irrigation - Analytics (US)
Endpoint precip/summary

https://api.aerisapi.com/stormreports/search?query=state:pa,detail:1:2&filter=hail&from=[START_DATE]&limit=100&client_id=[ID]&client_secret=[SECRET]

Application Insurance - Analytics/Verification
Endpoint stormreports

https://api.aerisapi.com/stormcells/wauconda,il?format=geojson&client_id=[ID]&client_secret=[SECRET]

Application Stormcell Point Data
Endpoint stormcells

https://api.aerisapi.com/stormcells/summary?filter=geo&format=geojson&client_id=[ID]&client_secret=[SECRET]

Application Emergency Management
Endpoint stormcells/summary

https://api.aerisapi.com/sunmoon/pierre,sd?from=now&to=+1day&client_id=[ID]&client_secret=[SECRET]

Application Sunrise/Sunset
Endpoint sunmoon

https://api.aerisapi.com/tides/anchorage,ak?from=now&to=+1day&client_id=[ID]&client_secret=[SECRET]

Application Tides (Current + Forecast)
Endpoint tides

https://api.aerisapi.comhttps://api.aerisapi.com/observations/search?query=id:KORD&client_id=[ID]&client_secret=[SECRET]&client_id=[ID]&client_secret=[SECRET]

Application Weather Station Data
Endpoint observations

https://api.aerisapi.com/conditions/summary/minneapolis,mn?from=[START_DATE]&to=[END_DATE]&client_id=[ID]&client_secret=[SECRET]

Application Historical Growth Analysis
Endpoint conditions/summary

https://api.aerisapi.com/forecasts/minneapolis,mn?filter=1hr&limit=168&fields=periods.dateTimeISO,periods.maxTempF,periods.maxTempC,periods.pop,periods.precipIN,periods.precipMM,periods.humidity,periods.sky,periods.solradWM2,periods.dewpointF,periods.dewpointC,periods.windDir,periods.windSpeedMaxMPH,periods.windSpeedMaxKPH,periods.weather&client_id=[ID]&client_secret=[SECRET]

Application In-Field Future Actions
Endpoint forecasts

https://api.aerisapi.com/conditions/:auto?&client_id=[ID]&client_secret=[SECRET]

Application Dynamic Ads
Endpoint conditions

https://api.aerisapi.com/conditions/summary/minneapolis,mn?from=[START_DATE]&client_id=[ID]&client_secret=[SECRET]

Application Historical Analysis
Endpoint conditions/summary

https://api.aerisapi.com/conditions/minneapolis,mn?from=[START DATE]&to=+1day&limit=24&client_id=[ID]&client_secret=[SECRET]

Application Hourly Energy Analytics
Endpoint conditions

https://api.aerisapi.com/forecasts/minneapolis,mn?filter=1hr&limit=72&fields=periods.dateTimeISO,periods.maxTempF,periods.maxTempC,periods.pop,periods.precipIN,periods.precipMM,periods.humidity,periods.sky,periods.solradWM2,periods.dewpointF,periods.dewpointC,periods.windDir,periods.windSpeedMaxMPH,periods.windSpeedMaxKPH,periods.windDir80m,periods.windSpeedMax80mMPH,periods.windSpeedMax80mKPH,periods.weather&client_id=[ID]&client_secret=[SECRET]

Application Grid Load / Energy Production
Endpoint forecasts

https://api.aerisapi.com/tropicalcyclones?p=&filter=all&client_id=[ID]&client_secret=[SECRET]

Application Tropical Cyclone Alerts
Endpoint tropicalcyclones

https://api.aerisapi.com/airquality/forecasts/mexico%city,mx&client_id=[ID]&client_secret=[SECRET]

Application Air Quality Forecast
Endpoint airquality/forecasts

https://api.aerisapi.com/airquality/palm%20springs,ca&client_id=[ID]&client_secret=[SECRET]

Application Current Air Quality
Endpoint airquality

https://api.aerisapi.com/conditions/summary/indianapolis,in&client_id=[ID]&client_secret=[SECRET]

Application Daily Conditions Summary
Endpoint conditions/summary

https://api.aerisapi.com/earthquakes/within?p=25.425587018544316,-163.64201510020976,15.561843881489148,-151.16154749252362&limit=10&client_id=[ID]&client_secret=[SECRET]

Application Earthquake Alerts
Endpoint earthquakes

https://api.aerisapi.com/forecasts/berlin,de?filter=day&limit=15&client_id=[ID]&client_secret=[SECRET]

Application Extended Forecast
Endpoint forecasts

https://api.aerisapi.com/fires/closest?p=darwin,au&client_id=[ID]&client_secret=[SECRET]

Application Fire Alerts
Endpoint fires

https://api.aerisapi.com/conditions/chicago,il?to=+6hr&filter=1hr&client_id=[ID]&client_secret=[SECRET]

Application Hourly Conditions
Endpoint conditions

https://api.aerisapi.com/conditions/7.5344333566393615,-77.52957698454809?to=+3days&client_id=[ID]&client_secret=[SECRET]

Application Hyperlocal 3 Day Forecast
Endpoint conditions

https://api.aerisapi.com/conditions/paca,panama&client_id=[ID]&client_secret=[SECRET]

Application Hyperlocal Conditions
Endpoint conditions

https://api.aerisapi.com/threats/birmingham,al?fields=periods[#].storms.hail,periods[#].storms.tornadic&client_id=[ID]&client_secret=[SECRET]

Application Incoming Hail & Tornadic Threats
Endpoint threats

https://api.aerisapi.com/conditions/seattle,wa?filter=minutelyprecip,1min&client_id=[ID]&client_secret=[SECRET]

Application Minute-by-Minute Forecast
Endpoint conditions

https://api.aerisapi.com/sunmoon/moonphases/berlin,de&client_id=[ID]&client_secret=[SECRET]

Application Moonphases
Endpoint sunmoon/moonphases

https://api.aerisapi.com/lightning/closest?p=hyderabad,in&format=json&radius=25miles&filter=all&limit=10&client_id=[ID]&client_secret=[SECRET]

Application Nearby Lightning Strikes
Endpoint lightning

https://api.aerisapi.com/observations/39.630661,-105.709282?query=temp:!NULL,wind:!NULL,pressure:!NULL,winddir:!NULL&filter=allstations,hasprecip&fields=id,loc,relativeTo.distanceMI,ob.dateTimeISO,ob.weather,ob.tempF,ob.precipIN,ob.windSpeedMPH,ob.windDir,ob.pressureIN,ob.sunriseISO,ob.sunsetISO&client_id=[ID]&client_secret=[SECRET]

Application Current Conditions
Endpoint observations

https://api.aerisapi.com/alerts/denver,co?limit=10&client_id=[ID]&client_secret=[SECRET]

Application Severe Weather Alerts
Endpoint alerts

https://api.aerisapi.com/stormcells/wauconda,il?format=geojson&client_id=[ID]&client_secret=[SECRET]

Application Stormcell Point Data
Endpoint stormcells

https://api.aerisapi.com/sunmoon/pierre,sd?from=now&to=+1day&client_id=[ID]&client_secret=[SECRET]

Application Sunrise/Sunset
Endpoint sunmoon

https://api.aerisapi.com/tides/anchorage,ak?from=now&to=+1day&client_id=[ID]&client_secret=[SECRET]

Application Tides (Current + Forecast)
Endpoint tides

https://api.aerisapi.comhttps://api.aerisapi.com/observations/search?query=id:KORD&client_id=[ID]&client_secret=[SECRET]&client_id=[ID]&client_secret=[SECRET]

Application Weather Station Data
Endpoint observations

https://api.aerisapi.com/airquality/beijing,cn?filter=china&client_id=[ID]&client_secret=[SECRET]

Application Current Air Quality (China Scale)
Endpoint airquality

https://api.aerisapi.com/airquality/closest?p=beijing,cn&limit=10&client_id=[ID]&client_secret=[SECRET]

Application Nearby Air Quality
Endpoint airquality

https://api.aerisapi.com/conditions/summary/minneapolis,mn?from=-1day&client_id=[ID]&client_secret=[SECRET]

Application Irrigation - Analytics (Global)
Endpoint conditions/summary

https://api.aerisapi.com/forecasts/minneapolis,mn?filter=1hr&limit=72&fields=periods.dateTimeISO,periods.maxTempF,periods.maxTempC,periods.pop,periods.precipIN,periods.precipMM,periods.humidity,periods.sky,periods.solradWM2,periods.dewpointF,periods.dewpointC,periods.windDir,periods.windSpeedMaxMPH,periods.windSpeedMaxKPH,periods.weather&client_id=[ID]&client_secret=[SECRET]

Application Irrigation - Forecast
Endpoint forecasts

https://api.aerisapi.com/precip/summary/minneapolis,mn?from=-3days&plimit=4&client_id=[ID]&client_secret=[SECRET]

Application Irrigation - Analytics (US)
Endpoint precip/summary

https://api.aerisapi.com/forecasts/minneapolis,mn?filter=1hr&limit=72&fields=periods.dateTimeISO,periods.maxTempF,periods.maxTempC,periods.pop,periods.precipIN,periods.precipMM,periods.humidity,periods.dewpointF,periods.dewpointC,periods.weather&client_id=[ID]&client_secret=[SECRET]

Application Packaging Recommendations
Endpoint forecasts

Last modified: February 26, 2020