# USGS Water Data

> Read the U.S. Geological Survey's water data for thousands of rivers, streams, lakes and wells across the United States: find monitoring sites, get the latest streamflow, water level and water temperature, read readings and daily values for any period, compare today with what is normal for the date, check gages against nearby flood levels, and get groundwater levels, water quality samples and river camera images. No account or API key required.

App · 19 actions. Web page: https://docs.lodol.com/docs/integrations/usgs-water-data

## Actions

### Check flood levels

Compare a gage's latest water level with the places nearby that USGS has surveyed as flooding at a set level (roads, bridges, boat ramps, buildings): which are flooding, and how far the water must rise to reach the next one. Says so when a gage has no surveyed places.

**Inputs**

- Site number (`site_number`, text, required): The gage's USGS site number. 'Find places flooding now' lists gages with surveyed places.

**Outputs**

- `count` (number): How many places are listed.
- `flooding` (true/false): True when at least one place is flooding.
- `flooding_count` (number): How many places are flooding.
- `found` (true/false): True when USGS has surveyed flood levels for this gage.
- `latest_time` (text): When the latest water level was taken.
- `latest_value` (number): The latest water level.
- `locations` (list): The places, lowest level first.
- `next_impact_level` (number): The level at which that place floods.
- `next_impact_name` (text): The lowest place not yet flooding.
- `parameter_code` (text): The code of the water level compared (00065 is gage height).
- `provisional` (true/false): True when the value is provisional: recent data USGS has not reviewed yet, which may still be revised.
- `rise_to_next_impact` (number): How far the water must rise to reach that place, in the gage's units.
- `site_id` (text): The site's full id: the agency, a dash and the site number (USGS-01646500).
- `site_name` (text): The gage's name.
- `site_number` (text): The site number, 8 to 15 digits (01646500).
- `unit` (text): The unit the values are in (ft³/s, ft, °C).
- `url` (text): The site's page on USGS Water Data for the Nation.

**Example output**

```json
{
  "count": 3,
  "flooding": false,
  "flooding_count": 0,
  "found": true,
  "latest_time": "2026-10-22T08:45:00Z",
  "latest_value": 4.54,
  "locations": [
    {
      "difference": -4.46,
      "flooding": false,
      "id": 19518,
      "impact_statement": "Water floods the boat ramp beneath SR-93 in Grady County.",
      "latitude": 30.791743,
      "level": 9,
      "longitude": -84.154767,
      "name": "Boat Ramp",
      "nws_id": "TMLG1",
      "source": "National Weather Service",
      "unit": "ft"
    },
    {
      "difference": -7.46,
      "flooding": false,
      "id": 19528,
      "impact_statement": "Water approaches the top of the boat ramp south of US-19 in Thomas County.",
      "latitude": 30.925891,
      "level": 12,
      "longitude": -83.999433,
      "name": "Boat Ramp 2",
      "nws_id": "TMLG1",
      "source": "National Weather Service",
      "unit": "ft"
    },
    {
      "difference": -7.89,
      "flooding": false,
      "id": 19527,
      "impact_statement": "Top of left bank",
      "latitude": 30.875694,
      "level": 12.43,
      "longitude": -84.046583,
      "name": "BANK",
      "nws_id": "TMLG1",
      "source": "USGS",
      "unit": "ft"
    }
  ],
  "next_impact_level": 9,
  "next_impact_name": "Boat Ramp",
  "parameter_code": "00065",
  "provisional": true,
  "rise_to_next_impact": 4.46,
  "site_id": "USGS-02327500",
  "site_name": "OCHLOCKONEE RIVER NEAR THOMASVILLE, GA",
  "site_number": "02327500",
  "unit": "ft",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-02327500/"
}
```

### Compare to normal

Compare a site's latest reading with the same day of the year in every past year on record: the typical (median) value, the record low and high, where today falls as a percentile, and a plain answer such as Below normal or Much above normal.

**Inputs**

- Site number (`site_number`, text, required): The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
- Measurement (`parameter_code`, text): What to compare. Pick from what the site measures (type the site number first), or type a 5-digit parameter code. Defaults to discharge (00060). Default: `00060`.

**Outputs**

- `compared` (true/false): True when there was both a latest reading and a long-term record for this day to compare it with.
- `condition` (text): The reading in words, using USGS's classes: Much below normal, Below normal, Normal, Above normal, Much above normal, or a record.
- `day_of_year` (text): The calendar day compared (MM-DD).
- `latest_time` (text): When the latest reading was taken.
- `latest_value` (number): The latest reading.
- `normal_maximum` (number): The highest daily mean ever recorded on this day.
- `normal_mean` (number): The average of the daily means for this day of year.
- `normal_median` (number): The median daily mean for this day of year.
- `normal_minimum` (number): The lowest daily mean ever recorded on this day.
- `note` (text): Why no comparison was made, when it was not.
- `parameter_code` (text): USGS's 5-digit code for what is measured (00060 is discharge).
- `parameter_name` (text): What is measured, in USGS's words (Discharge).
- `percent_of_median` (number): The latest reading as a percentage of the median.
- `percentile_rank` (number): Where the latest reading falls among past years on this day, 0 to 100 (estimated between the published percentiles).
- `percentiles` (object): Percentiles of the daily means for this day of year.
- `provisional` (true/false): True when the value is provisional: recent data USGS has not reviewed yet, which may still be revised.
- `site_id` (text): The site's full id: the agency, a dash and the site number (USGS-01646500).
- `site_number` (text): The site number, 8 to 15 digits (01646500).
- `unit` (text): The unit the values are in (ft³/s, ft, °C).
- `url` (text): The site's page on USGS Water Data for the Nation.
- `years_of_record` (number): How many years of approved data the normals come from.

**Example output**

```json
{
  "compared": true,
  "condition": "Normal",
  "day_of_year": "10-22",
  "latest_time": "2026-10-22T08:50:00Z",
  "latest_value": 4360,
  "normal_maximum": 53700,
  "normal_mean": 5529.43,
  "normal_median": 2565,
  "normal_minimum": 687,
  "note": null,
  "parameter_code": "00060",
  "parameter_name": "Discharge (streamflow)",
  "percent_of_median": 170,
  "percentile_rank": 75.1,
  "percentiles": {
    "p10": 1174,
    "p25": 1680,
    "p5": 958.4,
    "p75": 4317.5,
    "p90": 15030,
    "p95": 29080
  },
  "provisional": true,
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "unit": "ft\u00b3/s",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/",
  "years_of_record": 96
}
```

### Find monitoring sites

