Open-Meteo Weather Forecast API

https://open-meteo.com/en/docs
Admin
Open-Meteo provides a Weather Forecast API for seamless integration of high-resolution weather...
Tokens:123,142
Snippets:661
Trust Score:9.9
Update:1 week ago
Show doc for...
Tokens:
Raw
### GET /v1/gem

Source: https://open-meteo.com/en/docs/gem-api

Retrieves a 7-day hourly weather forecast for the given coordinates and weather variables. Supports multiple locations and various configuration parameters.

```APIDOC
## GET /v1/gem

### Description
Retrieves a 7-day hourly weather forecast for the given coordinates and weather variables. Supports multiple locations and various configuration parameters.

### Method
GET

### Endpoint
/v1/gem

### Parameters
#### Query Parameters
- **latitude, longitude** (Floating point) - Required - Geographical WGS84 coordinates of the location. Multiple coordinates can be comma separated. E.g. &latitude=52.52,48.85&longitude=13.41,2.35. To return data for multiple locations the JSON output changes to a list of structures. CSV and XLSX formats add a column location_id.
- **elevation** (Floating point) - Optional - The elevation used for statistical downscaling. Per default, a 90 meter digital elevation model is used. You can manually set the elevation to correctly match mountain peaks. If &elevation=nan is specified, downscaling will be disabled and the API uses the average grid-cell height. For multiple locations, elevation can also be comma separated.
- **hourly** (String array) - Optional - A list of weather variables which should be returned. Values can be comma separated, or multiple &hourly= parameter in the URL can be used.
- **daily** (String array) - Optional - A list of daily weather variable aggregations which should be returned. Values can be comma separated, or multiple &daily= parameter in the URL can be used. If daily weather variables are specified, parameter timezone is required.
- **current** (String array) - Optional - A list of weather variables to get current conditions.
- **temperature_unit** (String) - Optional - Default: celsius - If fahrenheit is set, all temperature values are converted to Fahrenheit.
- **wind_speed_unit** (String) - Optional - Default: kmh - Other wind speed units: ms, mph and kn
- **precipitation_unit** (String) - Optional - Default: mm - Other precipitation amount units: inch
- **timeformat** (String) - Optional - Default: iso8601 - By default, timestamps use ISO 8601 format with a fixed offset, utc_offset_seconds, resolved at request time (see timezone). With unixtime, timestamps are seconds since 1970-01-01 00:00 UTC. To reproduce the API's dates and times, format them using utc_offset_seconds.
- **timezone** (String) - Optional - Default: GMT - The requested timezone's UTC offset at request time is returned as utc_offset_seconds and used for ISO 8601 timestamps and daily boundaries throughout the response. Daylight saving time (DST) changes within the requested range are ignored. For DST-aware local times, request timeformat=unixtime and convert using the returned timezone in your application. Any name from the time zone database is supported. auto resolves the time zone from the coordinates. For multiple coordinates, a comma separated list of time zones can be specified.
- **past_days** (Integer) - Optional - Default: 0 - If past_days is set, past weather data can be returned.
- **forecast_days** (Integer (0-10)) - Optional - Default: 5 - Per default, 5 days are returned. Up to 10 days of forecast are possible.
- **forecast_hours** - Optional - Similar to forecast_days, the number of timesteps of hourly data can controlled. Instead of using the current day as a reference, the current hour is used.
- **past_hours** (Integer (>0)) - Optional - Similar to forecast_days, the number of timesteps of hourly data can controlled. Instead of using the current day as a reference, the current hour is used.
- **start_date** (String (yyyy-mm-dd)) - Optional - The time interval to get weather data. A day must be specified as an ISO8601 date (e.g. 2022-06-30).
- **end_date** (String (yyyy-mm-dd)) - Optional - The time interval to get weather data. A day must be specified as an ISO8601 date (e.g. 2022-06-30).
- **start_hour** (String (yyyy-mm-ddThh:mm)) - Optional - The time interval to get weather data for hourly data. Time must be specified as an ISO8601 date (e.g. 2022-06-30T12:00).
- **end_hour** (String (yyyy-mm-ddThh:mm)) - Optional - The time interval to get weather data for hourly data. Time must be specified as an ISO8601 date (e.g. 2022-06-30T12:00).
- **cell_selection** (String) - Optional - Default: land - Set a preference how grid-cells are selected. The default land finds a suitable grid-cell on land with similar elevation to the requested coordinates using a 90-meter digital elevation model. sea prefers grid-cells on sea. nearest selects the nearest possible grid-cell.
- **apikey** (String) - Optional - Only required to commercial use to access reserved API resources for customers. The server URL requires the prefix customer-. See pricing for more information.

### Response
#### Success Response (200)
- **hourly** - Hourly weather forecast data for 7 days, starting at 0:00 today and containing 168 hours.
- **daily** - Daily weather variable aggregations if requested.
- **current** - Current weather conditions if requested.
- **utc_offset_seconds** - The UTC offset in seconds for the requested timezone.
- **timezone** - The resolved timezone.

#### Response Example
{
  "latitude": 52.52,
  "longitude": 13.41,
  "timezone": "GMT",
  "utc_offset_seconds": 0,
  "hourly": {
    "time": ["2024-01-01T00:00"],
    "temperature_2m": [0.0]
  }
}
```

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

