How to start

It is quite easy to work with Openweather API. Just sign up to get your API key and then call any weather API. And mind using API key in every API call whatever account you choose from Free to Enterprise.

How to start in 3 simple steps

Sign up and get an API key (APPID) on your account page.

After registration, we will send you a welcome email that contain your API key and additional information on how to get started with our weather APIs. Within the next couple of hours, it will be activated and ready to use.

Start using API for free.

Find the complete description of API calls with a list of parameters and examples of responses in API documentation.

Please, use API key in each API call.

If you need more features than Free account can give you, look at the options of our monthly subscriptions here.

Choose your subscription depending on a number of calls per sec, API availability, service provided, and other features.

Contact us via Support Center.


Example of using API key in API call

Description:

Please, use your API key in each API call.

We do not process API requests without the API key.

API call:
http://api.openweathermap.org/data/2.5/forecast?id=524901&APPID={APIKEY}
Parameters:
APPID {APIKEY} is your unique API key
Example of API call:
api.openweathermap.org/data/2.5/forecast?id=524901&APPID=1111111111

Tips on how to use API effectively

We recommend making calls to the API no more than one time every 10 minutes for one location (city / coordinates / zip-code). This is due to the fact that weather data in our system is updated no more than one time every 10 minutes.

The server name is api.openweathermap.org. Please, never use the IP address of the server.

Better call API by city ID instead of a city name, city coordinates or zip code to get a precise result. The list of cities' IDs is here.

Please, mind that Free and Startup accounts have limited service availability. If you do not receive a response from the API, please, wait at least for 10 min and then repeat your request. We also recommend you to store your previous request.

What happens when your account exceeds a limit of calls

We accumulate the total number of calls from all the API keys that belong to your account.

When your account exceeds the limit, we do not block your account immediately but send you an automatic notification by email asking you to switch to one of our paid subscriptions within the reasonable term. If we do not get any feedback from you, we suspend your account. To renew your account, contact us info@openweathermap.org .

Response from API about blocking
{
"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"
}