Find USGS monitoring sites (river gages, lakes, wells, springs, weather stations) by state, county, type, what they measure, name or map area. Each site comes with its number, location, what it measures and a link to its page. By default only sites reporting real-time data are listed.

**Inputs**

- State (`state`, text): The state or territory to search. Leave empty to search by name or map area only. One of: `AL` (Alabama), `AK` (Alaska), `AS` (American Samoa), `AZ` (Arizona), `AR` (Arkansas), `CA` (California), `CO` (Colorado), `CT` (Connecticut), `DE` (Delaware), `DC` (District of Columbia), and 46 more.
- County (`county`, text): Only sites in this county of the state. Leave empty for the whole state.
- Site type (`site_type`, text): Only this kind of site. Leave empty for every kind. One of: `ST` (Stream or river), `ST-TS` (Tidal stream), `ST-CA` (Canal), `ST-DCH` (Ditch), `LK` (Lake or reservoir), `ES` (Estuary), `OC` (Ocean), `OC-CO` (Coastal ocean), `WE` (Wetland), `SP` (Spring), and 4 more.
- Measures (`parameter_code`, text): Only sites that measure this. Pick a common one or type a 5-digit parameter code. Leave empty for sites measuring anything.
- Name contains (`name`, text): Only sites whose name contains these words, for example a river's name.
- Map area (`bounding_box`, text): Only sites inside this box: west, south, east, north in decimal degrees.
- Which sites (`activity`, text): Sites reporting now have real-time sensors with data from the last 7 days. Choose all sites to include ones that stopped years ago. One of: `real_time` (Sites reporting now (real-time sensors)), `recent` (Sites with any data in the last year), `any` (All sites, including discontinued ones). Default: `real_time`.
- Number of sites (`limit`, number): The most sites to list. Defaults to 50. From 1 to 1000. Default: `50`.

**Outputs**

- `count` (number): How many sites are listed.
- `searched` (text): What was searched for, in words.
- `sites` (list): The sites found, sorted by name.
- `truncated` (true/false): True when more sites matched than were listed: narrow the search or raise the number of sites.

**Example output**

```json
{
  "count": 2,
  "searched": "sites reporting now, stream or river, measuring Discharge (streamflow), county 031, in Maryland",
  "sites": [
    {
      "agency": "USGS",
      "county": "Montgomery County",
      "distance_miles": null,
      "drainage_area_sq_mi": 0.79,
      "huc": "020700080801",
      "last_data_time": "2026-10-22T06:00:00Z",
      "latitude": 39.2066111111111,
      "longitude": -77.2885833333333,
      "measures": [
        "Discharge (streamflow)"
      ],
      "name": "CABIN BRANCH NEAR BOYDS, MD",
      "parameter_codes": [
        "00060"
      ],
      "site_id": "USGS-01644380",
      "site_number": "01644380",
      "site_type": "Stream",
      "state": "Maryland",
      "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01644380/"
    },
    {
      "agency": "USGS",
      "county": "Montgomery County",
      "distance_miles": null,
      "drainage_area_sq_mi": 27,
      "huc": "020600060104",
      "last_data_time": "2026-10-22T07:45:00Z",
      "latitude": 39.174527777777776,
      "longitude": -77.02141666666667,
      "measures": [
        "Discharge (streamflow)"
      ],
      "name": "HAWLINGS RIVER NEAR SANDY SPRING, MD",
      "parameter_codes": [
        "00060"
      ],
      "site_id": "USGS-01591700",
      "site_number": "01591700",
      "site_type": "Stream",
      "state": "Maryland",
      "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01591700/"
    }
  ],
  "truncated": true
}
```

### Find places flooding now

List the places USGS has surveyed near its gages (roads, bridges, boat ramps, buildings) where the water is at or above their flood level right now, across the country or in one state.

**Inputs**

- State (`state`, text): Only this state. Leave empty for the whole country. One of: `AL` (Alabama), `AK` (Alaska), `AS` (American Samoa), `AZ` (Arizona), `AR` (Arkansas), `CA` (California), `CO` (Colorado), `CT` (Connecticut), `DE` (Delaware), `DC` (District of Columbia), and 46 more.

**Outputs**

- `count` (number): How many places are flooding.
- `places` (list): The places flooding now, by state and gage.
- `site_count` (number): How many gages they belong to.
- `site_numbers` (list): The gages with flooding places.
- `state` (text): The state searched, or empty for the whole country.

**Example output**

```json
{
  "count": 2,
  "places": [
    {
      "above_by": 0.84,
      "current_level": 5.84,
      "impact_statement": "The river has reached bankfull in places.",
      "latitude": 38.030651,
      "level": 5,
      "longitude": -108.109889,
      "name": "BANK",
      "nws_id": "SMPC2",
      "site_name": "SAN MIGUEL RIVER NEAR PLACERVILLE, CO",
      "site_number": "09172500",
      "state": null,
      "unit": "ft",
      "url": "https://waterdata.usgs.gov/monitoring-location/USGS-09172500/"
    },
    {
      "above_by": 0.88,
      "current_level": 60.88,
      "impact_statement": "Approximate bridge chord.",
      "latitude": 40.313749,
      "level": 60,
      "longitude": -124.283191,
      "name": "CHORD",
      "nws_id": "MTOC1",
      "site_name": "MATTOLE R NR PETROLIA CA",
      "site_number": "11469000",
      "state": "CA",
      "unit": "ft",
      "url": "https://waterdata.usgs.gov/monitoring-location/USGS-11469000/"
    }
  ],
  "site_count": 2,
  "site_numbers": [
    "09172500",
    "11469000"
  ],
  "state": null
}
```

### Find river cameras

List the public cameras at USGS sites in a state, each with the site it watches and a link to its newest image.

**Inputs**

- State (`state`, text, required): The state to list cameras in. One of: `AL` (Alabama), `AK` (Alaska), `AS` (American Samoa), `AZ` (Arizona), `AR` (Arkansas), `CA` (California), `CO` (Colorado), `CT` (Connecticut), `DE` (Delaware), `DC` (District of Columbia), and 46 more.
- Name contains (`name`, text): Only cameras whose name contains these words, such as a river's name.

**Outputs**

- `cameras` (list): The cameras, sorted by name.
- `count` (number): How many cameras are listed.
- `state` (text): The state searched (two-letter code).

**Example output**

