Documentation

OpenWeather offers a set of widely recognised and reliable APIs. Powered by advanced machine learning, our platform provides weather information essential for decision-making at any location worldwide. To start using our APIs, please sign up here.

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. API call limits are applied at the account level, not per API key or per product. Usage from all API keys and subscribed products is combined and counted toward the same account limits. 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.

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.

Please, use your API key in every API call you make. Our platform only processes the API requests with an API key included. API usage is accumulated across all API keys associated with your account and across all subscribed products.

Like any other tool, 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. Subscription plans provide different account-level daily and per-minute API call limits. These limits apply to the total usage of your account, regardless of which API key or subscribed product is used. 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.

We take a count of calls made with all API keys assigned to your account. To avoid service interruptions for your users, we won’t immediately suspend your API key if you exceed the call limit. 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.

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

OpenWeather provides support for our own products and API services, including API key activation, account-related questions, subscription issues, and access to OpenWeather API endpoints.

However, we do not provide technical support for using an OpenWeather API key inside third-party applications, such as Google Calendar, Garmin apps, watch faces, Home Assistant integrations, or similar external platforms.

Although some third-party applications may use OpenWeather data, they are developed, maintained, and configured by their respective owners. We do not have access to their codebase, settings, integration logic, or technical documentation. For this reason, we cannot troubleshoot issues related to how an API key is used inside those applications.

If you experience a problem with a third-party application, please get in touch with the application’s support team or developer directly. They are responsible for the integration and can provide the most accurate guidance for setup, configuration, and troubleshooting.