### GET /v1/forecast

Source: https://open-meteo.com/en/docs/climate-api

Retrieves daily weather forecast data. The response includes coordinates, generation time, timezone information, and daily weather variables.

```APIDOC
## [GET] /v1/forecast

### Description
Retrieves daily weather forecast data. The response includes coordinates, generation time, timezone information, and daily weather variables.

### Method
GET

### Endpoint
/v1/forecast

### Response
#### Success Response (200)
- **latitude** (Floating point) - WGS84 latitude of the center of the weather grid-cell.
- **longitude** (Floating point) - WGS84 longitude of the center of the weather grid-cell.
- **generationtime_ms** (Floating point) - Generation time of the weather forecast in milliseconds.
- **utc_offset_seconds** (Integer) - UTC offset for the requested timezone, in seconds.
- **timezone** (String) - Resolved timezone identifier (e.g. Europe/Berlin).
- **timezone_abbreviation** (String) - Timezone abbreviation at request time (e.g. CEST).
- **daily** (Object) - For each selected daily weather variable, data is returned as a floating point array. Also includes a time array with ISO8601 timestamps.
- **daily_units** (Object) - For each selected daily weather variable, the unit is listed.

#### Response Example
{
    "latitude": 52.52,
    "longitude": 13.419,
    "generationtime_ms": 2.2119,
    "timezone": "Europe/Berlin",
    "timezone_abbreviation": "CEST",
    "daily": {
        "time": ["2022-07-01", "2022-07-01", "2022-07-01", ...],
        "temperature_2m_max": [13, 12.7, 12.7, 12.5, 12.5, 12.8, ...]
    },
    "daily_units": {
        "temperature_2m": "°C"
    }
}

#### Error Response (400)
- **error** (Boolean) - Always true when an error occurs.
- **reason** (String) - Description of the error.

#### Error Response Example
{
    "error": true,
    "reason": "Cannot initialize WeatherVariable from invalid String value tempeture_2m_max for key daily"
}
```

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

### Marine Weather API - Hourly and Daily Parameters

Source: https://open-meteo.com/en/docs/marine-weather-api

Lists the supported hourly and daily weather variables, their valid time, units, and descriptions. These parameters are used with the 'hourly' and 'daily' query parameters.

```APIDOC
## Marine Weather API - Hourly and Daily Parameters

### Description
This section documents the parameters accepted by the Marine Weather API for hourly and daily forecasts. The 'hourly' parameter accepts instantaneous values for the indicated hour, while some variables like precipitation are calculated from the preceding hour. The 'daily' parameter provides 24-hour aggregations of hourly values.

### Hourly Parameters

| Variable | Valid time | Unit | Description |
|---|---|---|---|
| wave_height, wind_wave_height, swell_wave_height, secondary_swell_wave_height, tertiary_swell_wave_height | Instant | Meter | Wave height of significant mean, wind and swell waves. Wave directions are always reported as the direction the waves come from. 0° = From north towards south; 90° = From east |
| wave_direction, wind_wave_direction, swell_wave_direction, secondary_swell_wave_direction, tertiary_swell_wave_direction | Instant | ° | Mean direction of mean, wind and swell waves |
| wave_period, wind_wave_period, swell_wave_period, secondary_swell_wave_period, tertiary_swell_wave_period | Instant | Seconds | Period between mean, wind and swell waves. |
| wind_wave_peak_period, swell_wave_peak_period | Instant | Seconds | Peak period between wind and swell waves. |
| ocean_current_velocity | Instant | km/h (mph, m/s, knots) | Velocity of ocean current considering Eulerian, Waves and Tides. |
| ocean_current_direction | Instant | ° | Direction following the flow of the current. E.g. where the current is heading towards. 0° = Going north; 90° = Towards east. |
| sea_surface_temperature | Instant | Celsius | The sea surface temperature close to the water surface |
| sea_level_height_msl | Instant | metre | The sea level height accounts for ocean tides, the inverted barometer effect, sea surface height, global mean steric variation, and global mean mass volume variation. The reference (datum) height is the global mean sea level, not the lowest astronomical tide. Accuracy is limited in coastal areas—while it can be reasonably accurate near unobstructed coasts, it may be completely unreliable further inland. This data is not suitable for coastal navigation. |
| invert_barometer_height | Instant | metre | Invert barometer effect is the height low and high pressure systems effect the sea level height. This is already considered in sea_level_height_msl |

### Daily Parameters

| Variable | Unit | Description |
|---|---|---|
| wave_height_max, wind_wave_height_max, swell_wave_height_max | Meter | Maximum wave height on a given day for mean, wind and swell waves |
| wave_direction_dominant, wind_wave_direction_dominant, swell_wave_direction_dominant | ° | Dominant wave direction of mean, wind and swell waves |
| wave_period_max, wind_wave_period_max, swell_wave_period_max | Seconds | Maximum wave period of mean, wind and swell |
| wind_wave_peak_period_max, swell_wave_peak_period_max | Seconds | Maximum peak period between wind and swell waves. |

### Usage
These parameters are used with the 'hourly' and 'daily' query parameters in the API request. For example, to request hourly wave height, use 'hourly=wave_height'.
```

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