```json
{
  "cameras": [
    {
      "camera_id": "MD_Beaverdam_Creek_near_Cheverly",
      "description": "Beaverdam Creek near Cheverly, MD",
      "latitude": 38.91630556,
      "longitude": -76.9343056,
      "name": "Beaverdam Creek near Cheverly",
      "newest_image_small_url": "https://usgs-nims-images.s3.amazonaws.com/720/MD_Beaverdam_Creek_near_Cheverly/MD_Beaverdam_Creek_near_Cheverly_newest.jpg",
      "newest_image_time": "2026-10-21T14:00:03Z",
      "newest_image_url": "https://usgs-nims-images.s3.amazonaws.com/overlay/MD_Beaverdam_Creek_near_Cheverly/MD_Beaverdam_Creek_near_Cheverly_newest.jpg",
      "newest_thumbnail_url": "https://usgs-nims-images.s3.amazonaws.com/thumbnail/MD_Beaverdam_Creek_near_Cheverly/MD_Beaverdam_Creek_near_Cheverly_newest.jpg",
      "site_number": "01651730",
      "state": "MD",
      "time_zone": "US/Eastern",
      "timelapse_url": "https://usgs-nims-images.s3.amazonaws.com/timelapse/MD_Beaverdam_Creek_near_Cheverly/MD_Beaverdam_Creek_near_Cheverly_720.mp4"
    }
  ],
  "count": 1,
  "state": "MD"
}
```

### Find sites near a location

Find USGS monitoring sites within a distance of a point, nearest first, with how far away each one is and what it measures.

**Inputs**

- Latitude (`latitude`, number, required): The point's latitude in decimal degrees (38.95). From -90 to 90.
- Longitude (`longitude`, number, required): The point's longitude in decimal degrees; west is negative (-77.13). From -180 to 180.
- Within (miles) (`radius_miles`, number): How far from the point to look. Defaults to 10 miles. From 0.1 to 100.0. Default: `10.0`.
- Site type (`site_type`, text): Only this kind of site. Leave empty for every kind. One of: `ST` (Stream or river), `ST-TS` (Tidal stream), `ST-CA` (Canal), `ST-DCH` (Ditch), `LK` (Lake or reservoir), `ES` (Estuary), `OC` (Ocean), `OC-CO` (Coastal ocean), `WE` (Wetland), `SP` (Spring), and 4 more.
- Measures (`parameter_code`, text): Only sites that measure this. Pick a common one or type a 5-digit parameter code. Leave empty for sites measuring anything.
- Which sites (`activity`, text): Sites reporting now have real-time sensors with data from the last 7 days. Choose all sites to include ones that stopped years ago. One of: `real_time` (Sites reporting now (real-time sensors)), `recent` (Sites with any data in the last year), `any` (All sites, including discontinued ones). Default: `real_time`.
- Number of sites (`limit`, number): The most sites to list, nearest first. Defaults to 25. From 1 to 1000. Default: `25`.

**Outputs**

- `count` (number): How many sites are listed.
- `latitude` (number): The latitude searched around.
- `longitude` (number): The longitude searched around.
- `radius_miles` (number): How far from the point was searched, in miles.
- `sites` (list): The sites found, nearest first.
- `truncated` (true/false): True when more sites matched than were listed: shrink the radius or raise the number of sites.

**Example output**

```json
{
  "count": 2,
  "latitude": 38.95,
  "longitude": -77.13,
  "radius_miles": 5.0,
  "sites": [
    {
      "agency": "USGS",
      "county": "Montgomery County",
      "distance_miles": 0.13,
      "drainage_area_sq_mi": 11560,
      "huc": "020700081005",
      "last_data_time": "2026-10-22T08:00:00Z",
      "latitude": 38.949777777777776,
      "longitude": -77.12763888888888,
      "measures": [
        "Discharge (streamflow)",
        "Dissolved oxygen",
        "Gage height (water level)",
        "Nitrate plus nitrite",
        "pH",
        "Specific conductance",
        "Stream water level (NAVD88)",
        "Turbidity",
        "Water temperature"
      ],
      "name": "POTOMAC RIVER NEAR WASH, DC LITTLE FALLS PUMP STA",
      "parameter_codes": [
        "00010",
        "00060",
        "00065",
        "00095",
        "00300",
        "00400",
        "63160",
        "63680",
        "99133"
      ],
      "site_id": "USGS-01646500",
      "site_number": "01646500",
      "site_type": "Stream",
      "state": "Maryland",
      "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/"
    },
    {
      "agency": "USGS",
      "county": "Fairfax County",
      "distance_miles": 2.55,
      "drainage_area_sq_mi": 2.05,
      "huc": "020700081005",
      "last_data_time": "2026-10-22T08:15:00Z",
      "latitude": 38.9597771566359,
      "longitude": -77.1756742556365,
      "measures": [
        "Autosampler count",
        "Discharge (streamflow)",
        "Dissolved oxygen",
        "Gage height (water level)",
        "pH",
        "Specific conductance",
        "Turbidity",
        "Water temperature"
      ],
      "name": "DEAD RUN AT WHANN AVENUE NEAR MCLEAN, VA",
      "parameter_codes": [
        "00010",
        "00060",
        "00065",
        "00095",
        "00300",
        "00400",
        "63680",
        "99234"
      ],
      "site_id": "USGS-01646305",
      "site_number": "01646305",
      "site_type": "Stream",
      "state": "Virginia",
      "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646305/"
    }
  ],
  "truncated": true
}
```

### Get annual peak flows

Get the highest discharge or gage height of each water year (October to September) on record, newest or largest first, with the record peak and notes such as dam regulation.

**Inputs**

- Site number (`site_number`, text, required): The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
- Peak of (`parameter_code`, text): Discharge or gage height. Defaults to discharge. One of: `00060` (Peak discharge (streamflow)), `00065` (Peak gage height (water level)). Default: `00060`.
- Order (`order`, text): Newest year first, or largest peak first. One of: `newest` (Newest year first), `largest` (Largest peak first). Default: `newest`.
- Number of peaks (`limit`, number): The most peaks to list. Defaults to 100. From 1 to 1000. Default: `100`.

**Outputs**

- `count` (number): How many peaks are listed.
- `parameter_code` (text): USGS's 5-digit code for what is measured (00060 is discharge).
- `parameter_name` (text): What is measured, in USGS's words (Discharge).
- `peaks` (list): The annual peaks, in the order asked for.
- `record_date` (text): The day of the highest peak on record.
- `record_value` (number): The highest peak on record.
- `record_water_year` (number): The water year of the highest peak on record.
- `site_id` (text): The site's full id: the agency, a dash and the site number (USGS-01646500).
- `site_number` (text): The site number, 8 to 15 digits (01646500).
- `url` (text): The site's page on USGS Water Data for the Nation.
- `years_on_record` (number): How many annual peaks USGS has.

**Example output**

