OpenWeather Weather API

https://openweathermap.org/api
Admin
OpenWeather provides a comprehensive suite of weather APIs, including current weather, forecasts,...
Tokens:97,017
Snippets:936
Trust Score:10
Update:1 month ago
Show doc for...
Tokens:
Raw
### Get Solar Panel Data URL Example

Source: https://openweathermap.org/api/solar-panels-and-energy-prediction-2

A concrete example of the URL used to fetch solar panel data.

```text
https://api.openweathermap.org/energy/2.0/panel/F48BE762-6101-405B-BB72-E0CA9FE1A8FF?appid={API key}
```

--------------------------------

### Get Location Data URL Example

Source: https://openweathermap.org/api/solar-panels-and-energy-prediction-2

A concrete example of the URL used to fetch a specific location.

```text
https://api.openweathermap.org/energy/2.0/location/F01E165B-22F3-4591-89D4-F238E92F6885?appid={API key}
```

--------------------------------

### API Request Example

Source: https://openweathermap.org/api/wind-power-generations

A sample GET request including required location and turbine parameters.

```text
https://demo.openweathermap.org/wind-
heights/1.0/forecast/power_generation?lat=40.7128&lon=-74.006&altitude_meters=10&turbine_power_w=80000&cut_in_speed=1&appid=YOUR_API_KEY
```

--------------------------------

### API Format Examples

Source: https://openweathermap.org/api/hourly-forecast

Examples demonstrating how to request weather data in JSON or XML formats.

```text
api.openweathermap.org/data/2.5/weather?q=London&appid={API key}
```

```text
api.openweathermap.org/data/2.5/weather?q=London&mode=xml
```

--------------------------------

### API URL Example

Source: https://openweathermap.org/api/global-precipitation-map

A concrete example of a formatted API request URL.

```text
https://maps.openweathermap.org/maps/2.0/radar/6/13/24?&appid={API key}&tm=1600781400
```

--------------------------------

### Solar Panels URL Example

Source: https://openweathermap.org/api/solar-panels-and-energy-prediction-2

Example request URL for retrieving solar panels at a specific location.

```text
https://api.openweathermap.org/energy/2.0/location/F01E165B-22F3-4591-89D4-F238E92F6885/panels?appid={API key}
```

--------------------------------

### Bulk Download URL Example

Source: https://openweathermap.org/api/bbox-groupby-transfer

A concrete example of a URL used to download a specific historical weather dataset.

```text
https://bulk.openweathermap.org/archive/weather_zip_uk_011020_2000.csv.gz?appid={API key}
```

--------------------------------

### API URL Example

Source: https://openweathermap.org/api/weather-map-1h

A concrete example of a request URL for a specific weather layer and tile coordinates.

```text
https://maps.openweathermap.org/maps/2.0/weather/1h/TA2/4/1/6?appid={API key}
```

--------------------------------

### Example API Call

Source: https://openweathermap.org/api/one-call-4

A concrete example of an API request for a specific weather alert ID.

```text
https://api.openweathermap.org/data/4.0/onecall/alert/8B46C632-DCA7-44D7-8BDF-02445621BAFF?appid={API key}
```

--------------------------------

### Wind API Request Example

Source: https://openweathermap.org/api/wind-speed

A complete example request URL including required query parameters.

```text
http://demo.openweathermap.org/wind-heights/1.0/forecast?lat=40.7128&lon=-74.006&altitude_meters=100&max_hours=2&appid=CLIENT_API_KEY
```

--------------------------------

### Example Radar Tile URL

Source: https://openweathermap.org/api/global-precipitation-map?collection=maps

An example of a complete URL to fetch a specific radar tile, demonstrating the parameter usage.

```URL
https://maps.openweathermap.org/maps/2.0/radar/6/13/24?&appid={API key}&tm=1600781400
```

--------------------------------

### Example API Request URL

Source: https://openweathermap.org/api/lightning

A concrete example of a formatted request URL for the lightning data endpoint.

```http
https://demo.openweathermap.org/lightning/1.0/data?lat=34.360371&lon=22.617449&radius=20&start_date=2023-09-08T21:00:00Z&end_date=2023-09-08T21:10:00Z&apik
ey={YOUR_API_KEY}
```