### Elevation API Error Response

Source: https://open-meteo.com/en/docs/elevation-api

Example of an error response returned with HTTP 400 status code when a URL parameter is incorrect, such as a latitude out of range.

```json
{
    "error":true,
    "reason":"Latitude must be in range of -90 to 90°. Given: 522.52."
}
```

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

### Daily Parameters

Source: https://open-meteo.com/en/docs/ensemble-api

Lists the daily aggregation variables accepted by the &daily= parameter, including their units and descriptions.

```APIDOC
## Daily Parameters

### Description
This endpoint accepts the `daily` query parameter with the following daily aggregation variables. Each variable is a 24-hour aggregation of hourly values.

### Method
GET

### Endpoint
`/v1/forecast?daily=...`

### Parameters
#### Query Parameters
- **daily** (string) - Required - Comma-separated list of daily weather variables. Supported values are listed below.

### Supported Variables
| Variable | Unit | Description |
|---|---|---|
| temperature_2m_max | °C (°F) | Maximum daily air temperature at 2 meters above ground |
| temperature_2m_mean | °C (°F) | Mean daily air temperature at 2 meters above ground |
| temperature_2m_min | °C (°F) | Minimum daily air temperature at 2 meters above ground |
| apparent_temperature_max | °C (°F) | Maximum daily apparent temperature |
| apparent_temperature_mean | °C (°F) | Mean daily apparent temperature |
| apparent_temperature_min | °C (°F) | Minimum daily apparent temperature |
| cloud_cover_max | % | Maximum daily cloud cover as an area fraction |
| cloud_cover_mean | % | Mean daily cloud cover as an area fraction |
| cloud_cover_min | % | Minimum daily cloud cover as an area fraction |
| relative_humidity_2m_max | % | Maximum daily relative humidity at 2 meters above ground |
| relative_humidity_2m_mean | % | Mean daily relative humidity at 2 meters above ground |
| relative_humidity_2m_min | % | Minimum daily relative humidity at 2 meters above ground |
| rain_sum | mm | Sum of daily rain |
| snowfall_sum | cm | Sum of daily snowfall |
| precipitation_sum | mm | Sum of daily precipitation (including rain, showers and snowfall) |
| precipitation_hours | hours | The number of hours with rain |
| pressure_msl_max | hPa | Maximum atmospheric air pressure reduced to mean sea level |
| pressure_msl_mean | hPa | Mean atmospheric air pressure reduced to mean sea level |
| pressure_msl_min | hPa | Minimum atmospheric air pressure reduced to mean sea level |
| surface_pressure_max | hPa | Maximum atmospheric air pressure at surface |
| surface_pressure_mean | hPa | Mean atmospheric air pressure at surface |
| surface_pressure_min | hPa | Minimum atmospheric air pressure at surface |
| wind_speed_10m_max | km/h (mph, m/s, knots) | Maximum daily wind speed at 10 meters above ground |
| wind_speed_10m_mean | km/h (mph, m/s, knots) | Mean daily wind speed at 10 meters above ground |
| wind_speed_10m_min | km/h (mph, m/s, knots) | Minimum daily wind speed at 10 meters above ground |
| wind_gusts_10m_max | km/h (mph, m/s, knots) | Maximum daily wind gusts at 10 meters above ground |
| wind_gusts_10m_mean | km/h (mph, m/s, knots) | Mean daily wind gusts at 10 meters above ground |
| wind_gusts_10m_min | km/h (mph, m/s, knots) | Minimum daily wind gusts at 10 meters above ground |
| wind_direction_10m_dominant | ° | Dominant wind direction at 10 meters |
| wind_direction_100m_dominant | ° | Dominant wind direction at 100 meters |
| dew_point_2m_max | °C (°F) | Maximum daily dew point temperature at 2 meters above ground |
| dew_point_2m_mean | °C (°F) | Mean daily dew point temperature at 2 meters above ground |
| dew_point_2m_min | °C (°F) | Minimum daily dew point temperature at 2 meters above ground |
| shortwave_radiation_sum | MJ/m² | Sum of solar radiation on a given day in Megajoules |
| cape_max | J/kg | Maximum convective available potential energy |
| cape_mean | J/kg | Mean convective available potential energy |
| cape_min | J/kg | Minimum convective available potential energy |
| et0_fao_evapotranspiration | mm | Daily sum of ET₀ Reference Evapotranspiration of a well watered grass field |

### Response
#### Success Response (200)
The response will contain the requested daily variables in the `daily` object.

#### Response Example
```json
{
  "daily": {
    "temperature_2m_max": [25.1, 26.3],
    "temperature_2m_mean": [18.2, 19.0],
    "temperature_2m_min": [10.5, 11.2]
  }
}
```
```

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