```json
{
  "count": 2,
  "parameter_code": "00060",
  "parameter_name": "Discharge (streamflow)",
  "peaks": [
    {
      "date": "1936-03-19",
      "highest_since": 1889,
      "qualifiers": [],
      "time_of_day": null,
      "unit": "ft\u00b3/s",
      "value": 484000,
      "water_year": 1936
    },
    {
      "date": "1942-10-17",
      "highest_since": null,
      "qualifiers": [],
      "time_of_day": null,
      "unit": "ft\u00b3/s",
      "value": 447000,
      "water_year": 1943
    }
  ],
  "record_date": "1936-03-19",
  "record_value": 484000,
  "record_water_year": 1936,
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/",
  "years_on_record": 95
}
```

### Get daily values

Get a measurement's daily mean, minimum and maximum (or daily total, for precipitation) for a range of days, with the range's highest and lowest. Leave the dates empty for the last 30 days.

**Inputs**

- Site number (`site_number`, text, required): The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
- Measurement (`parameter_code`, text, required): What to read. Pick from what the site measures (type the site number first), or type USGS's 5-digit parameter code, such as 00060 for discharge.
- From (`start_date`, date): The first day. Leave empty for 30 days before the last day.
- To (`end_date`, date): The last day. Leave empty for today.

**Outputs**

- `any_provisional` (true/false): True when at least one value is provisional and may still be revised.
- `average` (number): The average of the daily means.
- `count` (number): How many days are listed.
- `days` (list): The days with values, oldest first.
- `end_date` (text): The last day asked for.
- `highest` (number): The highest daily value in the range.
- `highest_date` (text): The day of the highest value.
- `latest_date` (text): The newest day listed.
- `latest_value` (number): The newest day's mean (or its total, or maximum, when there is no mean).
- `lowest` (number): The lowest daily value in the range.
- `lowest_date` (text): The day of the lowest value.
- `parameter_code` (text): USGS's 5-digit code for what is measured (00060 is discharge).
- `parameter_name` (text): What is measured, in USGS's words (Discharge).
- `site_id` (text): The site's full id: the agency, a dash and the site number (USGS-01646500).
- `site_number` (text): The site number, 8 to 15 digits (01646500).
- `start_date` (text): The first day asked for.
- `truncated` (true/false): True when the range held more days than one request returns; the newest are listed.
- `unit` (text): The unit the values are in (ft³/s, ft, °C).
- `url` (text): The site's page on USGS Water Data for the Nation.

**Example output**

```json
{
  "any_provisional": true,
  "average": 17.214,
  "count": 2,
  "days": [
    {
      "date": "2026-10-15",
      "maximum": 19.6,
      "mean": 18.9,
      "median": null,
      "minimum": 18.4,
      "provisional": true,
      "qualifiers": [],
      "total": null
    },
    {
      "date": "2026-10-16",
      "maximum": 19.6,
      "mean": 18.8,
      "median": null,
      "minimum": 18.3,
      "provisional": true,
      "qualifiers": [],
      "total": null
    }
  ],
  "end_date": "2026-10-21",
  "highest": 19.6,
  "highest_date": "2026-10-15",
  "latest_date": "2026-10-21",
  "latest_value": 15.5,
  "lowest": 14.5,
  "lowest_date": "2026-10-21",
  "parameter_code": "00010",
  "parameter_name": "Water temperature",
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "start_date": "2026-10-15",
  "truncated": false,
  "unit": "\u00b0C",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/"
}
```

### Get field measurements

Get the values USGS hydrographers measured by hand on site visits, such as discharge and gage height, newest first, with how they were measured and how accurate they were rated.

**Inputs**

- Site number (`site_number`, text, required): The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
- Measurement (`parameter_code`, text): Only this measurement. Leave empty for all of them. One of: `00060` (Discharge (streamflow)), `00065` (Gage height (water level)).
- From (`start_date`, date): The first day to include. Leave empty for no start.
- To (`end_date`, date): The last day to include. Leave empty for up to today.
- Number of measurements (`limit`, number): The most measurements to list, newest first. Defaults to 50. From 1 to 1000. Default: `50`.

**Outputs**

- `count` (number): How many measurements are listed.
- `latest_time` (text): When the newest measurement was made.
- `measurements` (list): The measurements, newest first.
- `site_id` (text): The site's full id: the agency, a dash and the site number (USGS-01646500).
- `site_number` (text): The site number, 8 to 15 digits (01646500).
- `url` (text): The site's page on USGS Water Data for the Nation.
- `visit_count` (number): How many site visits they come from.

**Example output**

```json
{
  "count": 2,
  "latest_time": "2026-10-07T14:52:31Z",
  "measurements": [
    {
      "agency": "USGS",
      "control_condition": "Clear",
      "measurement_rating": "Fair",
      "method": null,
      "parameter_code": "00065",
      "parameter_name": "Gage height (water level)",
      "provisional": true,
      "qualifiers": [],
      "reading_type": "Mean gage height",
      "time": "2026-10-07T14:52:31Z",
      "unit": "ft",
      "value": 2.72,
      "visit_id": "0fa20b03-b359-453c-9f75-fc03f35dcb98"
    },
    {
      "agency": "USGS",
      "control_condition": "Clear",
      "measurement_rating": "Fair",
      "method": "Acoustic Doppler Current Profiler",
      "parameter_code": "00060",
      "parameter_name": "Discharge (streamflow)",
      "provisional": true,
      "qualifiers": [],
      "reading_type": "Discharge",
      "time": "2026-10-07T14:52:31Z",
      "unit": "ft\u00b3/s",
      "value": 1630,
      "visit_id": "0fa20b03-b359-453c-9f75-fc03f35dcb98"
    }
  ],
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/",
  "visit_count": 1
}
```

### Get groundwater levels

Get the water levels measured in a well, newest first: depth to water below the land surface and the water level's elevation, with how much it changed over the measurements listed.

**Inputs**

- Well site number (`site_number`, text, required): The well's USGS site number, usually 15 digits. Find wells with 'Find monitoring sites' and the site type Well.
- From (`start_date`, date): The first day to include. Leave empty for no start.
- To (`end_date`, date): The last day to include. Leave empty for up to today.
- Number of measurements (`limit`, number): The most measurements to list, newest first. Defaults to 100. From 1 to 1000. Default: `100`.

**Outputs**

- `change_ft` (number): The newest depth minus the oldest one listed: positive means the water level fell.
- `count` (number): How many measurements are listed.
- `deepest_depth_ft` (number): The largest depth to water listed (the lowest water level).
- `latest_depth_to_water_ft` (number): The newest depth to water, in feet.
- `latest_time` (text): When the newest measurement was made.
- `measurements` (list): The measurements, newest first.
- `shallowest_depth_ft` (number): The smallest depth to water listed (the highest water level).
- `site_id` (text): The site's full id: the agency, a dash and the site number (USGS-01646500).
- `site_number` (text): The site number, 8 to 15 digits (01646500).
- `url` (text): The site's page on USGS Water Data for the Nation.

