How to start

Best way to start and continue calling OpenWeather APIs

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. To start using our APIs, please sign up here.

Why our Free Weather API is so good yet free

How to call OpenWeather APIs with a freemium plan

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 on your account page, 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.

How to call OpenWeather APIs with a paid plan

In case your weather data requirements go beyond our Free plan, you may consider signing up for our paid subscription plans. The subscription plans differ in the APIs products range, level of service provided, the overall amount of calls per minute and other features.

API key is everything you need to call for weather data

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.

Example on how to make an API call using your API key

API call

Example of API call

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, the only endpoint for making free API calls is api.openweathermap.org. Please, don`t use the server`s IP address. The endpoint for paid subscription plans is different and it can be found in the confirmation email we send you once your subscription is activated

Third, 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.

Finally, 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.

When you exceed the API call limit

We take a count of calls made with all API keys assigned to your account. We are mindful of your end users, so your API key will not be suspended immediately after you reach the API call limit to avoid service interruption and keep your solutions stable. An automatic notification will be sent to your email, suggesting to switch to a paid subscription plan which would meet your requirements. In case we don`t hear back from you, your API key will be suspended. You will still be able to resume your subscription by contacting our customer support team.

Response from API when your account is suspended

{ "cod": 429,
"message": "Your account is temporary blocked due to exceeding of requests limitation of your subscription type. 
Please choose the proper subscription http://openweathermap.org/price"
}