--------------------------------

### Example API Call

Source: https://openweathermap.org/api/history

A concrete example of an API request for historical weather data at specific coordinates.

```text
https://history.openweathermap.org/data/2.5/history/city?lat=41.85&lon=-87.65&appid={API key}
```

--------------------------------

### API URL Example

Source: https://openweathermap.org/api/global-precipitation-map-forecast

A concrete example of a map tile request URL with specific zoom, coordinate, and timestamp parameters.

```text
https://maps.openweathermap.org/maps/2.0/radar/forecast/6/13/24?&appid={API key}&tm=1600781400
```

--------------------------------

### Hourly Forecast API Request Examples

Source: https://openweathermap.org/api/hourly-forecast

Example of an API request for hourly forecast data in XML format.

```text
https://pro.openweathermap.org/data/2.5/forecast/hourly?q=London,us&mode=xml&appid={API key}
```

--------------------------------

### Hourly Forecast API Response Example

Source: https://openweathermap.org/api/hourly-forecast

Example of an API request call for a specific city.

```text
https://pro.openweathermap.org/data/2.5/forecast/hourly?q=München,DE&appid={API key}
```

--------------------------------

### Solar Irradiance API Example Call

Source: https://openweathermap.org/api/solar-irradiance

A concrete example of an API request for a specific location and date.

```text
https://api.openweathermap.org/energy/2.0/solar/interval_data?lat=51.509865&lon=-0.118092&date=2023-10-10&interval=1h&appid={API key}
```

--------------------------------

### Fire Weather Index Map URL Example

Source: https://openweathermap.org/api/fire-index-map

A concrete example of a formatted URL for a specific tile and timestamp.

```text
https://maps.openweathermap.org/maps/2.0/fwi/4/1/6?appid={API key}&date=1600780200
```

--------------------------------

### Example 15-minute timeline API request

Source: https://openweathermap.org/api/one-call-4

A concrete example of an API request using specific latitude and longitude coordinates.

```text
https://api.openweathermap.org/data/4.0/onecall/timeline/15min?lat=51.5&lon=-0.1&appid={API key}
```

--------------------------------

### Localized API Call Example

Source: https://openweathermap.org/api/one-call-4

Example of an API call requesting Chinese Simplified (zh_cn) output.

```text
https://api.openweathermap.org/data/4.0/onecall/current?lat=30.489772&lon=-99.771335&lang=zh_cn&appid={API key}
```

--------------------------------

### Precipitation Map Layer Example

Source: https://openweathermap.org/api/global-precipitation-map

A specific example URL for retrieving a precipitation map layer tile.

```text
https://maps.openweathermap.org/maps/2.0/radar/7/4/2?&appid={API key}&tm=1703171400
```

--------------------------------

### Hourly Forecast API Call Example by ZIP Code

Source: https://openweathermap.org/api/hourly-forecast

Example request for hourly forecast data using a ZIP code.

```text
https://pro.openweathermap.org/data/2.5/forecast/hourly?zip=94040,us&appid={API key}
```

--------------------------------

### Weather Map API URL Example

Source: https://openweathermap.org/api/weather-map-2

A concrete example of a weather map request URL including optional parameters like date, opacity, and fill_bound.

```text
http://maps.openweathermap.org/maps/2.0/weather/TA2/{z}/{x}/{y}?date=1552861800&opacity=0.9&fill_bound=true&appid={API key}
```

--------------------------------

### Historical Data Examples by City Name

Source: https://openweathermap.org/api/history

Example API calls for retrieving historical data for specific cities.

```text
https://history.openweathermap.org/data/2.5/history/city?q=London,UK&appid={API key}
```

```text
https://history.openweathermap.org/data/2.5/history/city?q=Munchen,DE&appid={API key}
```

--------------------------------

### 1-Hour Timeline API Example Call

Source: https://openweathermap.org/api/one-call-4

A concrete example of an API request using specific latitude and longitude coordinates.

```text
https://api.openweathermap.org/data/4.0/onecall/timeline/1h?lat=51.5&lon=-0.1&appid={API key}
```

--------------------------------

