API Documentation
Leverage our powerful API to do amazing things!
With our API you can retrieve current weather observations from over 50,000 live weather stations, and historical weather data for the past 20+ years sourced from stations, doppler radar, satellite, and atmospheric re-analysis products. As well as highly localized weather forecasts for any point on the globe backed by the world's most trusted weather models, and machine learning.
You can look up weather data by many methods including:
- Latitude/longitude
- City name
- City ID
- Weather station ID
- Airport ICAO code
- Postal (zip) code for any country in the world
How do I get access?
- Sign up for an account.
- Use the API key provided in the account dashboard.
- Upgrade or downgrade your key anytime by signing in, and selecting your plan via the dashboard.
- See pricing for subscription options.
Current Weather
Current Weather
- Current weather observations for any location worldwide.
- Weather data updates every 5-30 minutes based on reporting frequency.
- Data sources include METAR reporting stations, station data from the NOAA Meteorological Assimilation Data Ingest System (MADIS), weather radar, satellite, and the NOAA Real-Time Mesoscale Analysis (RTMA) (CONUS).
Severe Weather Alerts
- Severe weather alerts from local meteorological agencies.
- Returns alerts for the US, Canada, EU member nations, and Isreal.
Current Air Quality
- Current Air quality observations for any point in the world
- Returns current information on the six major pollutants - PM 2.5, PM 10, CO, SO2, NO2, and O3 - as well as an US EPA Air Quality Index (AQI) score
- Also returns pollen levels (Trees/Weeds/Grasses/Molds) for the USA, and EU.
Current Lightning API
- Live lightning data available globally.
- Sourced from geostationary satellites, and weather radar.
- Retrieve nearest, and most recent lightning data from a given point.
Weather Maps [BETA]
- Live global weather maps.
- Available maps: precipitation/snowfall, cloud cover, and temperature.
- Compatible with tile serving clients such as Leaflet, OpenLayers, and Mapbox.
Historical Weather
Historical Weather (Daily)
- Daily historical weather data for any location in the world.
- Backfilled, and gap-free* historical data.
- Sourced from weather stations, radar, and re-analyses.
- Over 25 weather fields returned, including: min/max temperature, precipitation, snowfall/snow depth, UV index, solar irradiance, and wind speed.
Historical Weather (Hourly)
- Hourly historical weather data for any location in the world.
- Backfilled, and gap-free* historical data.
- Sourced from weather stations, radar, and re-analyses.
- Over 20 weather fields returned, including: temperature, precipitation, estimated snowfall, UV index, solar irradiance, weather conditions, and wind speed.
Historical Weather (Sub-Hourly)
- Sub hourly (15 minute interval) historical weather data for any location in the world.
- Backfilled, and gap-free* historical data.
- Sourced from weather stations, radar, and re-analyses.
- Over 20 weather fields returned, including: temperature, precipitation, estimated snowfall, UV index, weather conditions, and wind speed.
Climate Normals (1991-2020)
- Hourly / Daily / Monthly Climate Normals for any point in the world
- 30 year climate normals (averages) for any point in the world, at a spatial resolution of 9 kilometers. This API sources data from the "state of the art" 9 KM ERA-5 re-analysis
- 6 weather fields returned, including: temperature, precipitation, snowfall, dew point, wind speed, and wind direction
Historical Air Quality API
- Hourly historical air quality observations for any point in the world.
- Returns current information on the six major pollutants - PM 2.5, PM 10, CO, SO2, NO2, and O3
- Also returns an Air Quality Index (AQI) score
Historical Ag-Weather
- Hourly & daily historical weather data relevent to the Agriculture sector
- Historical data sourced from the GLDAS and ERA5 dataset, along with state of the art, satellite based precipitation measurements
- Over 30 weather fields returned, including: soil temperature, precipitation, soil moisture, evapotranspiration, solar radiation, and more!
Cooling + Heating Degree Day History [Energy API]
- Historical weather data for any point in the world relevent to energy sectors
- Sourced from weather stations, radar, and re-analyses.
- Returns many energy sector specific fields such as cooling degree days, heating degree days, wind speed, humidity, and precipitation
Weather Forecasts
Weather Forecasts (16 day / daily)
- 16 day / daily forecasts for any location in the world
- Forecast data from the world's most accurate weather models including the GFS, ECMWF, DWD ICON, NOAA HRRR, JMA, ACCESS, and other regional models
- Over 22 weather fields returned, including: temperature, precipitation, snowfall/snow depth, solar irradiance, UV index, and weather conditions
Weather Forecasts (240 hour / hourly)
- Up to 240 hour / hourly (10 days / hourly) forecasts for any location in the world
- Forecast data from the world's most accurate weather models including the GFS, ECMWF, DWD ICON, NOAA HRRR, JMA, ACCESS, and other regional models
- Over 22 weather fields returned, including: temperature, precipitation, snowfall/snow depth, solar irradiance, UV index, and weather conditions
Precipitation Forecasts (1 hour / minutely)
- An accurate 1 hour (60 minute) precipitation forecast for any point on the planet using both radar, and weather model data.
- Returns 1 minute interval forecasts for the following weather fields: precipitation rate, and snowfall rate.
Cooling + Heating Degree Day Forecast API [Energy API]
- Get an 8 day daily, or hourly forecast for any point in the world relevent to energy sectors
- Returns both heating, and cooling degree days using hourly weather data
- Returns many energy specific fields such as clear sky global horizontal irradiance (GHI), direct normal irradiance (DNI), and diffuse horizontal irradiance (DHI)
Air Quality Forecast API
- 3 day / 1-hour interval air quality forecasts for any location in the world
- Forecast data from the world's most accurate air quality models
- Returns forecasts for the six major pollutants - PM 2.5, PM 10, CO, SO2, NO2, and O3
Ag-Weather Forecast API
- Get an 8 day forecast for any point in the world relevent to the Agriculture industry
- Over 30 weather fields returned, including: soil temperature, precipitation, soil moisture, evapotranspiration, solar radiation, and more!
= Business subscription required
* Guaranteed 99.95% historical data availability for primary weather fields: Temperature, Wind Speed, Relative Humidity, Dew Point, Cloud Cover, Solar Radiation, Precipitation, and Snowfall.