# USGS API

> 3 public methods for USGS (usgs.gov), each 1 credit per completed run.

Unofficial. Not affiliated with or endorsed by USGS.

- Page: https://fous.com/methods/usgs.gov

## Methods

### [Search earthquakes near a place](https://fous.com/methods/earthquake.usgs.gov/search-earthquakes.md)

`earthquake.usgs.gov/search_earthquakes`, read. Finds recent USGS earthquakes near a city, address, or region, with distances and times in the searched place's time zone.

Returns: magnitude, location, times (UTC and local), depth, distance, tsunami flag, felt reports, alert level, USGS details link

### [List significant earthquakes](https://fous.com/methods/earthquake.usgs.gov/list-significant-earthquakes.md)

`earthquake.usgs.gov/list_significant_earthquakes`, read. Lists significant worldwide earthquakes for the past day, week, or month, newest first, with USGS PAGER alert levels and impact summaries when USGS provides them.

Returns: magnitude, location, time, alert level, tsunami flag, felt reports, estimated impact summary, coordinates, event ID, details link

### [Get river level](https://fous.com/methods/waterdata.usgs.gov/get-river-level.md)

`waterdata.usgs.gov/get_river_level`, read. Gets the latest water height, flow, 24-hour trend and flood-stage status at the active USGS river gauge best matching a river or town and state. Flood stage is null when not published; gauges without recent stage, flow or 24-hour history are not returned.

Returns: gauge name, town, state, water height, flow, observation time, 24-hour trend, flood stage, gauge link, site number, coordinates