**Example output**

```json
{
  "change_ft": 0.38,
  "count": 2,
  "deepest_depth_ft": 25.93,
  "latest_depth_to_water_ft": 25.93,
  "latest_time": "2026-09-23T10:56:00Z",
  "measurements": [
    {
      "agency": "USGS",
      "depth_to_water_ft": 25.93,
      "elevation_datum": "NAVD88",
      "method": "GW level, calib electric tape",
      "provisional": true,
      "qualifiers": [
        "Static"
      ],
      "time": "2026-09-23T10:56:00Z",
      "water_level_elevation_ft": 162.36
    },
    {
      "agency": "USGS",
      "depth_to_water_ft": 25.91,
      "elevation_datum": "NAVD88",
      "method": "GW level, calib electric tape",
      "provisional": true,
      "qualifiers": [
        "Static"
      ],
      "time": "2026-09-02T11:03:00Z",
      "water_level_elevation_ft": 162.38
    }
  ],
  "shallowest_depth_ft": 25.55,
  "site_id": "USGS-390151076561501",
  "site_number": "390151076561501",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-390151076561501/"
}
```

### Get latest readings

Get the newest reading of every sensor at a site, such as streamflow, gage height (water level) and water temperature, with when it was taken, whether it is provisional, and any notes such as ice. Streamflow, gage height and water temperature are also given on their own for easy use.

**Inputs**

- Site number (`site_number`, text, required): The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
- Measurement (`parameter_code`, text): Only this measurement. Leave empty for every sensor at the site.
- Include discontinued sensors (`include_discontinued`, true/false): Also list the last reading of sensors the site no longer runs. Default: `false`.

**Outputs**

- `any_provisional` (true/false): True when at least one value is provisional and may still be revised.
- `count` (number): How many readings are listed.
- `gage_height_ft` (number): The latest gage height (water level), in feet. Empty when the site does not measure it.
- `latest_time` (text): When the newest of the readings was taken.
- `readings` (list): The latest reading of each sensor at the site.
- `site_id` (text): The site's full id: the agency, a dash and the site number (USGS-01646500).
- `site_number` (text): The site number, 8 to 15 digits (01646500).
- `streamflow_cfs` (number): The latest discharge (streamflow), in cubic feet per second. Empty when the site does not measure it.
- `url` (text): The site's page on USGS Water Data for the Nation.
- `water_temperature_c` (number): The latest water temperature, in degrees Celsius. Empty when the site does not measure it.

**Example output**

```json
{
  "any_provisional": true,
  "count": 3,
  "gage_height_ft": 3.26,
  "latest_time": "2026-10-22T08:50:00Z",
  "readings": [
    {
      "approval_status": "Provisional",
      "current": true,
      "location_note": null,
      "parameter_code": "00060",
      "parameter_name": "Discharge (streamflow)",
      "provisional": true,
      "qualifiers": [],
      "time": "2026-10-22T08:50:00Z",
      "time_series_id": "66a4e3fb8abe42fcb0942b5c0fe98f68",
      "unit": "ft\u00b3/s",
      "value": 4360
    },
    {
      "approval_status": "Provisional",
      "current": true,
      "location_note": "From multiparameter sonde",
      "parameter_code": "00300",
      "parameter_name": "Dissolved oxygen",
      "provisional": true,
      "qualifiers": [],
      "time": "2026-10-22T08:50:00Z",
      "time_series_id": "bb18f3558934465194f8da1d5f1c3df3",
      "unit": "mg/L",
      "value": 10.3
    },
    {
      "approval_status": "Provisional",
      "current": true,
      "location_note": null,
      "parameter_code": "00065",
      "parameter_name": "Gage height (water level)",
      "provisional": true,
      "qualifiers": [],
      "time": "2026-10-22T08:50:00Z",
      "time_series_id": "8a83eb3a3cbc4087b0c201cf07c0c76d",
      "unit": "ft",
      "value": 3.26
    }
  ],
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "streamflow_cfs": 4360,
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/",
  "water_temperature_c": 15
}
```

### Get monthly or yearly statistics

Get the mean, median, minimum, maximum and percentiles of a measurement's daily values for each month, calendar year or water year in a range. Only reviewed (approved) data is counted, so the latest months may be missing.

**Inputs**

- Site number (`site_number`, text, required): The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
- Measurement (`parameter_code`, text): What to compare. Pick from what the site measures (type the site number first), or type a 5-digit parameter code. Defaults to discharge (00060). Default: `00060`.
- One row per (`interval`, text): Months, calendar years or water years. One of: `month` (Each month), `calendar_year` (Each calendar year (January to December)), `water_year` (Each water year (October to September)). Default: `month`.
- From (`start_date`, date): The first day of the range. Leave empty for a year before the end (ten years for yearly statistics).
- To (`end_date`, date): The last day of the range. Leave empty for today.

**Outputs**

- `count` (number): How many periods are listed.
- `end_date` (text): The last day asked for.
- `found` (true/false): True when USGS has statistics for the range.
- `interval` (text): The length of each period: month, calendar_year or water_year.
- `parameter_code` (text): USGS's 5-digit code for what is measured (00060 is discharge).
- `parameter_name` (text): What is measured, in USGS's words (Discharge).
- `periods` (list): One row per period, oldest first.
- `site_id` (text): The site's full id: the agency, a dash and the site number (USGS-01646500).
- `site_number` (text): The site number, 8 to 15 digits (01646500).
- `start_date` (text): The first day asked for.
- `unit` (text): The unit the values are in (ft³/s, ft, °C).
- `url` (text): The site's page on USGS Water Data for the Nation.

**Example output**

```json
{
  "count": 2,
  "end_date": "2024-09-30",
  "found": true,
  "interval": "water_year",
  "parameter_code": "00060",
  "parameter_name": "Discharge (streamflow)",
  "periods": [
    {
      "days": 365,
      "end_date": "2021-09-30",
      "label": "Water year 2021",
      "maximum": 89700,
      "mean": 10562.03,
      "median": 7290,
      "minimum": 1410,
      "p10": 2654,
      "p25": 3915,
      "p5": 2032,
      "p75": 12100,
      "p90": 19440,
      "p95": 31970,
      "start_date": "2020-10-01"
    },
    {
      "days": 365,
      "end_date": "2022-09-30",
      "label": "Water year 2022",
      "maximum": 102000,
      "mean": 8419.37,
      "median": 5600,
      "minimum": 1750,
      "p10": 2690,
      "p25": 3475,
      "p5": 2411,
      "p75": 9755,
      "p90": 14320,
      "p95": 20440,
      "start_date": "2021-10-01"
    }
  ],
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "start_date": "2020-10-01",
  "unit": "ft\u00b3/s",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/"
}
```