### Hourly Forecast API Call Example

Source: https://openweathermap.org/api/hourly-forecast

A concrete example of an API request URL with specific latitude and longitude coordinates.

```text
https://pro.openweathermap.org/data/2.5/forecast/hourly?lat=44.34&lon=10.99&appid={API key}
```

--------------------------------

### API Call Example

Source: https://openweathermap.org/api/fire-index-api

A concrete example of an API request using specific latitude and longitude coordinates.

```text
https://api.openweathermap.org/data/2.5/fwi/forecast?lat=35&lon=-102&appid={API key}
```

--------------------------------

### Delete Solar Panel URL Example

Source: https://openweathermap.org/api/solar-panels-and-energy-prediction-2

Example request URL for deleting a solar panel by its ID.

```text
https://api.openweathermap.org/energy/2.0/panel/F01E165B-22F3-4591-89D4-F238E92F6885?appid={API key}
```

--------------------------------

### Hourly Forecast API Call Example by City ID

Source: https://openweathermap.org/api/hourly-forecast

Example request for hourly forecast data for a specific city ID.

```text
https://pro.openweathermap.org/data/2.5/forecast/hourly?id=524901&appid={API key}
```

--------------------------------

### Example Global Precipitation Map Layer URL

Source: https://openweathermap.org/api/global-precipitation-map?collection=maps

This example shows a URL specifically for the Global Precipitation Map layer, highlighting the parameters for zoom, coordinates, API key, and timestamp.

```URL
https://maps.openweathermap.org/maps/2.0/radar/7/4/2?&appid={API key}&tm=1703171400
```

--------------------------------

### One Call 3.0 API Request Example

Source: https://openweathermap.org/api/bbox-groupby-transfer

A standard API call example for retrieving current weather and forecast data for specific coordinates.

```text
https://api.openweathermap.org/data/3.0/onecall?lat=33.44&lon=-94.04&appid={API key}
```

--------------------------------

### JSONP Callback Response Example

Source: https://openweathermap.org/api/forecast16

Example of a JSONP response format returned when a callback function name is provided in the API request.

```text
test(
{
 "coord":{
    "lon":-0.13,
    "lat":51.51
 },
 "weather":[
    {
       "id":300,
       "main":"Drizzle",
       "description":"light intensity drizzle",
       "icon":"09d"
    }
 ],
 "base":"stations",
 "main":{
    "temp":280.32,
    "pressure":1012,
    "humidity":81,
    "temp_min":279.15,
    "temp_max":281.15
 },
 "visibility":10000,
 "wind":{
    "speed":4.1,
    "deg":80,
    "gust":6.1
 },
 "clouds":{
    "all":90
 },
 "dt":1485789600,
 "sys":{
    "type":1,
    "id":5091,
    "message":0.0103,
    "country":"GB",
    "sunrise":1485762037,
    "sunset":1485794875
 },
 "id":2643743,
 "name":"London",
 "cod":200
}
)
```

--------------------------------

### Current Weather Data API Example Call

Source: https://openweathermap.org/api/bbox-groupby-transfer

A concrete example of an API request using specific latitude and longitude coordinates.

```text
https://api.openweathermap.org/data/2.5/weather?lat=44.34&lon=10.99&appid={API key}
```

--------------------------------

### Example API Call for Polygon Location

Source: https://openweathermap.org/api/openweather-alerts

A concrete example of an API request URL using a defined polygon coordinate set.

```text
https://api.openweathermap.org/alerts/1.0?location={"type":"Polygon","coordinates":[[[109.072266,-9.62148],[108.896484,-44.787594],[157.060547,-44.787594],[157.763672,-9.62148],[109.072266,-9.62148]]]}&appid={API key}
```

--------------------------------

### Get All Locations API Response

Source: https://openweathermap.org/api/solar-panels-and-energy-prediction-2

Example response returned when listing all locations.

```json
{
    "location_id": "F01E165B-22F3-4591-89D4-F238E92F6885",
    "type": "point",
    "coordinates": [
       {
        "lat": 51.5072,
        "lon": -0.1275
       }
     ]
  }
]
```

--------------------------------

### API Response Example

Source: https://openweathermap.org/api/solar-panels-and-energy-prediction-2

