Loading
Loading
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.
Predict river behavior and flood risks up to 16 days in advance, helping mitigate potential disasters.
Access flood data for any location using location, latitude/longitude, or IP-based detection.
Get essential river-related metrics, including river discharge rates, flow percentiles, and gauge-derived data.
Each response includes complete geographic context with continent, country, state/province, district, city, locality, postal code, precise coordinates, elevation data, and timezone information.
$ 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)
You can request flood forecast data for a specific location, latitude/longitude, or IP address.
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'
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'
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'
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'
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.