### Get readings for a time range

Get a sensor's readings (usually every 5 to 15 minutes) for a time range of up to 3 years, with the low, high, average and latest. Leave the times empty for the last 24 hours.

**Inputs**

- Site number (`site_number`, text, required): The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
- Measurement (`parameter_code`, text, required): What to read. Pick from what the site measures (type the site number first), or type USGS's 5-digit parameter code, such as 00060 for discharge.
- From (`start_time`, date and time): The start of the range. Leave empty for 24 hours before the end.
- To (`end_time`, date and time): The end of the range. Leave empty for now.
- Number of readings (`limit`, number): The most readings to return; when the range has more, the newest are kept. Defaults to 1000. From 1 to 10000. Default: `1000`.

**Outputs**

- `any_provisional` (true/false): True when at least one value is provisional and may still be revised.
- `change` (number): The newest reading minus the oldest one.
- `count` (number): How many readings are listed.
- `end` (text): The end of the time range (ISO 8601, UTC).
- `latest_time` (text): When the newest reading was taken.
- `latest_value` (number): The newest reading in the range.
- `maximum` (number): The highest reading in the range.
- `maximum_time` (text): When the highest reading was taken.
- `mean` (number): The average of the readings.
- `minimum` (number): The lowest reading in the range.
- `minimum_time` (text): When the lowest reading was taken.
- `parameter_code` (text): USGS's 5-digit code for what is measured (00060 is discharge).
- `parameter_name` (text): What is measured, in USGS's words (Discharge).
- `readings` (list): The readings, oldest first.
- `site_id` (text): The site's full id: the agency, a dash and the site number (USGS-01646500).
- `site_number` (text): The site number, 8 to 15 digits (01646500).
- `start` (text): The start of the time range (ISO 8601, UTC).
- `time_series_id` (text): USGS's id for the series read.
- `truncated` (true/false): True when the range held more readings than were asked for; the newest ones are listed.
- `unit` (text): The unit the values are in (ft³/s, ft, °C).
- `url` (text): The site's page on USGS Water Data for the Nation.

**Example output**

```json
{
  "any_provisional": true,
  "change": -60,
  "count": 3,
  "end": "2026-10-22T09:34:07Z",
  "latest_time": "2026-10-22T08:50:00Z",
  "latest_value": 4360,
  "maximum": 4420,
  "maximum_time": "2026-10-22T07:55:00Z",
  "mean": 4370,
  "minimum": 4360,
  "minimum_time": "2026-10-22T08:00:00Z",
  "parameter_code": "00060",
  "parameter_name": "Discharge (streamflow)",
  "readings": [
    {
      "provisional": true,
      "qualifiers": [],
      "time": "2026-10-22T07:55:00Z",
      "value": 4420
    },
    {
      "provisional": true,
      "qualifiers": [],
      "time": "2026-10-22T08:00:00Z",
      "value": 4360
    },
    {
      "provisional": true,
      "qualifiers": [],
      "time": "2026-10-22T08:05:00Z",
      "value": 4360
    }
  ],
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "start": "2026-10-21T09:34:07Z",
  "time_series_id": "66a4e3fb8abe42fcb0942b5c0fe98f68",
  "truncated": true,
  "unit": "ft\u00b3/s",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/"
}
```

### Get site camera images

Get the images from a site's public river camera: the newest one in three sizes, a time-lapse video when the camera makes one, and its recent images. Says so when the site has no camera.

**Inputs**

- Site number (`site_number`, text, required): The USGS site number. 'Find river cameras' lists the sites with one.
- Recent images (`recent_images`, number): How many recent images to list besides the newest. Defaults to 5. From 0 to 50. Default: `5`.

**Outputs**

- `cameras` (list): The site's cameras.
- `count` (number): How many cameras are listed.
- `has_camera` (true/false): True when the site has a public camera.
- `site_id` (text): The site's full id: the agency, a dash and the site number (USGS-01646500).
- `site_number` (text): The site number, 8 to 15 digits (01646500).
- `url` (text): The site's page on USGS Water Data for the Nation.

**Example output**

```json
{
  "cameras": [
    {
      "camera_id": "WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire",
      "description": "Chippewa River at Grand Ave at Eau Claire, WI",
      "latitude": 44.80959899,
      "longitude": -91.5029665,
      "name": "Chippewa River at Grand Ave at Eau Claire",
      "newest_image_small_url": "https://usgs-nims-images.s3.amazonaws.com/720/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire_newest.jpg",
      "newest_image_time": "2026-10-22T02:00:02Z",
      "newest_image_url": "https://usgs-nims-images.s3.amazonaws.com/overlay/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire_newest.jpg",
      "newest_thumbnail_url": "https://usgs-nims-images.s3.amazonaws.com/thumbnail/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire_newest.jpg",
      "recent_images": [
        {
          "small_url": "https://usgs-nims-images.s3.amazonaws.com/720/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire___2026-10-22T02-00-02Z.jpg",
          "thumbnail_url": "https://usgs-nims-images.s3.amazonaws.com/thumbnail/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire___2026-10-22T02-00-02Z.jpg",
          "time": "2026-10-22T02:00:02Z",
          "url": "https://usgs-nims-images.s3.amazonaws.com/overlay/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire___2026-10-22T02-00-02Z.jpg"
        },
        {
          "small_url": "https://usgs-nims-images.s3.amazonaws.com/720/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire___2026-10-22T01-00-02Z.jpg",
          "thumbnail_url": "https://usgs-nims-images.s3.amazonaws.com/thumbnail/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire___2026-10-22T01-00-02Z.jpg",
          "time": "2026-10-22T01:00:02Z",
          "url": "https://usgs-nims-images.s3.amazonaws.com/overlay/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire___2026-10-22T01-00-02Z.jpg"
        }
      ],
      "site_number": "05366800",
      "state": "WI",
      "time_zone": "US/Central",
      "timelapse_url": "https://usgs-nims-images.s3.amazonaws.com/timelapse/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire/WI_Chippewa_River_at_Grand_Ave_at_Eau_Claire_720.mp4"
    }
  ],
  "count": 1,
  "has_camera": true,
  "site_id": "USGS-05366800",
  "site_number": "05366800",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-05366800/"
}
```

