Windy API v4

Windy API v4, also known as as Windy Leaflet Plugin, is simple to use javascript API based on Leaflet and technology, that powers Windy.com.

Windy API uses Leaflet version 0.7.7.

Previous versions of Windy API

Windy API v2.3 will be discontinued as of 31.11.2018
Console for depreciated Windy API v3 can be found here

Getting started

Obtain your Windy API key here and check out our tutorials. You will handle our API in less than 20 minutes!

Things to remember

Windy API is not compatible with higher versions of Leaflet and we have no intention to upgrade so far.
While providing coordinates to Leaflet can be done via object { lat, lng } with lng property, Windy supports { lat, lon } with lon property.
There can be only one instance of Windy Map on a page, but you can use multiple instances of Leaflet map on the same page.
All classes of leaflet.css are nested inside #windy selector (not to interfere with your own CSS), so if you want to use another instance of Leaflet map on the same page load leaflet.css yourself once more.
Windy uses a lot of global defined CSS classes, and id selectors, with nice names like #bottom, #logo etc. Windy also puts a lot of CSS classes to body tag dynamically. If design of Windy Map is broken, check your CSS and rename your id and selectors please.
Windy API v4 does not use cookies
Windy API v4 heavily uses localStorage. Unintentional or intentional modifications of our items can lead to instability of Windy API.
Using undocumented functions of Windy engine can break your app, when we decide to upgrade our codes. If you miss something, rather let us know here and ask us to document and expose other features.

Please bear in mind that we pay for ecmwf forecasting data. Therefore Windy API is free, with unrestricted traffic usage, but offers only gfs forecast model. Windy logo MUST remain clickable on the map without rescaling down, or messing with logo's opacity. However you are free to move logo wherever you want inside Windy map. For free version of API we reserve the right to 1) display advertisement inside the Windy map, 2) Place "Download Windy App" message time to time on mobile device, or 3) discontinue free version of Windy API v4 at any time without prior notice.

Paid version

For serious work we recommend to use paid version, that contains ecmwf, iconEu, nam and gfs models and will not contain ads. It costs only 720USD per year (ordered via this form and paid annually via invoice). Dvelopers of paid version can decrease opacity of Windy logo to 0.8 (however logo must remain clickable) and usage limit is average of 5.000 Unique Visitors a day (measured by Google Analytics). Contact us for quote for higher amounts.