### GET /v1/forecast

Source: https://open-meteo.com/en/docs/meteofrance-api

Retrieves weather forecast data for a given location. Returns a JSON object with coordinates, elevation, timezone, and requested weather variables.

```APIDOC
## [GET] /v1/forecast

### Description
Retrieves weather forecast data for a given location. Returns a JSON object with coordinates, elevation, timezone, and requested weather variables.

### Method
GET

### Endpoint
/v1/forecast

### Parameters
#### Query Parameters
- **latitude** (Floating point) - Required - WGS84 latitude of the location.
- **longitude** (Floating point) - Required - WGS84 longitude of the location.
- **elevation** (Floating point) - Optional - Elevation in meters. If not specified, uses a 90 meter digital elevation model. Use `elevation=nan` to disable downscaling.
- **timezone** (String) - Optional - Time zone identifier (e.g., Europe/Berlin). If not specified, UTC is used.
- **hourly** (String) - Optional - Comma-separated list of hourly weather variables (e.g., temperature_2m).
- **daily** (String) - Optional - Comma-separated list of daily weather variables.

### Request Example
```
GET /v1/forecast?latitude=52.52&longitude=13.419&hourly=temperature_2m
```

### Response
#### Success Response (200)
- **latitude** (Floating point) - Latitude of the grid-cell center.
- **longitude** (Floating point) - Longitude of the grid-cell center.
- **elevation** (Floating point) - Elevation from a 90 meter digital elevation model.
- **generationtime_ms** (Floating point) - Generation time in milliseconds.
- **utc_offset_seconds** (Integer) - UTC offset in seconds for the requested timezone.
- **timezone** (String) - Resolved time zone identifier.
- **timezone_abbreviation** (String) - Time zone abbreviation at request time.
- **hourly** (Object) - Object containing time array and arrays for each requested hourly variable.
- **hourly_units** (Object) - Units for each hourly variable.
- **daily** (Object) - Object containing time array and arrays for each requested daily variable.
- **daily_units** (Object) - Units for each daily variable.

#### Response Example
```
{
    "latitude": 52.52,
    "longitude": 13.419,
    "elevation": 44.812,
    "generationtime_ms": 2.2119,
    "utc_offset_seconds": 0,
    "timezone": "Europe/Berlin",
    "timezone_abbreviation": "CEST",
    "hourly": {
        "time": ["2022-07-01T00:00", "2022-07-01T01:00", "2022-07-01T02:00", ...],
        "temperature_2m": [13, 12.7, 12.7, 12.5, 12.5, 12.8, 13, 12.9, 13.3, ...]
    },
    "hourly_units": {
        "temperature_2m": "°C"
    }
}
```

### Error Handling
#### Error Response (400)
- **error** (Boolean) - Always `true` when an error occurs.
- **reason** (String) - Description of the error.

#### Error Example
```
{
    "error": true, 
    "reason": "Cannot initialize WeatherVariable from invalid String value tempeture_2m for key hourly" 
}
```
```
Tokens:
Raw