### Get site details

Get a monitoring site's name, type, location, county and state, altitude, drainage area and watershed, and for a well its depth and aquifer. Says so when there is no such site.

**Inputs**

- Site number (`site_number`, text, required): The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.

**Outputs**

- `agency` (text): The agency that runs the site (USGS).
- `altitude_datum` (text): The vertical datum the altitude is measured from (NAVD88).
- `altitude_ft` (number): The height of the land surface or gage datum, in feet.
- `aquifer_code` (text): The local aquifer the well draws from (wells only).
- `aquifer_type` (text): Whether the aquifer is confined or unconfined (wells only).
- `construction_date` (text): When the well was built, as USGS records it.
- `contributing_drainage_area_sq_mi` (number): The part of the drainage area that actually feeds the stream, in square miles.
- `county` (text): The county the site is in.
- `drainage_area_sq_mi` (number): The land area draining to the site, in square miles.
- `found` (true/false): True when USGS has a site with this number.
- `hole_depth_ft` (number): How deep the hole was drilled, in feet (wells only).
- `huc` (text): The hydrologic unit code: the watershed the site is in.
- `latitude` (number): The site's latitude, in decimal degrees.
- `longitude` (number): The site's longitude, in decimal degrees.
- `name` (text): The site's name.
- `national_aquifer_code` (text): The principal aquifer the well draws from (wells only).
- `site_id` (text): The site's full id: the agency, a dash and the site number (USGS-01646500).
- `site_number` (text): The site number, 8 to 15 digits (01646500).
- `site_type` (text): What kind of place it is (Stream, Well, Lake).
- `state` (text): The state the site is in.
- `time_zone` (text): The site's standard time zone (EST).
- `url` (text): The site's page on USGS Water Data for the Nation.
- `uses_daylight_saving_time` (true/false): True when the site's local clock moves for daylight saving time.
- `well_depth_ft` (number): How deep the well was built, in feet (wells only).

**Example output**

```json
{
  "agency": "USGS",
  "altitude_datum": "NAVD88",
  "altitude_ft": 37.04,
  "aquifer_code": null,
  "aquifer_type": null,
  "construction_date": null,
  "contributing_drainage_area_sq_mi": null,
  "county": "Montgomery County",
  "drainage_area_sq_mi": 11560,
  "found": true,
  "hole_depth_ft": null,
  "huc": "020700081005",
  "latitude": 38.949777777777776,
  "longitude": -77.12763888888888,
  "name": "POTOMAC RIVER NEAR WASH, DC LITTLE FALLS PUMP STA",
  "national_aquifer_code": null,
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "site_type": "Stream",
  "state": "Maryland",
  "time_zone": "EST",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/",
  "uses_daylight_saving_time": true,
  "well_depth_ft": null
}
```

### Get typical values for the year

Get what is typical at a site for each day or month of the year, from its whole record: mean, median, record low and high, and percentiles, with how many years they cover.

**Inputs**

- Site number (`site_number`, text, required): The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
- Measurement (`parameter_code`, text): What to compare. Pick from what the site measures (type the site number first), or type a 5-digit parameter code. Defaults to discharge (00060). Default: `00060`.
- One row per (`period`, text): Days or months of the year. One of: `day_of_year` (Each day of the year), `month_of_year` (Each month of the year). Default: `day_of_year`.
- From (`start_date`, date): The first day or month to include; only its month and day are used. Leave both dates empty for the whole year.
- To (`end_date`, date): The last day or month to include; only its month and day are used.

**Outputs**

- `count` (number): How many rows are listed.
- `found` (true/false): True when USGS has statistics for this site and parameter.
- `normals` (list): One row per day or month, in calendar order.
- `parameter_code` (text): USGS's 5-digit code for what is measured (00060 is discharge).
- `parameter_name` (text): What is measured, in USGS's words (Discharge).
- `period` (text): Whether the rows are days of the year (day_of_year) or months (month_of_year).
- `site_id` (text): The site's full id: the agency, a dash and the site number (USGS-01646500).
- `site_number` (text): The site number, 8 to 15 digits (01646500).
- `time_series_id` (text): The daily series the statistics are computed from.
- `unit` (text): The unit the values are in (ft³/s, ft, °C).
- `url` (text): The site's page on USGS Water Data for the Nation.

**Example output**

```json
{
  "count": 2,
  "found": true,
  "normals": [
    {
      "label": "January",
      "maximum": 31000,
      "mean": 10593.85,
      "median": 9305,
      "minimum": 1380,
      "p10": 3101,
      "p25": 5500,
      "p5": 2271.5,
      "p75": 13750,
      "p90": 22490,
      "p95": 26525,
      "period": "01",
      "years": 96
    },
    {
      "label": "February",
      "maximum": 53450,
      "mean": 13295.99,
      "median": 11675,
      "minimum": 1785,
      "p10": 5029,
      "p25": 7331.25,
      "p5": 3651,
      "p75": 17312.5,
      "p90": 24275,
      "p95": 29190,
      "period": "02",
      "years": 96
    }
  ],
  "parameter_code": "00060",
  "parameter_name": "Discharge (streamflow)",
  "period": "month_of_year",
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "time_series_id": "2cf409b0d9694c01828f5d4ff14586a5",
  "unit": "ft\u00b3/s",
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/"
}
```

### Get water quality samples

Get the results of water samples taken at a site and analysed in the field or a lab, such as nutrients, metals, bacteria or pesticides, newest first, with units and whether each result is final. Leave the dates empty for the last year.

**Inputs**

- Site number (`site_number`, text, required): The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
- Kind of result (`group`, text): Only results of this kind. Leave empty for all. One of: `Physical`, `Nutrient`, `Inorganics, Major, Metals`, `Inorganics, Major, Non-metals`, `Inorganics, Minor, Metals`, `Inorganics, Minor, Non-metals`, `Microbiological`, `Biological`, `Organics, Pesticide`, `Organics, PCBs`, and 6 more.
- Parameter code (`parameter_code`, text): Only results with this 5-digit USGS parameter code. Leave empty for all.
- From (`start_date`, date): The first day to include. Leave empty for a year before the last day.
- To (`end_date`, date): The last day to include. Leave empty for up to today.
- Number of results (`limit`, number): The most results to list, newest first. Defaults to 100. From 1 to 1000. Default: `100`.

**Outputs**

