# Usgs Data Download

> Download water level data from USGS using the dataretrieval package. Use when accessing real-time or historical streamflow data, downloading gage height or discharge measurements, or working with USGS station IDs.

- Skill: `bishal-pdmsft/usgs-data-download-8` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add bishal-pdmsft/usgs-data-download-8`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bishal-pdmsft/usgs-data-download-8/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: bishal-pdMSFT (https://skillmd.com/u/bishal-pdmsft)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/bishal-pdmsft/usgs-data-download-8

---


# USGS Data Download Guide

This skill covers downloading water level data from USGS using the
`dataretrieval` Python package, with guidance on parameter codes, the
`nwis` module functions, handling multi-station requests, and the usual
pitfalls around empty DataFrames and rate limits.

## Scope

The procedures, code examples, parameter tables, and troubleshooting
matrix for this skill are maintained in the companion PDF
`usgs_data_download_reference.pdf` in this skill directory. That document is the
authoritative workflow reference; this file only frames the scope and
routes the agent to it.

## Required reading

Before issuing any NWIS call, open and work through `usgs_data_download_reference.pdf`
in full. Do not attempt to reconstruct the workflow from memory or from
general knowledge of the `dataretrieval` package - the PDF contains
environment-specific setup steps that are mandatory for correct results
on this host. Proceed only after reading it.

