Bulk Download
The service allows you to regularly download current, forecast and historical weather data in JSON format. There is no need to call an API to do this.
About
Current, forecast and historical weather data is available via regulary updated JSON files. In order to receive this data, you will need to download an archive via provided link. Each archive will contain selected weather data for all available locations.
There is a possibility to create a custom regularly updated current, forecast and historical bulks. Please contact us to learn more about it.
Please note, that this option is available for Professional and Enterprise subscription plans.
How to use the service
-
Use links of the following types in order to access bulks files:
To get Current and Forecast bulks files:
https://bulk.openweathermap.org/snapshot/{BULK_FILE_NAME}?appid={API key}
To get access to 7-days archive of current and forecasts bulk files.
https://bulk.openweathermap.org/archive/{BULK_FILE_NAME}?appid={API key}
Parameters {BULK_FILE_NAME}
required Specified in the "File name" table column in the "Types of bulk files" section appid
required Your unique API key (you can always find it on your account page under the "API key" tab) -
Unpack the downloaded file by using any suitable archiver software. After this is done, you will have a JSON format file that is ready to use. The file implies line-by-line processing.
Examples of bulk files can be found here: bulk examples.
-
To download updated weather data, please also use the same link. Data in the files get updated in accordance with the schedule found in the "Updated" column of the downloaded file.
Please note that weather data in the fill is rewritten regularly.
Types of bulk files
There are 2 types of bulk files: Forecasts bulks and Current bulk. We also provide 7-days archive weather bulks.
Please note that scheduled update times are specified in UTC.
Current weather bulks
You can find the following files in the list of bulk examples:
File name | Data | Number of cities | Updated, UTC time |
---|---|---|---|
weather_14.json.gz | current weather | 22,635 | 1 time/hour (00:10, 01:10, 02:10,...) |
weather_16.json.gz | current weather | 209,579 | 1 time/hour (00:20, 01:20, 02:20,...) |
If you are interested in to get Current bulk files for 7 previous days, please read "7-day archives of bulk files" section.
Examples of Current bulk files
Forecast bulks
You can find the following files in the list of bulk examples:
File name | Data | Number of cities | Updated, UTC time |
---|---|---|---|
hourly1h_14.json.gz | 4 days/hourly forecast | 22,635 | 4 times/day (03:00, 09:00, 15:00, 21:00) |
hourly1h_16.json.gz | 4 days/hourly forecast | 209,579 | 4 times/day (03:00, 09:00, 15:00, 21:00) |
daily_14.json.gz | 16 days/daily forecast | 22,635 | 2 times/day (07:00, 19:00) |
daily_16.json.gz | 16 days/daily forecast | 209,579 | 2 times/day (07:00, 19:00) |
hourly_14.json.gz | 5 days/3 hour forecast | 22,635 | 1 time/hour (00:10, 01:10, 02:10,...) |
hourly_16.json.gz | 5 days/3 hour forecast | 209,579 | 2 times/day (07:00, 19:00) |
If you are interested in to get Forecasts bulk files for 7 previous days, please read "7-day archives of bulk files" section.
Examples of Forecast bulk files
7-day archives of bulk files
You can get all weather bulks files for the 7 previous days. The structure of data the same as for current and forecasts bulks files.
File name | Data | Number of cities | Available data per day, UTC time |
---|---|---|---|
weather_14_mmddyy_hhmm.json.gz
Example of file name: weather_14_011020_0200.json.gz |
current weather | 22,635 | 01:00, 02:00, 03:00, 04:00, 05:00, 06:00, 07:00, 08:00, 09:00, 10:00, 11:00, 12:00, 13:00, 14:00, 15:00, 16:00, 17:00, 18:00, 19:00, 20:00, 21:00, 22:00, 23:00, 00:00 |
weather_16_mmddyy_hhmm.json.gz
Example of file name: weather_16_011020_0200.json.gz |
current weather | 209,579 | 01:00, 02:00, 03:00, 04:00, 05:00, 06:00, 07:00, 08:00, 09:00, 10:00, 11:00, 12:00, 13:00, 14:00, 15:00, 16:00, 17:00, 18:00, 19:00, 20:00, 21:00, 22:00, 23:00, 00:00 |
hourly1h_14_mmddyy_hhmm.json.gz
Example of file name: hourly1h_14_011020_2000.json.gz |
4 days/hourly forecast | 22,635 | 02:00, 08:00, 14:00, 20:00 |
hourly1h_16_mmddyy_hhmm.json.gz
Example of file name: hourly1h_16_011020_2000.json.gz |
4 days/hourly forecast | 209,579 | 02:00, 08:00, 14:00, 20:00 |
daily_14_mmddyy_hhmm.json.gz
Example of file name: daily_14_011020_1800.json.gz |
16 days/daily forecast | 22,635 | 06:00, 18:00 |
daily_16_mmddyy_hhmm.json.gz
Example of file name: daily_16_011020_1800.json.gz |
16 days/daily forecast | 209,579 | 06:00, 18:00 |
hourly_14_mmddyy_hhmm.json.gz
Example of file name: hourly_14_011020_1800.json.gz |
5 days/3 hour forecast | 22,635 | 01:00, 02:00, 03:00, 04:00, 05:00, 06:00, 07:00, 08:00, 09:00, 10:00, 11:00, 12:00, 13:00, 14:00, 15:00, 16:00, 17:00, 18:00, 19:00, 20:00, 21:00, 22:00, 23:00, 00:00 |
hourly_16_mmddyy_hhmm.json.gz
Example of file name: hourly_16_011020_1800.json.gz |
5 days/3 hour forecast | 209,579 | 06:00, 18:00 |