Bulk downloading

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

  1. Use links of the following types in order to access bulks files:

    To get Current and Forecast bulks files:

    http://bulk.openweathermap.org/snapshot/{BULK_FILE_NAME}?appid={API key}

    To get access to 7-days archive of current and forecasts bulk files.

    http://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)

  2. 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.

  3. 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

http://bulk.openweathermap.org/sample/

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

http://bulk.openweathermap.org/sample/

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