Skip to main content
GET
Seasonal Forecast
Fetch a long-range seasonal forecast (ECMWF SEAS5 / EC46) for a coordinate. Request daily aggregates (e.g. temperature_2m_max, temperature_2m_min, precipitation_sum) and/or six_hourly steps (e.g. temperature_2m, precipitation); interpolated hourly variables are also available. Extend the window with forecast_days. The response returns grid-cell metadata and the requested daily/six_hourly/hourly blocks, each with a time array, one array per variable, and a matching *_units object. Example: GET /apis/v1/openmeteo/seasonal?latitude=52.52&longitude=13.41&daily=temperature_2m_max,temperature_2m_min,precipitation_sum&six_hourly=temperature_2m,precipitation&timezone=Europe/Berlin. Billing: $0.00015 per call (150 micros USD), metered per request. All Open-Meteo endpoints are GET pass-through — authenticate with your AIsa API key as a bearer token (the same key used across every AIsa /apis/* endpoint); AIsa handles provider access.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

latitude
string
required

WGS84 latitude of the location. Multiple coordinates can be comma-separated.

Example:

"52.52"

longitude
string
required

WGS84 longitude of the location (negative for the Americas). Multiple coordinates can be comma-separated.

Example:

"13.41"

six_hourly
string

Comma-separated 6-hourly variables. Common values: temperature_2m, precipitation, wind_speed_10m, weather_code.

Example:

"temperature_2m,precipitation"

daily
string

Comma-separated list of daily aggregation variables to return. Requires timezone. Common values: temperature_2m_max, temperature_2m_min, temperature_2m_mean, precipitation_sum, rain_sum, snowfall_sum, weather_code, sunrise, sunset, sunshine_duration, wind_speed_10m_max, uv_index_max.

Example:

"temperature_2m_max,temperature_2m_min,precipitation_sum"

hourly
string

Comma-separated list of hourly variables to return. Interpolated hourly variables (optional). Common values: temperature_2m, relative_humidity_2m, dew_point_2m, apparent_temperature, precipitation, rain, showers, snowfall, weather_code, pressure_msl, cloud_cover, wind_speed_10m, wind_direction_10m, wind_gusts_10m, shortwave_radiation, visibility.

Example:

"temperature_2m"

forecast_days
integer
default:0

Number of forecast days to return (0-274). Default 0.

Example:

7

past_days
integer
default:0

Number of past days to include (0-92). Default 0.

start_date
string<date>

Start of the interval, yyyy-mm-dd (ISO 8601).

Example:

"2024-01-01"

end_date
string<date>

End of the interval, yyyy-mm-dd (ISO 8601).

Example:

"2024-01-07"

temperature_unit
enum<string>
default:celsius

Temperature unit. Default celsius.

Available options:
celsius,
fahrenheit
wind_speed_unit
enum<string>
default:kmh

Wind speed unit. Default kmh.

Available options:
kmh,
ms,
mph,
kn
precipitation_unit
enum<string>
default:mm

Precipitation unit. Default mm.

Available options:
mm,
inch
timeformat
enum<string>
default:iso8601

Time output format. Default iso8601.

Available options:
iso8601,
unixtime
timezone
string

IANA time zone name (e.g. Europe/Berlin) or auto to resolve from coordinates. Defaults to GMT.

Example:

"Europe/Berlin"

cell_selection
enum<string>
default:land

Grid-cell preference for the coordinate. Default land.

Available options:
land,
sea,
nearest

Response

200 - application/json

Seasonal forecast for the coordinate.

The response is of type object.