Flood Forecasting API
Stay organized with collections
Save and categorize content based on your preferences.
The Flood Forecasting API provides an interface to access real time riverine flood forecasts, which is also available on the Flood Hub.
For historical data, refer to our publicly available datasets:
For more details about the research and publications underlying the datasets, visit our website. The data exposed by this API is under the CC BY 4.0 license and offered at no charge.
API access
To get started, fill out the waitlist form
to join the waiting list. Once approved, we'll send you an email. If you've already received your approval email, reply to it with your Google Cloud Project ID (more details below).
The Flood Forecasting API is public and offered at no charge. Accessing the Flood Forecasting API requires an API key and enabling the Flood Forecasting API.
Once you have an API key and have enabled the Flood Forecasting API, you can verify API access by running this colab notebook.
API keys
If you use Google Cloud or other Google Developer services, you can use those existing API keys
or make a new one.
If you don't have any Google API keys, you will need to:
- Create a Google Cloud Account
- Create an API key
Enable Flood Forecasting API
To enable the Flood Forecasting API, navigate to the
Flood Forecasting API page
and click the Enable button.If you cannot access this page, it likely means you have not yet
been added as a Service Consumer. First, verify that you are logged in with the
correct email address you provided to us. If you are using the correct email address and
still lack access, reply to your approval email for assistance.
For more general information about enabling APIs, see this guide.
Coverage
The API provides access to Google's flood forecasts for the following countries (represented in ISO-3166-1 Alpha-2): AO, AR, AT, AU, AZ, BD, BE, BF, BG, BO, BR, BW, BY, BZ, CA, CD, CF, CG, CH, CI, CL, CM, CO, CR, CZ, DE, DK, EC, EE, ES, FI, FR, GB, GE, GH, GM, GN, GR, GT, GW, GY, HN, HU, ID, IE, IN, IS, IT, KE, KG, KH, KZ, LA, LK, LR, LS, LT, LV, MD, MG, ML, MM, MW, MX, MY, MZ, NA, NG, NI, NL, NO, NP, NZ, PE, PG, PH, PK, PL, PT, PY, RO, RS, RW, SE, SI, SK, SL, SN, SO, SR, SS, TD, TH, TJ, TR, UA, US, UY, UZ, VE, VN, ZA, ZM, ZW.
Feedback
If you find any issue or bug, submit this bug form. Make sure to include a concise description of the issue, a clear way to reproduce it, and the expected behavior. For feature requests and general feedback, fill this feedback form.
As a part of the pilot, the flood forecasting team will be meeting with participants that want to share feedback, use cases or need support in implementation. Reply to your approval email if you would like to set a meeting with the team.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-30 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-30 UTC."],[[["\u003cp\u003eThe Flood Forecasting API is publicly available and free to use.\u003c/p\u003e\n"],["\u003cp\u003eAccess to the API requires an API key and enabling the Flood Forecasting API.\u003c/p\u003e\n"],["\u003cp\u003eExisting Google Cloud or Google Developer API keys can be utilized, or new ones can be created.\u003c/p\u003e\n"],["\u003cp\u003eTo enable the Flood Forecasting API, navigate to the APIs & Services page and follow the provided instructions.\u003c/p\u003e\n"]]],[],null,["# Flood Forecasting API\n\nThe Flood Forecasting API provides an interface to access real time riverine flood forecasts, which is also available on the [Flood Hub](https://g.co/floodhub/).\n\n\u003cbr /\u003e\n\n\nFor historical data, refer to our publicly available datasets:\n\n- [Inundation History dataset](https://console.cloud.google.com/storage/browser/flood-forecasting/inundation_history) which contains information on water occurancy around the world (1999 - 2020)\n- [Google Runoff Reanalysis \\& Reforecast dataset (GRRR)](https://colab.research.google.com/drive/1FnXXSEQqU1TJhMPiNeWUTr9LnbJwZzMm?usp=sharing#scrollTo=UTbokLLWp_9o) global river discharge estimates (1980-2023)\n\nFor more details about the research and publications underlying the datasets, visit our [website](https://sites.research.google/gr/floodforecasting/). The data exposed by this API is under the [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) license and offered at no charge.\n\nAPI access\n----------\n\nTo get started, fill out [the waitlist form](https://docs.google.com/forms/d/e/1FAIpQLSfcKhe3CHsncM-_NQ66zLheEfXKnNbDPBtuIT7BSYCqYkmOaA/viewform?usp=sharing&ouid=100051394225923850298)\nto join the waiting list. Once approved, we'll send you an email. If you've already received your approval email, reply to it with your **Google Cloud Project ID** (more details below).\n\n\u003cbr /\u003e\n\n\nThe Flood Forecasting API is public and offered at no charge. Accessing the Flood Forecasting API requires an API key and enabling the Flood Forecasting API.\n\n\u003cbr /\u003e\n\n\nOnce you have an API key and have enabled the Flood Forecasting API, you can verify API access by running this [colab notebook](https://colab.research.google.com/drive/1et0vjN9coLck11YhORyprgtOvCuaErVd?usp=sharing).\n\n\n#### API keys\n\nIf you use Google Cloud or other Google Developer services, you can use those existing API keys\nor make a new one.\n\n\nIf you don't have any Google API keys, you will need to:\n\n1. [Create a Google Cloud Account](https://cloud.google.com/resource-manager/docs/creating-managing-projects)\n2. [Create an API key](https://support.google.com/googleapi/answer/6158862)\n\n#### Enable Flood Forecasting API\n\nTo enable the Flood Forecasting API, navigate to the\n[Flood Forecasting API page](https://console.cloud.google.com/apis/library/floodforecasting.googleapis.com) and click the *Enable* button.If you cannot access this page, it likely means you have not yet\nbeen added as a Service Consumer. First, verify that you are logged in with the\ncorrect email address you provided to us. If you are using the correct email address and\nstill lack access, reply to your approval email for assistance.\n\nFor more general information about enabling APIs, see this [guide](https://support.google.com/googleapi/answer/6158841).\n\nCoverage\n--------\n\nThe API provides access to Google's flood forecasts for the following countries (represented in [ISO-3166-1 Alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1)): AO, AR, AT, AU, AZ, BD, BE, BF, BG, BO, BR, BW, BY, BZ, CA, CD, CF, CG, CH, CI, CL, CM, CO, CR, CZ, DE, DK, EC, EE, ES, FI, FR, GB, GE, GH, GM, GN, GR, GT, GW, GY, HN, HU, ID, IE, IN, IS, IT, KE, KG, KH, KZ, LA, LK, LR, LS, LT, LV, MD, MG, ML, MM, MW, MX, MY, MZ, NA, NG, NI, NL, NO, NP, NZ, PE, PG, PH, PK, PL, PT, PY, RO, RS, RW, SE, SI, SK, SL, SN, SO, SR, SS, TD, TH, TJ, TR, UA, US, UY, UZ, VE, VN, ZA, ZM, ZW.\n\nFeedback\n--------\n\nIf you find any issue or bug, submit this [bug form](https://docs.google.com/forms/d/e/1FAIpQLSekz7lXXGh5AS2lpGK-jdI3w0CdlXCzjbZlOmM3esCP1qtUSQ/viewform). Make sure to include a concise description of the issue, a clear way to reproduce it, and the expected behavior. For feature requests and general feedback, fill this [feedback form](https://docs.google.com/forms/d/e/1FAIpQLSdUcndasiipwf-Bb_Evv2flbnwWl4AgtgcHbiPJBTRYKupOWQ/viewform?usp=header_link).\nAs a part of the pilot, the flood forecasting team will be meeting with participants that want to share feedback, use cases or need support in implementation. Reply to your approval email if you would like to set a meeting with the team."]]