MeteoIntel

Location & Forecast length

Location:
Forecast length:

By default, we provide forecasts for 7 days, but you can access forecasts for up to 16 days.

Settings

API URL
https://api.meteointel.com/flood?latitude=59.91&longitude=10.75&daily=river_discharge Open in new tab →

API Documentation

The /flood endpoint returns river discharge data for any location. Data is from the largest river within a 5 km radius. Parameters:

latitude longitude Floating point Required
WGS84 latitude and longitude. Comma-separated for multiple locations, e.g. &latitude=52.52,48.85&longitude=13.41,2.35. Multi-location responses return a list; CSV/XLSX add location_id.
daily String array
Comma-separated list of daily variables, or use multiple &daily= parameters.
timeformat String Default: iso8601
Use unixtime for Unix epoch seconds (GMT).
past_days Integer Default: 0
Include past days in the response.
forecast_days Integer (0-210) Default: 92
Number of forecast days (default 92, max 210).
start_date end_date String (yyyy-mm-dd)
Date range in ISO format, e.g. 2022-06-30. Available: 1984-01-01 through 7 months forecast.
cell_selection String Default: nearest
Grid-cell selection: land, sea, or nearest (default).
api_key String
Your API key for authenticated requests.

New optional parameters may be added over time. Required parameters will not change for API stability.

Daily Parameter Definition

Available daily flood variables:

river_discharge m³/s
Daily river discharge rate in m³/s
river_discharge_mean river_discharge_median river_discharge_max river_discharge_min river_discharge_p25 river_discharge_p75 m³/s
Ensemble statistics (mean, median, max, min, percentiles). Forecast-only; not in historical data.

JSON Return Object

On success a JSON object will be returned.

{
    "latitude": 59.9,
    "longitude": 10.75,
    "generationtime_ms": 0.0627040863037109,
    "utc_offset_seconds": 0,
    "timezone": "GMT",
    "timezone_abbreviation": "GMT",
    "daily_units": {
        "river_discharge": "m³/s"
    },
    "daily": {
        "time": ["2025-03-03", "2025-03-04", "2025-03-05", ...],
        "river_discharge": [8.04, 8.75, 8.93, ...]
    }
}
latitude longitude Floating point
WGS84 center of the grid cell used for the forecast. May differ slightly from the requested coordinates.
generationtime_ms Floating point
Generation time of the weather forecast in milliseconds. This is mainly used for performance monitoring and improvements.
daily Object
For each selected weather variable, data will be returned as a floating point array. Additionally a time array will be returned with ISO8601 timestamps.
daily_units Object
For each selected weather variable, the unit will be listed here.

Errors

In case an error occurs, for example a URL parameter is not correctly specified, a JSON error object is returned with a HTTP 400 status code.

{
    "error": true,
    "reason": "Cannot initialize WeatherVariable from invalid String value river_discharge for key daily"
}