How to start

OpenWeather platform is a set of elegant and widely recognisable APIs. Powered by convolutional machine learning solutions, it is capable of delivering all the weather information necessary for decision-making for any location on the globe.

Where should I start

The API key is all you need to call any of our weather APIs.

Once you sign up using your email, the API key (APPID) will be sent to you in a confirmation email. Your API keys can always be found in your Personal account, where you can also generate additional API keys if needed.

Check our documentation page to find all technical information for each product. Documentation is an essential guide with actual examples and comprehensive description of API calls, responses and parameters.

Example on how to make an API call

API call

Parameters
appid required Your unique API key (you can always find it in your Personal account under the "API key" tab)

Please use your API key in every API call you make. Our platform only processes the API requests with an API key included. The API keys linked to your account are used to take count of the calls you make to OpenWeather platform.

API care recommendations

Like any other things you are using, the API requires some attention. To let it serve you properly, we suggest that you carefully read these instructions and care recommendations.

First, we recommend making API calls no more than once in 10 minutes for each location, whether you call it by city name, geographical coordinates or by zip code. The update frequency of the OpenWeather model is not higher than once in 10 minutes.

Second, to get a precise geocoding searching result would rather call API by geographical coordinates. You can always call the OpenWeather APIs using the city name or zip/post code. In case you need to get geographical coordinates by name of your location please use our Geocoding API.

Third, please mind that all our tariff plans have caps on the quantity of calls made to API and it varies depending on the subscription type. In case you don’t obtain an API response due to hitting the limit of calls, we would ask you to repeat your request in 10 minutes. On this occasion, we also recommend to keep the API request unamended, since it would help our internal caching service to process your request timely.


If you do not find a reply to your questions on this page, please look at our Useful links section or contact our customer support team.