Flood Forecast API - River Discharge & Flood Risk Monitoring
Get reliable daily flood forecast data for any location worldwide with APIFreaks’ Flood Forecast API. It provides flood predictions - including river discharge, flow percentiles, and riverine parameters - helping you monitor flood risk and water level changes with precision.
The API supports a forecast range of up to 16 days and returns structured, easy-to-parse data through a simple REST endpoint. By combining hydrological and meteorological modeling, it ensures consistent, globally accurate flood prediction data.
Whether you’re building early warning systems, integrating flood risk analysis into your platform, or tracking river behavior, the Flood Forecast API gives developers actionable insights for safer, data-driven decision-making.
Features
Reliable Flood Forecasting
Predict river behavior and flood risks up to 16 days in advance, helping mitigate potential disasters.
Global Coverage
Access flood data for any location using location, latitude/longitude, or IP-based detection.
River Discharge & Percentiles
Get essential river-related metrics, including river discharge rates, flow percentiles, and gauge-derived data.
Detailed Location Context
Each response includes complete geographic context with continent, country, state/province, district, city, locality, postal code, precise coordinates, elevation data, and timezone information.
API Endpoint
$ pip install requestsimport requests
url = "https://api.apifreaks.com/v1.0/weather/flood"
payload = {}
headers = {
'X-apiKey': 'API-KEY'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
How to Guides
Get Flood Forecast by Location, Coordinates, or IP
You can request flood forecast data for a specific location, latitude/longitude, or IP address.
Example using Location
Use the location parameter to look up Flood Forecast by any location - city name, address etc.
# Response { "location": { "location_string": "Amsterdam,Netherlands", "country_name": "Netherlands", "state_prov": "North Holland", "city": "Amsterdam", "locality": "", "latitude": "52.37308", "longitude": "4.89245", "elevation": "0", "timezone": "Europe/Amsterdam", "timezone_abbreviation": "GMT+1" }, "forecast": { "2025-11-11": { "daily": { "timestamp": "2025-11-11", "river_discharge": 0.12, "river_discharge_mean": 0.12, "river_discharge_median": 0.12, "river_discharge_max": 0.12, "river_discharge_min": 0.12, "river_discharge_p25": 0.12, "river_discharge_p75": 0.12 } }, "2025-11-12": { "daily": { "timestamp": "2025-11-12", "river_discharge": 0.2, "river_discharge_mean": 0.21, "river_discharge_median": 0.2, "river_discharge_max": 0.37, "river_discharge_min": 0.12, "river_discharge_p25": 0.18, "river_discharge_p75": 0.25 } } } }curl -X 'GET' 'https://api.apifreaks.com/v1.0/weather/flood?location=Amsterdam,Netherlands&startDate=2025-11-11&endDate=2025-11-12&apiKey=API-KEY'
Example using Coordinates
Use the lat and long parameters to retrieve Flood Forecast for any point on Earth.
# Response { "location": { "latitude": "48.85660", "longitude": "2.35220", "country_name": "", "state_prov": "Île-de-France", "city": "Paris", "locality": "", "elevation": "0", "timezone": "Europe/Paris", "timezone_abbreviation": "GMT+1" }, "forecast": { "2025-11-11": { "daily": { "timestamp": "2025-11-11", "river_discharge": 1.11, "river_discharge_mean": 1.11, "river_discharge_median": 1.11, "river_discharge_max": 1.11, "river_discharge_min": 1.11, "river_discharge_p25": 1.11, "river_discharge_p75": 1.11 } }, "2025-11-12": { "daily": { "timestamp": "2025-11-12", "river_discharge": 1.2, "river_discharge_mean": 1.26, "river_discharge_median": 1.18, "river_discharge_max": 1.99, "river_discharge_min": 1.1, "river_discharge_p25": 1.12, "river_discharge_p75": 1.3 } } } }curl -X 'GET' 'https://api.apifreaks.com/v1.0/weather/flood?lat=48.8566&long=2.3522&startDate=2025-11-11&endDate=2025-11-12&apiKey=API-KEY'
Example using IP
Use the ip parameter to display Flood Forecast information at specific network locations.
# Response { "location": { "continent_code": "NA", "continent_name": "North America", "country_code2": "US", "country_code3": "USA", "country_name": "United States", "country_name_official": "United States of America", "is_eu": false, "state_prov": "California", "state_code": "US-CA", "district": "Santa Clara", "city": "Mountain View", "zipcode": "94043-1351", "latitude": "37.42240", "longitude": "-122.08421", "locality": "Charleston Terrace", "elevation": "3", "timezone": "America/Los_Angeles", "timezone_abbreviation": "GMT-8" }, "forecast": { "2025-11-11": { "daily": { "timestamp": "2025-11-11", "river_discharge": 5.59, "river_discharge_mean": 5.59, "river_discharge_median": 5.59, "river_discharge_max": 5.61, "river_discharge_min": 5.58, "river_discharge_p25": 5.59, "river_discharge_p75": 5.59 } }, "2025-11-12": { "daily": { "timestamp": "2025-11-12", "river_discharge": 5.59, "river_discharge_mean": 5.59, "river_discharge_median": 5.58, "river_discharge_max": 5.7, "river_discharge_min": 5.52, "river_discharge_p25": 5.56, "river_discharge_p75": 5.62 } } } }curl -X 'GET' https://api.apifreaks.com/v1.0/weather/flood?ip=8.8.8.8&startDate=2025-11-11&endDate=2025-11-12&apiKey=API-KEY'
Auto-detect requesting users' IP address
If no location, IP, or coordinates are provided, the API automatically detects the requesting machine’s IP and returns daily flood data for that location.
# Response { "location": { "continent_code": "AS", "continent_name": "Asia", "country_code2": "PK", "country_code3": "PAK", "country_name": "Pakistan", "country_name_official": "Islamic Republic of Pakistan", "is_eu": false, "state_prov": "Punjab", "state_code": "PK-PB", "district": "Lahore", "city": "Lahore", "zipcode": "54000", "latitude": "31.52037", "longitude": "74.35875", "locality": "Gulberg", "elevation": "", "timezone": "Asia/Karachi", "timezone_abbreviation": "GMT+5" }, "forecast": { "2025-11-11": { "daily": { "timestamp": "2025-11-11", "river_discharge": 0.23, "river_discharge_mean": 0.23, "river_discharge_median": 0.23, "river_discharge_max": 0.23, "river_discharge_min": 0.23, "river_discharge_p25": 0.23, "river_discharge_p75": 0.23 } }, "2025-11-12": { "daily": { "timestamp": "2025-11-12", "river_discharge": 0.23, "river_discharge_mean": 0.23, "river_discharge_median": 0.23, "river_discharge_max": 0.23, "river_discharge_min": 0.23, "river_discharge_p25": 0.23, "river_discharge_p75": 0.23 } } } }curl -X 'GET' 'https://api.apifreaks.com/v1.0/weather/flood?&startDate=2025-11-11&endDate=2025-11-12&apiKey=API-KEY'
Pricing
To use the Flood Forecast API, API credits are required. Charges apply only for successful queries, defined by a 2xx status code. If a request results in a 4xx or 5xx status code, no credits will be deducted, and any credits already charged will be refunded.
For each successful request, 2 credit will be charged. Utilize the Credits Usage API to efficiently monitor your recent consumption of both one-off and subscription credits. This API provides a streamlined way to track and manage your credit usage, ensuring you stay informed about your remaining balance and can optimize your resource allocation effectively.