A sample JSON response containing irradiance and power output data for solar panels.

```json
{
  "location_id": "01955d08-a960-8b0a-819c-553b7b742ebe",
  "lat": 70.609,
  "lon": 170.89,
  "date": "2025-03-01",
  "tz": "+12:00",
  "interval": "1h",
  "sunrise": "2025-03-01T08:06:48",
  "sunset": "2025-03-01T17:32:34",
  "intervals": [
    {
      "start": "00:00",
      "end": "00:59",
      "avg_irradiance": {
        "clear_sky": {
          "ghi": 0,
          "dni": 0,
          "dhi": 0
        },
        "cloudy_sky": {
          "ghi": 0,
          "dni": 0,
          "dhi": 0
        }
      },
      "max_irradiance": {
        "clear_sky": {
          "ghi": 0,
          "dni": 0,
          "dhi": 0
        },
        "cloudy_sky": {
          "ghi": 0,
          "dni": 0,
          "dhi": 0
        }
      },
      "irradiation": {
        "clear_sky": {
          "ghi": 0,
          "dni": 0,
          "dhi": 0
        },
        "cloudy_sky": {
          "ghi": 0,
          "dni": 0,
          "dhi": 0
        }
      },
      "panels": [
        {
          "panel_id": "01956c1a-e7ac-85ae-9a03-86208c2f6f83",
          "clear_sky": {
            "avg_power": 0,
            "max_power": 0,
            "energy": 0
          },
          "cloudy_sky": {
            "avg_power": 0,
            "max_power": 0,
            "energy": 0
          }
        },
        {
          "panel_id": "0196afd6-ffe3-885c-8132-53993fbd511a",
          "clear_sky": {
            "avg_power": 0,
            "max_power": 0,
            "energy": 0
          },
          "cloudy_sky": {
            "avg_power": 0,
            "max_power": 0,
            "energy": 0
          }
        }
      ]
    },
    {
      "start": "01:00",
      "end": "01:59",
      "avg_irradiance": {
        "clear_sky": {
          "ghi": 0,
          "dni": 0,
          "dhi": 0
        },
        "cloudy_sky": {
          "ghi": 0,
          "dni": 0,
          "dhi": 0
        }
      },
      "max_irradiance": {
        "clear_sky": {
          "ghi": 0,
          "dni": 0,
          "dhi": 0
        },
        "cloudy_sky": {
          "ghi": 0,
          "dni": 0,
          "dhi": 0
        }
      },
      "irradiation": {
        "clear_sky": {
          "ghi": 0,
          "dni": 0,
          "dhi": 0
        },
        "cloudy_sky": {
          "ghi": 0,
          "dni": 0,
          "dhi": 0
        }
      }
```

--------------------------------

### Get Location Data API Response

Source: https://openweathermap.org/api/solar-panels-and-energy-prediction-2

Example response returned when querying a specific location.

```json
{
  "location_id": "F01E165B-22F3-4591-89D4-F238E92F6885",
  "type": "point",
  "coordinates": [
     {
      "lat": 51.507222,
      "lon": -0.1275
     }
   ]
}
```

--------------------------------

### GET /data/2.5/history/accumulated_precipitation

Source: https://openweathermap.org/api/accumulated-parameters

Retrieves accumulated precipitation data for a given latitude and longitude between a start and end timestamp.

```APIDOC
## GET /data/2.5/history/accumulated_precipitation

### Description
Retrieves the total accumulated precipitation for a specified location and time period.

### Method
GET

### Endpoint
http://history.openweathermap.org/data/2.5/history/accumulated_precipitation

### Parameters
#### Query Parameters
- **lat** (float) - Required - Geographical latitude.
- **lon** (float) - Required - Geographical longitude.
- **start** (integer) - Required - Start date (unix time, UTC).
- **end** (integer) - Required - End date (unix time, UTC).
- **appid** (string) - Required - Your unique API key.

### Request Example
http://history.openweathermap.org/data/2.5/history/accumulated_precipitation?lat=51.51&lon=-0.12&start=1586853378&end=1589445367&appid={API key}

### Response
#### Success Response (200)
- **date** (string) - Date of the record.
- **rain** (float) - Precipitation accumulation indicator, in mm.
- **count** (integer) - Number of data measurements.

#### Response Example
{
  "date": "2020-4-15",
  "rain": 0.6,
  "count": 2
}
```