- `characteristics` (list): Each characteristic among the results, once.
- `count` (number): How many results are listed.
- `end_date` (text): The last day searched.
- `results` (list): The results, newest sample first.
- `sample_count` (number): How many samples the results come from.
- `site_id` (text): The site's full id: the agency, a dash and the site number (USGS-01646500).
- `site_number` (text): The site number, 8 to 15 digits (01646500).
- `start_date` (text): The first day searched.
- `truncated` (true/false): True when more results matched than were listed.
- `url` (text): The site's page on USGS Water Data for the Nation.

**Example output**

```json
{
  "characteristics": [
    "Inorganic nitrogen (nitrate and nitrite)"
  ],
  "count": 2,
  "end_date": "2025-12-31",
  "results": [
    {
      "characteristic": "Inorganic nitrogen (nitrate and nitrite)",
      "date": "2025-09-30",
      "detection": null,
      "fraction": "Filtered field and/or lab",
      "group": "Nutrient",
      "method": "NO3+NO2, wf, FCC,NaR, DA",
      "parameter_code": "00631",
      "sample_id": "e48f5f73-a566-4c52-a5a1-2e918aa8960f",
      "status": "Accepted",
      "time": "10:00:00",
      "time_zone": "EST",
      "unit": "mg/L",
      "value": 0.634,
      "value_text": "0.634"
    },
    {
      "characteristic": "Inorganic nitrogen (nitrate and nitrite)",
      "date": "2025-06-26",
      "detection": null,
      "fraction": "Filtered field and/or lab",
      "group": "Nutrient",
      "method": "NO3+NO2, wf, FCC,NaR, DA",
      "parameter_code": "00631",
      "sample_id": "06062484-ae7f-458d-a36d-8271a573eccc",
      "status": "Accepted",
      "time": "09:45:00",
      "time_zone": "EST",
      "unit": "mg/L",
      "value": 0.889,
      "value_text": "0.889"
    }
  ],
  "sample_count": 2,
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "start_date": "2025-01-01",
  "truncated": false,
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/"
}
```

### List what a site measures

List everything a site records: each measurement, whether it is real-time readings, daily values or annual peaks, since when, and whether it is still recorded.

**Inputs**

- Site number (`site_number`, text, required): The USGS site number, 8 to 15 digits. 'Find monitoring sites' finds one, and it is in the address of the site's page on waterdata.usgs.gov.
- Include discontinued (`include_discontinued`, true/false): Also list measurements the site no longer records. Default: `false`.

**Outputs**

- `active_count` (number): How many of them are still recorded.
- `count` (number): How many series are listed.
- `found` (true/false): True when the site records any series.
- `parameters` (list): Each thing the site still measures, once.
- `site_id` (text): The site's full id: the agency, a dash and the site number (USGS-01646500).
- `site_number` (text): The site number, 8 to 15 digits (01646500).
- `time_series` (list): The site's series, active ones first.
- `url` (text): The site's page on USGS Water Data for the Nation.

**Example output**

```json
{
  "active_count": 3,
  "count": 3,
  "found": true,
  "parameters": [
    {
      "code": "00060",
      "name": "Discharge (streamflow)",
      "unit": "ft\u00b3/s"
    },
    {
      "code": "00065",
      "name": "Gage height (water level)",
      "unit": "ft"
    }
  ],
  "site_id": "USGS-01646500",
  "site_number": "01646500",
  "time_series": [
    {
      "active": true,
      "begin": "1972-06-09T05:00:00Z",
      "data_type": "Continuous",
      "end": "2026-10-22T07:50:00Z",
      "location_note": null,
      "parameter_code": "00060",
      "parameter_description": "Discharge, cubic feet per second",
      "parameter_name": "Discharge (streamflow)",
      "primary": true,
      "statistic": "Instantaneous",
      "time_series_id": "66a4e3fb8abe42fcb0942b5c0fe98f68",
      "unit": "ft\u00b3/s"
    },
    {
      "active": true,
      "begin": "1930-03-01T05:00:00Z",
      "data_type": "Daily",
      "end": "2026-10-20T04:00:00Z",
      "location_note": null,
      "parameter_code": "00060",
      "parameter_description": "Discharge, cubic feet per second",
      "parameter_name": "Discharge (streamflow)",
      "primary": true,
      "statistic": "Mean",
      "time_series_id": "2cf409b0d9694c01828f5d4ff14586a5",
      "unit": "ft\u00b3/s"
    },
    {
      "active": true,
      "begin": "2007-10-01T05:00:00Z",
      "data_type": "Continuous",
      "end": "2026-10-22T07:50:00Z",
      "location_note": null,
      "parameter_code": "00065",
      "parameter_description": "Gage height, feet",
      "parameter_name": "Gage height (water level)",
      "primary": true,
      "statistic": "Instantaneous",
      "time_series_id": "8a83eb3a3cbc4087b0c201cf07c0c76d",
      "unit": "ft"
    }
  ],
  "url": "https://waterdata.usgs.gov/monitoring-location/USGS-01646500/"
}
```

### Look up parameter codes

Find the 5-digit codes USGS uses for what it measures, by code, by words in their name or description, or by group, with the unit each is reported in.

**Inputs**

- Search for (`search`, text): A code, or words such as nitrate or temperature.
- Group (`group`, text): Only codes in this group. Leave empty for any group. One of: `PHY` (Physical), `NUT` (Nutrient), `INM` (Inorganics, Major, Metals), `INN` (Inorganics, Major, Non-metals), `IMM` (Inorganics, Minor, Metals), `IMN` (Inorganics, Minor, Non-metals), `MBI` (Microbiological), `BIO` (Biological), `OPE` (Organics, Pesticide), `OPC` (Organics, PCBs), and 7 more.
- Number of codes (`limit`, number): The most codes to list. Defaults to 50. From 1 to 1000. Default: `50`.

**Outputs**

- `count` (number): How many codes are listed.
- `group` (text): The group searched.
- `parameters` (list): The parameter codes found, by code.
- `search` (text): The text searched for.
- `total` (number): How many codes matched in all.
- `truncated` (true/false): True when more codes matched than were listed.

**Example output**

```json
{
  "count": 2,
  "group": null,
  "parameters": [
    {
      "code": "00600",
      "description": "Total nitrogen [nitrate + nitrite + ammonia + organic-N], water, unfiltered, milligrams per liter",
      "group": "Nutrient",
      "medium": "Water",
      "name": "Total nitrogen, wu",
      "unit": "mg/l"
    },
    {
      "code": "00601",
      "description": "Total nitrogen [nitrate + nitrite + ammonia + organic-N], suspended sediment, milligrams per liter",
      "group": "Nutrient",
      "medium": "Water",
      "name": "Total nitrogen, ss",
      "unit": "mg/l"
    }
  ],
  "search": "nitrate",
  "total": 79,
  "truncated": true
}
```
