Reference
Common Queries

Common API Queries

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

All
Tropical Cyclone Alerts
https://data.api.xweather.com/tropicalcyclones?p=&filter=all&client_id={client_id}&client_secret={client_secret}
Current Air Quality (China Scale)
Endpoint: /airquality
https://data.api.xweather.com/airquality/beijing,cn?filter=china&client_id={client_id}&client_secret={client_secret}
Nearby Air Quality
Endpoint: /airquality
https://data.api.xweather.com/airquality/closest?p=beijing,cn&limit=10&client_id={client_id}&client_secret={client_secret}
Air Health Forecast
https://data.api.xweather.com/airquality/forecasts/dallas,texas?&from={start_date}&client_id={client_id}&client_secret={client_secret}
Air Quality Forecast
https://data.api.xweather.com/airquality/forecasts/mexico%city,mx&client_id={client_id}&client_secret={client_secret}
Machine Learning
Endpoint: /conditions
https://data.api.xweather.com/conditions/31.43799,121.186?&from={start_date}&to=+1day&limit=24&client_id={client_id}&client_secret={client_secret}
Hourly Energy Analytics
Endpoint: /conditions
https://data.api.xweather.com/conditions/minneapolis,mn?from={start_date}&to=+1day&limit=24&client_id={client_id}&client_secret={client_secret}
Historical Growth Analysis
https://data.api.xweather.com/conditions/summary/minneapolis,mn?from={start_date}&to={end_date}&client_id={client_id}&client_secret={client_secret}
Historical Analysis
https://data.api.xweather.com/conditions/summary/minneapolis,mn?from={start_date}&client_id={client_id}&client_secret={client_secret}
Irrigation - Analytics (Global)
https://data.api.xweather.com/conditions/summary/minneapolis,mn?from=-1day&client_id={client_id}&client_secret={client_secret}
Current Air Quality
Endpoint: /airquality
https://data.api.xweather.com/airquality/palm%20springs,ca&client_id={client_id}&client_secret={client_secret}
Daily Conditions Summary
https://data.api.xweather.com/conditions/summary/indianapolis,in&client_id={client_id}&client_secret={client_secret}
Earthquake Alerts
Endpoint: /earthquakes
https://data.api.xweather.com/earthquakes/within?p=25.425587018544316,-163.64201510020976,15.561843881489148,-151.16154749252362&limit=10&client_id={client_id}&client_secret={client_secret}
Extended Forecast
Endpoint: /forecasts
https://data.api.xweather.com/forecasts/berlin,de?filter=day&limit=15&client_id={client_id}&client_secret={client_secret}
Fire Alerts
Endpoint: /fires
https://data.api.xweather.com/fires/closest?p=darwin,au&client_id={client_id}&client_secret={client_secret}
In-Field Future Actions
Endpoint: /forecasts
https://data.api.xweather.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={client_id}&client_secret={client_secret}
Grid Load / Energy Production
Endpoint: /forecasts
https://data.api.xweather.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={client_id}&client_secret={client_secret}
Irrigation - Forecast
Endpoint: /forecasts
https://data.api.xweather.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={client_id}&client_secret={client_secret}
Packaging Recommendations
Endpoint: /forecasts
https://data.api.xweather.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={client_id}&client_secret={client_secret}
Hourly Conditions
Endpoint: /conditions
https://data.api.xweather.com/conditions/chicago,il?to=+6hr&filter=1hr&client_id={client_id}&client_secret={client_secret}
Hyperlocal 3 Day Forecast
Endpoint: /conditions
https://data.api.xweather.com/conditions/7.5344333566393615,-77.52957698454809?to=+3days&client_id={client_id}&client_secret={client_secret}
Hyperlocal Conditions
Endpoint: /conditions
https://data.api.xweather.com/conditions/paca,panama&client_id={client_id}&client_secret={client_secret}
Incoming Hail & Tornadic Threats
Endpoint: /threats
https://data.api.xweather.com/threats/birmingham,al?fields=periods[#].storms.hail,periods[#].storms.tornadic&client_id={client_id}&client_secret={client_secret}
Minute-by-Minute Forecast
Endpoint: /conditions
https://data.api.xweather.com/conditions/seattle,wa?filter=minutelyprecip,1min&client_id={client_id}&client_secret={client_secret}
Moonphases
https://data.api.xweather.com/sunmoon/moonphases/berlin,de&client_id={client_id}&client_secret={client_secret}
Nearby Lightning Strikes
Endpoint: /lightning
https://data.api.xweather.com/lightning/closest?p=hyderabad,in&format=json&radius=25miles&filter=all&limit=10&client_id={client_id}&client_secret={client_secret}
Current Conditions
Endpoint: /observations
https://data.api.xweather.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={client_id}&client_secret={client_secret}
Severe Weather Alerts
Endpoint: /alerts
https://data.api.xweather.com/alerts/denver,co?limit=10&client_id={client_id}&client_secret={client_secret}
Insurance - Analytics/Verification
Endpoint: /stormreports
https://data.api.xweather.com/stormreports/search?query=state:pa,detail:1:2&filter=hail&from={start_date}&limit=100&client_id={client_id}&client_secret={client_secret}
Stormcell Point Data
Endpoint: /stormcells
https://data.api.xweather.com/stormcells/wauconda,il?format=geojson&client_id={client_id}&client_secret={client_secret}
Emergency Management
https://data.api.xweather.com/stormcells/summary?filter=geo&format=geojson&client_id={client_id}&client_secret={client_secret}
Sunrise/Sunset
Endpoint: /sunmoon
https://data.api.xweather.com/sunmoon/pierre,sd?from=now&to=+1day&client_id={client_id}&client_secret={client_secret}
Tides (Current + Forecast)
Endpoint: /tides
https://data.api.xweather.com/tides/anchorage,ak?from=now&to=+1day&client_id={client_id}&client_secret={client_secret}
Weather Station Data
Endpoint: /observations
https://data.api.xweather.comhttps://data.api.xweather.com/observations/search?query=id:KORD&client_id={client_id}&client_secret={client_secret}&client_id={client_id}&client_secret={client_secret}
Historical Growth Analysis
https://data.api.xweather.com/conditions/summary/minneapolis,mn?from={start_date}&to={end_date}&client_id={client_id}&client_secret={client_secret}
In-Field Future Actions
Endpoint: /forecasts
https://data.api.xweather.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={client_id}&client_secret={client_secret}
Historical Analysis
https://data.api.xweather.com/conditions/summary/minneapolis,mn?from={start_date}&client_id={client_id}&client_secret={client_secret}
Hourly Energy Analytics
Endpoint: /conditions
https://data.api.xweather.com/conditions/minneapolis,mn?from={start_date}&to=+1day&limit=24&client_id={client_id}&client_secret={client_secret}
Grid Load / Energy Production
Endpoint: /forecasts
https://data.api.xweather.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={client_id}&client_secret={client_secret}
Tropical Cyclone Alerts
https://data.api.xweather.com/tropicalcyclones?p=&filter=all&client_id={client_id}&client_secret={client_secret}
Air Quality Forecast
https://data.api.xweather.com/airquality/forecasts/mexico%city,mx&client_id={client_id}&client_secret={client_secret}
Current Air Quality
Endpoint: /airquality
https://data.api.xweather.com/airquality/palm%20springs,ca&client_id={client_id}&client_secret={client_secret}
Daily Conditions Summary
https://data.api.xweather.com/conditions/summary/indianapolis,in&client_id={client_id}&client_secret={client_secret}
Earthquake Alerts
Endpoint: /earthquakes
https://data.api.xweather.com/earthquakes/within?p=25.425587018544316,-163.64201510020976,15.561843881489148,-151.16154749252362&limit=10&client_id={client_id}&client_secret={client_secret}
Extended Forecast
Endpoint: /forecasts
https://data.api.xweather.com/forecasts/berlin,de?filter=day&limit=15&client_id={client_id}&client_secret={client_secret}
Fire Alerts
Endpoint: /fires
https://data.api.xweather.com/fires/closest?p=darwin,au&client_id={client_id}&client_secret={client_secret}
Hourly Conditions
Endpoint: /conditions
https://data.api.xweather.com/conditions/chicago,il?to=+6hr&filter=1hr&client_id={client_id}&client_secret={client_secret}
Hyperlocal 3 Day Forecast
Endpoint: /conditions
https://data.api.xweather.com/conditions/7.5344333566393615,-77.52957698454809?to=+3days&client_id={client_id}&client_secret={client_secret}
Hyperlocal Conditions
Endpoint: /conditions
https://data.api.xweather.com/conditions/paca,panama&client_id={client_id}&client_secret={client_secret}
Incoming Hail & Tornadic Threats
Endpoint: /threats
https://data.api.xweather.com/threats/birmingham,al?fields=periods[#].storms.hail,periods[#].storms.tornadic&client_id={client_id}&client_secret={client_secret}
Minute-by-Minute Forecast
Endpoint: /conditions
https://data.api.xweather.com/conditions/seattle,wa?filter=minutelyprecip,1min&client_id={client_id}&client_secret={client_secret}
Moonphases
https://data.api.xweather.com/sunmoon/moonphases/berlin,de&client_id={client_id}&client_secret={client_secret}
Nearby Lightning Strikes
Endpoint: /lightning
https://data.api.xweather.com/lightning/closest?p=hyderabad,in&format=json&radius=25miles&filter=all&limit=10&client_id={client_id}&client_secret={client_secret}
Current Conditions
Endpoint: /observations
https://data.api.xweather.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={client_id}&client_secret={client_secret}
Severe Weather Alerts
Endpoint: /alerts
https://data.api.xweather.com/alerts/denver,co?limit=10&client_id={client_id}&client_secret={client_secret}
Stormcell Point Data
Endpoint: /stormcells
https://data.api.xweather.com/stormcells/wauconda,il?format=geojson&client_id={client_id}&client_secret={client_secret}
Sunrise/Sunset
Endpoint: /sunmoon
https://data.api.xweather.com/sunmoon/pierre,sd?from=now&to=+1day&client_id={client_id}&client_secret={client_secret}
Tides (Current + Forecast)
Endpoint: /tides
https://data.api.xweather.com/tides/anchorage,ak?from=now&to=+1day&client_id={client_id}&client_secret={client_secret}
Weather Station Data
Endpoint: /observations
https://data.api.xweather.comhttps://data.api.xweather.com/observations/search?query=id:KORD&client_id={client_id}&client_secret={client_secret}&client_id={client_id}&client_secret={client_secret}
Current Air Quality (China Scale)
Endpoint: /airquality
https://data.api.xweather.com/airquality/beijing,cn?filter=china&client_id={client_id}&client_secret={client_secret}
Nearby Air Quality
Endpoint: /airquality
https://data.api.xweather.com/airquality/closest?p=beijing,cn&limit=10&client_id={client_id}&client_secret={client_secret}
Irrigation - Analytics (Global)
https://data.api.xweather.com/conditions/summary/minneapolis,mn?from=-1day&client_id={client_id}&client_secret={client_secret}
Irrigation - Forecast
Endpoint: /forecasts
https://data.api.xweather.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={client_id}&client_secret={client_secret}
Packaging Recommendations
Endpoint: /forecasts
https://data.api.xweather.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={client_id}&client_secret={client_secret}