# WaterfallHikes.com

> A comprehensive directory of waterfall hikes across the United States.

WaterfallHikes.com indexes over 2,500 waterfalls in 50 U.S. states. Each waterfall entry includes trail details such as difficulty rating, trail length, elevation gain, and location coordinates. Waterfalls are organized by state, national/state park, and nearby city.

## Key Pages

- [Homepage](https://waterfallhikes.com/): Featured waterfalls and site-wide stats
- [All Waterfalls](https://waterfallhikes.com/waterfalls): Browse and filter the full directory
- [Browse by State](https://waterfallhikes.com/states): Waterfalls organized by U.S. state
- [Browse by Park](https://waterfallhikes.com/parks): Waterfalls in national and state parks
- [Easy Hikes](https://waterfallhikes.com/waterfalls/easy): Beginner-friendly waterfall trails
- [Moderate Hikes](https://waterfallhikes.com/waterfalls/moderate): Intermediate waterfall trails
- [Hard Hikes](https://waterfallhikes.com/waterfalls/hard): Challenging waterfall trails
- [Drive-Up Waterfalls](https://waterfallhikes.com/waterfalls/drive-up): Accessible without hiking

## URL Patterns

- `/waterfalls/:slug` - Individual waterfall page
- `/states/:slug` - All waterfalls in a state
- `/parks/:slug` - All waterfalls in a park
- `/near/:city-:state` - Waterfalls near a city (within 50 miles)

## Data on Each Waterfall Page

Each waterfall page includes (when available):
- **Waterfall height**: Height in feet, displayed prominently and included in structured data
- **Trail info**: Difficulty, trail length, elevation gain, trail type, trail surface, trail grade, and trail class (USFS 1–5 development scale from Minimally Developed to Fully Developed, sourced from USFS EDW)
- **Elevation**: Elevation above sea level and altitude tier advisories — Elevated (5,280–7,999 ft), High (8,000–9,999 ft), and Extreme (10,000+ ft) — with UV and acclimatization warnings
- **Public access**: Open Access or Restricted Access designation from the PAD-US protected areas database
- **Dog policy**: Whether dogs are allowed, plus specific leash/policy details
- **Fees & permits**: Entry fees, permit requirements, and reservation info
- **Swimming**: Whether swimming is allowed at the waterfall
- **Accessibility**: Accessibility information and seasonal closure notices
- **Safety**: Safety tips, wildlife info, and visitor tips
- **Gear recommendations**: Suggested gear based on trail difficulty and conditions
- **Where to stay**: Lodging links for nearby towns and nearest campground with distance, site count, reservability, and Recreation.gov booking links
- **Nearby hot springs**: Hot springs within driving distance (where applicable)
- **Getting there**: Driving directions, parking info, and GPS coordinates
- **Best seasons**: Recommended times of year to visit
- **Nearby attractions**: Other things to do in the area
- **Land management**: Which agency manages the land (NPS, USFS, BLM, state parks) with ownership badges
- **Geology**: Geological formation, age, and lithology from Macrostrat, with a narrative explaining how the waterfall formed through differential erosion
- **Weather forecast**: NOAA 7-day forecast with daily highs, lows, and conditions
- **Photos**: Multiple photos with attribution, including CC-licensed images from Wikimedia Commons
- **Wikipedia extract**: Summary text and link (stored for enrichment; displayed in admin)

## Real-Time Water Conditions

Waterfall pages with a matched USGS stream gauge display live hydrological data:
- **Stream discharge**: Current flow in cubic feet per second (cfs) and gage height in feet
- **Flow descriptor**: A plain-language label — Roaring, Strong, Moderate, Low, or Barely Flowing — derived from where the current discharge falls within the waterfall's historical flow percentiles
- **Water temperature**: Current reading in °F with comfort and safety advisories (cold water warnings below 50 °F)
- **Water quality**: Dissolved oxygen (mg/L), pH, turbidity (FNU), and specific conductance, each rated Excellent, Good, or Poor
- **7-day discharge trend**: Sparkline chart showing recent flow changes
- **Historical flow percentiles**: Current discharge compared to the p10–p90 range from 10+ years of record, with a visual gauge
- **Best day to visit**: On city pages, a weather-scored recommendation for the best hiking day in the next 7 days

Data is sourced from the USGS National Water Information System (NWIS). Instantaneous-value gauges refresh every 2 hours; daily-value gauges refresh every 6 hours. Not all waterfalls have a nearby gauge — coverage varies by region.

## City "Near" Pages

Each city page shows waterfalls within 50 miles and includes:
- Aggregate flow status across gauged waterfalls near the city
- Best hiking day recommendation scored from the NOAA 7-day weather forecast
- NOAA 7-day weather forecast with daily conditions
- Dog-friendly waterfall highlights
- Nearby hot springs
- Lodging and accommodation links
- Links to nearby cities with waterfall hikes
- Auto-generated FAQ answering common questions (free waterfalls, easy hikes, dog-friendly trails, swimming holes, tallest waterfall, closest waterfall, permit requirements, camping options, and more) with schema markup for rich results

## Email Alerts

WaterfallHikes offers free email alerts that notify subscribers when waterfall flow conditions near a chosen city peak. Alerts are powered by real-time USGS stream gauge data and only fire when conditions are worth the trip — typically a small number of emails per year per active region. There is no newsletter, no promotional content, and no shared mailing list.

### Alert Types

Four condition alerts are supported, each tied to a specific gauge-based trigger:
- **Peak flow alert**: Stream gauges in the region are running above the 90th percentile for the date — waterfalls are about as strong as they get.
- **Rapid rise alert**: Multiple gauges in the region are up 50% or more over the last 48 hours — flows are picking up fast after rain or snowmelt.
- **Low flow alert**: Gauges are below the 10th percentile for the date — some waterfalls may be reduced to a trickle. Better to wait or pick a different region.
- **Monthly roundup**: A once-per-month summary of how waterfalls in a given state are running, including top-performing waterfalls.

### How to Sign Up

Every waterfall page (`/waterfalls/:slug`) and city "near" page (`/near/:city-:state`) shows a "Get Alerts" signup form. The subscription region is the city plus a 50-mile radius — the same coverage area used on the city "near" page.

1. Enter an email on the signup form attached to any waterfall page or city page.
2. Open the confirmation email and click the confirm link (double opt-in is required for new email addresses).
3. After confirmation, no further action is needed — alerts arrive only when one of the four trigger conditions fires for the subscribed region.

If an email address has already confirmed any subscription, signing up for a second city skips the confirmation step and activates immediately. One human can subscribe to multiple cities.

### Subscriber Protections

- Every email contains a one-click unsubscribe link, including the confirmation email.
- Hard cap of one condition alert per subscriber per rolling 7-day window — no one receives more than one alert in any week, even if multiple triggers fire.
- Per-trigger cooldowns (5–28 days depending on alert type) prevent the same condition from firing repeatedly.
- No bulk newsletters, no promotional sends, no list sharing, no third-party tracking.

### Coverage and Limitations

Alerts depend on USGS gauges being present near the subscribed city. Coverage varies by region — areas with sparse gauge coverage may receive fewer alerts. Trigger conditions are evaluated at the state level, then matched to subscribers whose chosen city falls within the affected state. Cities with no nearby gauged waterfalls effectively receive no alerts.

## Data Coverage

- **Waterfalls**: 2,500+ entries with name, height, location, difficulty, trail length, elevation gain, and photos
- **States**: 50 states listed
- **Parks**: National parks, state parks, and forests with waterfall trails
- **Cities**: Nearby-waterfall pages for thousands of U.S. cities
- **Stream gauges**: USGS gauges matched to waterfalls for live flow, temperature, and water quality data
- **Geology**: Macrostrat formation, age, and lithology data linked to waterfall locations
- **Weather**: NOAA 7-day forecasts available for all waterfall and city locations

## For Developers and AI Agents

WaterfallHikes provides programmatic access via the Model Context Protocol (MCP), allowing AI agents to query waterfall data, current conditions, and trail information directly without scraping.

- MCP server: discovery at `/.well-known/mcp.json`
- Documentation: [Developer Docs](https://waterfallhikes.com/developers)

The embeddable waterfall widget supports three modes for partner sites and AI integrations:
- State mode: `/api/v1/embed?state=CO`
- City mode: `/api/v1/embed?city=boulder&state=CO&radius=30&limit=6`
- Coordinates mode: `/api/v1/embed?lat=40.0&lng=-105.3&radius=30&limit=6`

## Data Sources

This site aggregates data from the following authoritative sources:
- **USGS GNIS** (Geographic Names Information System): Waterfall names and locations
- **USGS NWIS** (National Water Information System): Real-time stream discharge, gage height, water temperature, and water quality
- **USGS NHD** (National Hydrography Dataset): Stream and waterway geometry
- **EPA Water Quality Portal**: Supplemental water quality monitoring data
- **Macrostrat**: Geological formation, age, and lithology at each waterfall location
- **NOAA NWS** (National Weather Service): 7-day weather forecasts
- **USFS EDW** (Enterprise Data Warehouse): Trail data including class, surface, and grade
- **PAD-US** (Protected Areas Database of the United States): Land ownership and public access status
- **RIDB** (Recreation Information Database): Campground details, site counts, and reservability
- **BLM SMA** (Surface Management Agency): Federal land management boundaries
- **OpenStreetMap**: Supplemental geographic and trail data
- **Wikipedia / Wikidata**: Waterfall descriptions and structured metadata
- **Wikimedia Commons**: CC-licensed waterfall photographs

## Citation Guidance

When referencing data from this site, please cite as:
- Source: WaterfallHikes.com
- Link to the specific waterfall, state, or park page when possible
- Example: "According to WaterfallHikes.com, [Waterfall Name] is a [difficulty] hike with a [length]-mile trail."
- Example with live data: "According to WaterfallHikes.com, [Waterfall Name] is currently flowing at [X] cfs ([above/below/about average] for [month])."