June 3

New Global Weather Conditions Endpoint

What is the current weather outside? What’s the weather in Minneapolis? What’s the current temperature in northern Alaska? Requests for current weather conditions are a significant portion of the total requests we receive. With this in mind, we are constantly improving and expanding our observations network. So today, we are announcing the public release of our new conditions endpoint.

What is the Weather Conditions Endpoint?

The new weather conditions endpoint provides a single method to obtain weather conditions for any location globally. This endpoint includes information for the location and time requested using a blend of nearby weather observations, radar and satellite data, global and regional models, near-time analysis, and other proprietary sources. The conditions endpoint can provide the estimated weather conditions at a specific point in time (i.e., Earlier this morning at 1:23 am). Furthermore, the conditions endpoint can provide hourly conditions across a time range.

Currently, the public beta provides weather conditions for the current time and from the past 24 hours. In the coming weeks, support for historical weather conditions across our entire observation data archive will be available.

Conditions vs. Observations

Before the conditions endpoint, the observations endpoint has been the solution for displaying the latest weather conditions. The observations endpoint provides access to actual weather conditions observed at thousands of observation stations across the globe. Therefore, the observations endpoint is incredibly accurate, especially for requests near the weather observations’ time and location.

Challenges can arise if there are too few or no nearby observation stations or if the station updates infrequently. Additionally, station elevation is often a hurdle in mountainous regions as the closest observation stations may be a significantly different elevation.

The conditions endpoint solves these challenges of solely using nearby weather observation. The combination of using actual weather observations with radar and satellite information, models, near-real-time analysis, and other sources allows the endpoint to provide accurate weather conditions for any global location and timeframe.

How to Use the Conditions Endpoint

The conditions endpoint supports a variety of integration methods with the specifics depending on your needs. The conditions documentation provides information on the various query methods and an example of the output and associated properties.

Fetching the Latest Conditions

The most common request is to obtain the latest conditions or the conditions for right now. For this request, pass the location in the URL. The request location can be a “city, state” combination, latitude/longitude combination, or any of the API supported places.

Current conditions for Minneapolis, MN:


Current conditions for Minneapolis, MN via latitude and longitude:


Current conditions for Paris, France:


Conditions for a Point in Time

Along with the latest conditions, it also supports requesting the weather conditions for a specific point in time. The point in time is specified using the


 parameter and can be Unix timestamp, a date/time string, or a relative date format.
Conditions for two hours ago:


Conditions for 1:23 am this morning:

/conditions/minneapolis,mn?from=today 1:23am

Conditions for June 1, 2020 as 1:45pm:

/conditions/minneapolis,mn?from=2020-06-01 13:45:00

As of this initial public release, the conditions endpoint supports point in time conditions over the past 24 hours. In the coming weeks, support for requesting date/times across our entire historical archive will be available.

Hourly Conditions

The conditions endpoint also allows querying for up to 24 hours of hourly weather conditions, snapped to the top of each hour. For hourly weather conditions, set the from parameter to the start time and the to parameter to the end time. The API will return the weather conditions for the of the hour defined by the





Weather conditions for the past 4 hours:


Weather conditions for the last 24 hours:


Weather conditions from midnight through 6 am this morning:

/conditions/Minneapolis,mn?from=today midnight&to=+6hours

Notice that in the above examples, there is no


 parameter. The API calculates the total periods based on the


 parameters. The


 parameter is available for use if needed.

Start Using the Conditions Endpoint Today!

As we described in this post, the new conditions endpoint provides unique advantages over the observations endpoint, providing full global support. As of today, the conditions endpoint is available to AerisWeather API Premium users and the free developer trial.

Check out the new conditions API and tell us how you’re using it!

Share this post:

Leave a Reply

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.