By on July 20, 2015

12 weeks weather forecasts with Weather2020 API

Ah, weather apps.  Often imitated, often duplicated.  There are literally hundreds of weather apps out there pulling the same weather data and they’re all basically the same… right?  What if you could make an app about weather that wasn’t a weather app though?  Travel, lifestyle, sports, bridal and many other types of apps using weather, that would be pretty cool right?  Well that’s what we’re doing.

Sure, weather apps are great and can definitely benefit from our forecasts.  In fact one of the most popular weather apps on the market, 1Weather, recently started including our long range forecasts.  But for the first time ever, developers don’t have to be stuck with the same 5-7 day forecast, instead we provide 12 weeks of forecasts and this opens up so many new and exciting possibilities that we can’t possibly know all of the things that you crazy creative developers will come up with.

For the past 8 years, Weather2020 has been providing long range forecasts to various industries such as insurance, energy, agriculture and even ski resorts.  Using the Lezak Recurring Cycle (LRC), a proprietary forecast methodology developed by famed meteorologist Gary Lezak, Weather2020 has been able to package it up and deliver it to you through an API.  With an accuracy of near 75% more than 90 days out, the LRC is not only the most accurate long range weather method, but it consistently beats those 7 day computer models.

So what does our API provide? Well, as I stated above, 12 weeks of weather forecasts.  However it may be a little different than you expect.  As general walkers of the Earth, weather enthusiasts, and/or potentially avid consumers of API data, it may be hard to shake the expectation that all forecasting should be purely numerical pieces of data meant to tell you the exact measurement of temperature and precipitation for a single moment in time.  Our forecasts aren’t meant to tell you that it will rain precisely one half inch with the wind blowing at 9 mph on Thursday at 9:34AM at a specific street crossing in Detroit.  Now this doesn’t necessary preclude the possibility of getting somewhat specific in week’s forecast description.  But that just shouldn’t be your consistent expectation with this API data.  It’s meant more as a broad overview of what’s coming to give you an advantage in whatever decision making processes in which you may be involved. Similar to what an actual meteorologist would tell you, imagine that!

Now that that annoying little bit of philosophy is out of the way, here is what you really get.  When a successful API call is made, a JSON formatted array of weekly forecast objects is returned.  Each of those forecast objects contain the data listed below.
Screen Shot 2015-07-17 at 2.31.21 PM

In more general terms, you get weekly forecasts for the next 12 weeks.  These weekly forecasts contain a subject line, a meteorologically written forecast, weather conditions and high and low temperatures.

We understand that people get their location data from various sources and often need very specific areas so to help we provide 3 convenient methods to retrieve our forecasts; Latitude & Longitude, Zip Code, or City & State. Now let’s run an example,

Using /YourAPIKey/{zip} you will get back something like this:


“regionAffected”: “Central Plains”,

“headline”: “Dry & Hot Most Of This Week”,

“forecastDesc”: “Excessive Heat Warning to start the week. Some dangerous heat will build in early in the week with high humidity.  If you have vacation or wedding plans this week in this area the weather pattern is setting up for a calmer and drier week.  Weather 2020 uses the LRC, the cycling pattern, to make these accurate forecasts, and this week there will likely be a strong cold front approaching by the weekend.  If you are in Omaha, Des Moines, St. Louis, Kansas City, Springfield, Branson, Topeka, Wichita, and Dodge City, there will be a good chance of thunderstorms with this front with the rest of the week staying hot and mostly dry.  If you are out on the lake this week, keep an eye to the sky. There will likely be a  few isolated thunderstorms with a slight chance of a microburst wind near these thunderstorms.”,

“startDate”: 1436659200,

“revision”: 6,

“events”: [],

“conditions”: [


“tag”: “thunderstorm”,

“display”: “Thunderstorm”



“forecastLengthInHours”: 168,

“temperatureHigh”: 93,

“temperatureLow”: 74,

“temperatureHighCelcius”: 34,

“temperatureLowCelcius”: 23


Again, you won’t need to display all, or any, of this information if you choose but its there if you need it.  I’ll also point out that this example only shows one week. You’ll get actually get 12 of these with every API call.

By now I’m sure your minds are swirling with thoughts of mashing up food delivery, our forecasts, and a pirate translator to let people order “ye landlubber grub” weeks in advance but there are plenty of use cases big and small that can take advantage without even showing our forecasts.  Perhaps the first that comes to mind for most of you would be the travel industry. For people planning a business trip or family vacation, being able to properly plan ahead and not get stuck at JFK airport watching 12 inches of snow pile up outside the window is pretty useful information.  By looking at the conditions we provide in our forecasts you can automatically flag and warn these travelers that “Hey, maybe you should pick another day.”

This breakthrough technology is real, accurate and now available to you and your customers.  Get the Weather2020 12 Week Forecast API right here on Mashape for free.  If you have something using our forecasts already let us know, we’d love to mention it on our own popular weather blog!

Fair winds, Cap’n!

Share Post