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.

It takes up to 1 hour to activate your API key. We send you a confirmation email as your API key is ready to work.

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

Send requests from one API key no often than 1 per 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 data 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"
}