--------------------------------

### Accumulated Precipitation API Call with Parameters

Source: https://openweathermap.org/api/accumulated-parameters?collection=historical

Example of an API call for accumulated precipitation, specifying latitude, longitude, start and end dates, and an API key.

```http
http://history.openweathermap.org/data/2.5/history/accumulated_precipitation?lat=51.51&lon=-0.12&start=1586853378&end=1589445367&appid={API key}
```

--------------------------------

### Constructing an API Request

Source: https://openweathermap.org/api_keys

Examples of how to format the API request URL with an API key parameter.

```http
http://api.openweathermap.org/data/2.5/forecast?id=524901&appid={API key}
```

```http
api.openweathermap.org/data/2.5/forecast?id=524901&appid={API key}
```

--------------------------------

### Accumulated Temperature API Call with Parameters

Source: https://openweathermap.org/api/accumulated-parameters?collection=historical

Example of an API call for accumulated temperature, specifying latitude, longitude, start and end dates, a temperature threshold, and an API key.

```http
http://history.openweathermap.org/data/2.5/history/accumulated_temperature?lat=51.51&lon=-0.13&start=1586853378&end=1589445367&threshold=284&appid={API key}
```

--------------------------------

### Get Air Pollution History

Source: https://openweathermap.org/api/air-pollution?collection=environmental

Fetches historical air pollution data for a given latitude and longitude within a specified start and end date. Requires an API key for authentication.

```APIDOC
## GET /data/2.5/air_pollution/history

### Description
Retrieves historical air pollution data for a specific location and time range.

### Method
GET

### Endpoint
/data/2.5/air_pollution/history

### Parameters
#### Query Parameters
- **lat** (number) - Required - Latitude. 
- **lon** (number) - Required - Longitude. 
- **start** (integer) - Required - Start date (unix time, UTC time zone), e.g. start=1606488670. 
- **end** (integer) - Required - End date (unix time, UTC time zone), e.g. end=1606747870. 
- **appid** (string) - Required - Your unique API key.

### Response
#### Success Response (200)
- **coord** (array) - Coordinates from the specified location (latitude, longitude).
- **list** (array) - An array of historical air pollution data points.
  - **dt** (integer) - Date and time, Unix, UTC.
  - **main** (object)
    - **aqi** (integer) - Air Quality Index. Possible values: 1, 2, 3, 4, 5.
  - **components** (object)
    - **co** (number) - Concentration of CO (Carbon monoxide), μg/m3.
    - **no** (number) - Concentration of NO (Nitrogen monoxide), μg/m3.
    - **no2** (number) - Concentration of NO2 (Nitrogen dioxide), μg/m3.
    - **o3** (number) - Concentration of O3 (Ozone), μg/m3.
    - **so2** (number) - Concentration of SO2 (Sulphur dioxide), μg/m3.
    - **pm2_5** (number) - Concentration of PM2.5 (Fine particles matter), μg/m3.
    - **pm10** (number) - Concentration of PM10 (Coarse particulate matter), μg/m3.
    - **nh3** (number) - Concentration of NH3 (Ammonia), μg/m3.

### Request Example
```json
{
  "coord": [
    50.0,
    50.0
  ],
  "list": [
    {
      "main": {
        "aqi": 2
      },
      "components": {
        "co": 270.367,
        "no": 5.867,
        "no2": 43.184,
        "o3": 4.783,
        "so2": 14.544,
        "pm2_5": 13.448,
        "pm10": 15.524,
        "nh3": 0.289
      },
      "dt": 1606482000
    }
  ]
}
```

### Response Example
```json
{
  "coord": [
    50,
    50
  ],
  "list": [
    {
      "dt": 1605182400,
      "main": {
        "aqi": 1
      },
      "components": {
        "co": 201.94053649902344,
        "no": 0.01877197064459324,
        "no2": 0.7711350917816162,
        "o3": 68.66455078125,
        "so2": 0.6407499313354492,
        "pm2_5": 0.5,
        "pm10": 0.540438711643219,
        "nh3": 0.12369127571582794
      }
    }
  ]
}
```
```

