CTRL+K
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 requests
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
| startDate | Yes | string | - | Starting to fetch flood forecast data. Must follow YYYY-MM-DD format (e.g., 2025-08-25). |
| endDate | Yes | string | - | End date to fetch flood forecast data. Must follow YYYY-MM-DD format (e.g., 2025-08-25). |
| location | No | string | - | Specifies the target location. It can be a city name, place name, or a complete address (e.g., "Lahore", "Paris, France", "1600 Amphitheatre Parkway, Mountain View, CA"). |
| lat | No | float | - | Latitude of the target location. Must be used together with "long". |
| long | No | float | - | Longitude of the target location. Must be used together with "lat". |
| ip | No | string | Requester IP | IPv4 or IPv6 address used to infer location. Defaults to the requester’s public IP if not provided. |
| precision | No | string | daily | Only "daily" precision is supported, return flood forecast data for the selected date range. |
| timezone | No | string | Location’s timezone | Specifies the timezone for returned results. Defaults to the resolved location’s timezone. |
For a comprehensive view of the API response structure and detailed field descriptions, explore the interactive Response Table. For Flood Forecast API Test Page click here.
| HTTP Status | Reasons |
|---|---|
| 400 | (1) "lat" and "long" must be valid numbers.
(2) Latitude must be between -90 and 90; longitude must be between -180 and 180.
(3) "startDate" and "endDate" must be in YYYY-MM-DD format.
(4) "startDate" must be before or equal to "endDate".
(5) The date range between "startDate" and "endDate" must not exceed 16 days. |
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.