usgs-riverdata is a Python package that exposes to the United State Geological Survey (USGS) waterdata api to python. The USGS Waterdata system contains hydrologic data for United States rivers and tributaries.
Import using
import usgs_riverdata
The core functionality of this library is the Gage class.
Initializing an object of this class requires a site code. Each USGS data source has unique location code used to retrive data. The default data length is 7 days, this is configurable using an ISO-8601 Duration format, as specifed here. Additional parameters are optional and specified here.
There are no outside dependencies. If Pandas is available, it will return data in a pandas.Dataframe.