--------------------------------

### Example Fire Weather Index Map API Call

Source: https://openweathermap.org/api/fire-index-map?collection=maps

An example of a complete API call for a Fire Weather Index map. This specific example requests data for a particular date.

```URL
https://maps.openweathermap.org/maps/2.0/fwi/4/1/6?appid={API key}&date=1600780200
```

--------------------------------

### [GET] /stations/{:id}

Source: https://openweathermap.org/api/stations

Get information about a specific station by its internal identifier.

```APIDOC
## [GET] /stations/{:id}

### Description
This method is used to get information about one station with a standard set of attributes: external and internal identifiers, creation and update timestamps, name, geographical arrangement, height above sea level and station rank.

### Method
GET

### Endpoint
http://api.openweathermap.org/data/3.0/stations/{:id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The internal identifier of the station.
```

--------------------------------

### Example API Call and Response

Source: https://openweathermap.org/api/current

A sample request URL and the corresponding JSON response structure.

```text
https://api.openweathermap.org/data/2.5/weather?lat=44.34&lon=10.99&appid={API key}
```

```json
{
  "coord": {
    "lon": 10.99,
    "lat": 44.34
  },
  "weather": [
    {
      "id": 501,
      "main": "Rain",
      "description": "moderate rain",
      "icon": "10d"
    }
  ],
  "base": "stations",
  "main": {
    "temp": 298.48,
    "feels_like": 298.74,
    "temp_min": 297.56,
    "temp_max": 300.05,
    "pressure": 1015,
    "humidity": 64,
    "sea_level": 1015,
    "grnd_level": 933
  },
  "visibility": 10000,
  "wind": {
    "speed": 0.62,
    "deg": 349,
    "gust": 1.18
  },
  "rain": {
    "1h": 3.16
  },
  "clouds": {
    "all": 100
  },
  "dt": 1661870592,
  "sys": {
    "type": 2,
    "id": 2075663,
    "country": "IT",
    "sunrise": 1661834187,
    "sunset": 1661882248
  },
  "timezone": 7200,
  "id": 3163858,
  "name": "Zocca",
  "cod": 200
}
```

--------------------------------

### Solar Panel Creation Response

Source: https://openweathermap.org/api/solar-panels-and-energy-prediction-2

Example JSON response returned upon successful creation of a solar panel.

```json
{
  "panel_id": "F48BE762-6101-405B-BB72-E0CA9FE1A8FF",
  "location_id": "F01E165B-22F3-4591-89D4-F238E92F6885",
  "type": "mono-si",
  "area": 1.5,
  "tilt": 45,
  "azimuth": 182,
  "peak_power": 2.5
}
```

--------------------------------

### Example API Request

Source: https://openweathermap.org/api/one-call-4

A sample request URL demonstrating the use of latitude, longitude, units, and language parameters.

```text
https://api.openweathermap.org/data/4.0/onecall/current?lat=52.2297&lon=21.0122&units=metric&lang=en&appid={API key}
```

--------------------------------

### Accumulated Temperature API Call Example

Source: https://openweathermap.org/api/accumulated-parameters

A concrete example of an API request for accumulated temperature.

```text
http://history.openweathermap.org/data/2.5/history/accumulated_temperature?lat=51.51&lon=-0.13&start=1586853378&end=1589445367&threshold=284&appid={API key}
```

--------------------------------

### Current Fire Weather Index API Example Call

Source: https://openweathermap.org/api/fire-index-api

Example request for specific coordinates.

```text
https://api.openweathermap.org/data/2.5/fwi?lat=24&lon=-103&appid={API key}
```

--------------------------------

### Custom Palette URL Example

Source: https://openweathermap.org/api/weather-map-1h

Construct a URL with a custom color palette using the format {value}:{HEX color};..;{value}:{HEX color}.

```text
https://maps.openweathermap.org/maps/2.0/weather/1h/TA2/{z}/{x}/{y}?date=1618898990&opacity=0.9&fill_bound=true&palette=0:FF0000;10:00FF00;20:0000FF&appid={API key}
```

--------------------------------

### Example API Response

Source: https://openweathermap.org/api/one-call-4

A sample JSON response containing alert details, including sender, event timing, and multilingual descriptions.

```json
{
  "id": "2.49.0.0.250.0.FR.20260827100603.644023:FR615:a512b287066f8f19b5b02accccec835d",
  "sender_name": "METEO-FRANCE",
  "event": "",
  "start": 1787817940,
  "end": 1787868000,
  "description": [
    {
      "language": "fr-FR",
      "description": "Des phénomènes habituels dans la région mais occasionnellement et localement dangereux sont prévus (exemple : mistral, orage d'été, montée des eaux, fortes vagues submergeant le littoral)."
    },
    {
      "language": "en-GB",
      "description": "Moderate damages may occur, especially in vulnerable or in exposed areas and to people who carry out weather-related activities."
    }
  ],
  "tags": [
    "Thunderstorm"
  ]
}
```

--------------------------------

### GET /snapshot/{filename}

Source: https://openweathermap.org/api/bulk

Download a bulk weather data snapshot file for current or forecast data.

```APIDOC
## GET /snapshot/{filename}

### Description
Downloads a specific bulk weather data file in JSON or CSV format. The filename corresponds to the desired dataset (e.g., hourly, daily, or zip-code specific files).

### Method
GET

### Endpoint
https://bulk.openweathermap.org/snapshot/{filename}

### Parameters
#### Path Parameters
- **filename** (string) - Required - The name of the bulk file to download (e.g., hourly1h_zip_eu.csv.gz).

#### Query Parameters
- **appid** (string) - Required - Your unique OpenWeatherMap API key.
```

--------------------------------

### API Request URLs by Unit System

Source: https://openweathermap.org/api/hourly-forecast

Examples of API request URLs using different unit systems.

```text
https://pro.openweathermap.org/data/2.5/forecast/hourly?lat=57&lon=-2.15&appid={API key}
```

```text
https://pro.openweathermap.org/data/2.5/forecast/hourly?lat=57&lon=-2.15&appid={API key}&units=metric
```

```text
https://pro.openweathermap.org/data/2.5/forecast/hourly?lat=57&lon=-2.15&appid={API key}&units=imperial
```

--------------------------------

### Reverse Geocoding API Call Example

Source: https://openweathermap.org/api/geocoding-api

A concrete example of a reverse geocoding request using specific coordinates.

```http
http://api.openweathermap.org/geo/1.0/reverse?lat=51.5098&lon=-0.1180&limit=5&appid={API key}
```

--------------------------------

### Zip Code API Response Example

Source: https://openweathermap.org/api/geocoding-api

Example JSON response structure for a zip code geocoding request.

```json
{
  "zip": "90210",
  "name": "Beverly Hills",
  "lat": 34.0901,
  "lon": -118.4065,
  "country": "US"
}
```

--------------------------------

### GET /archive/{filename}

Source: https://openweathermap.org/api/bulk

Download historical bulk weather data files from the 7-day archive.

```APIDOC
## GET /archive/{filename}

### Description
Downloads a historical bulk weather data file from the 7-day archive. Filenames include date and time stamps (e.g., weather_zip_uk_011020_2000.csv.gz).

### Method
GET

### Endpoint
https://bulk.openweathermap.org/archive/{filename}

### Parameters
#### Path Parameters
- **filename** (string) - Required - The name of the archived bulk file to download.

#### Query Parameters
- **appid** (string) - Required - Your unique OpenWeatherMap API key.
```

--------------------------------

### One Call 4.0 API Unit Examples

Source: https://openweathermap.org/api/one-call-4

Examples of API calls using standard, metric, and imperial units.

```text
https://api.openweathermap.org/data/4.0/onecall/current?lat=30.489772&lon=-99.771335&appid={API key}
```

```text
https://api.openweathermap.org/data/4.0/onecall/current?lat=30.489772&lon=-99.771335&units=metric&appid={API key}
```

```text
https://api.openweathermap.org/data/4.0/onecall/current?lat=30.489772&lon=-99.771335&units=imperial&appid={API key}
```
Tokens:
Raw