¿De dónde salen las lecturas?

Del servicio Water Data del USGS, consultado en vivo y cacheado en el borde 15 minutos: caudal en pies cúbicos por segundo, altura en pies y temperatura del agua en grados Celsius, cada una con su marca de tiempo.

¿Qué estaciones cubre?

11.605 estaciones fluviales activas del USGS en los 50 estados, DC y Puerto Rico, en un directorio buscable con búsqueda de la más cercana por coordenadas.

¿Qué pasa si una estación deja de informar?

Cada lectura lleva su marca de tiempo y un indicador de obsolescencia, para que tu código distinga un valor actual de uno con horas de antigüedad.

¿Puedo consultar varios sitios a la vez?

Sí. El endpoint de condiciones acepta hasta 10 identificadores de sitio en una llamada.

¿Incluye pronósticos o niveles de inundación?

No. Sirve condiciones observadas. Los umbrales de inundación provienen del Servicio Meteorológico Nacional y no forman parte de este conjunto.

DatosMANTENIDA2 tokens / llamada

River Conditions API

Caudal, altura y temperatura del agua en vivo de 11.605 estaciones fluviales del USGS, con búsqueda de la más cercana

Condiciones de rios en vivo desde cada estacion activa del USGS. Un directorio buscable de 11.605 estaciones de aforo activas de EE.UU. (50 estados, DC y Puerto Rico) con busqueda de estacion mas cercana por coordenadas — y lecturas en vivo directas del servicio de valores instantaneos del USGS con cache de 15 minutos en el edge: caudal (ft³/s), altura de lamina (ft) y temperatura del agua (°C). El Colorado en Lees Ferry ahora mismo: 7.740 cfs, 7,95 ft, 20,2 °C, con timestamp. Pide hasta 10 estaciones en una llamada, el detalle de una, o las mas cercanas a un punto con sus condiciones en linea. Cada lectura lleva su propio timestamp y una marca stale cuando un sensor lleva 24+ horas callado — una serie de temperatura descontinuada nunca se hace pasar por actual. Apps de pesca y kayak, alerta de crecidas, herramientas de riego, dashboards hidrologicos y planificadores de aventura — los mismos datos detras de cada sitio de niveles de rios, desde la fuente primaria. Cobertura de EE.UU. (red USGS).

Cada llamada necesita la cabecera X-Api-Key. Una clave gratuita incluye 500 tokens al mes, sin tarjeta. 2 tokens por llamada, así que el plan gratuito cubre unas 250 llamadas al mes.

Start free — 500 tokens / mo →See all plans

Sin tarjeta de créditoAcceso a más de 125 APIsCancela cuando quieras

response.json

{
  "ok": true,
  "site": {
    "id": "09380000",
    "name": "COLORADO RIVER AT LEES FERRY, AZ",
    "state": "AZ",
    "lat": 36.86433,
    "lng": -111.58787,
    "huc": "140700061105"
  },
  "units": {
    "discharge_cfs": "ft3/s",
    "gage_height_ft": "ft",
    "water_temp_c": "degC"
  },
  "conditions": {
    "gage_height_ft": {
      "value": 8.3,
      "time": "2026-09-13T03:00:00+00:00",
      "stale": false
    },
    "discharge_cfs": {
      "value": 8740,
      "time": "2026-09-13T03:00:00+00:00",
      "stale": false
    },
    "water_temp_c": {
      "value": 21.8,
      "time": "2026-09-13T03:00:00+00:00",
      "stale": false
    }
  }
}

Listo para producción: Infraestructura probada en producción con un SLA de disponibilidad del 99,9 %. Límites de uso generosos y respuestas consistentes.
Integración sencilla: REST + JSON estándar. Funciona con cualquier cliente HTTP. Fragmentos de código listos para copiar en 4 lenguajes.
Una clave, más de 125 APIs: Tu suscripción a DataAndAPIs desbloquea todas las APIs de la plataforma: anime, finanzas, deportes y más.

Casos de uso de River Conditions API

Mostrar las condiciones actuales del río cerca de un usuario para pesca, remo o alerta de inundaciones.
Vigilar estaciones aguas arriba de una instalación y avisar cuando el caudal o el nivel superen un umbral.
Encontrar la estación activa más cercana a cualquier coordenada y enlazar a su página del USGS.
Graficar varios sitios en una petición para un panel hídrico regional.

Endpoints de River Conditions API

Todos los endpoints con sus parámetros y una respuesta de ejemplo real.

Definición OpenAPI Espacio de trabajo en Postman

GETData Sources
GETGauge Detail
GETLive Conditions
GETNearest Gauges
GETSearch Gauges

GETData Sources

https://api-rivers.dataandapis.com/v1/sources

Este endpoint no recibe parámetros.

Petición de ejemplo

curl "https://api-rivers.dataandapis.com/v1/sources" \
  -H "X-Api-Key: YOUR_API_KEY"

Respuesta de ejemplo

{
  "ok": true,
  "sources": [
    {
      "slug": "usgs-nwis",
      "name": "USGS National Water Information System",
      "publisher": "US Geological Survey",
      "licence": "US government work (public domain)",
      "source_url": "https://waterdata.usgs.gov/",
      "file_url": "https://waterservices.usgs.gov/",
      "cadence": "site list ~static; readings fetched live",
      "record_count": 11605,
      "retrieved_at": "2026-09-06"
    }
  ]
}

GETGauge Detail

https://api-rivers.dataandapis.com/v1/rivers/sites/{id}

Parámetros de ruta

Parámetro	Ejemplo
id	09380000	Obligatorio

Petición de ejemplo

curl "https://api-rivers.dataandapis.com/v1/rivers/sites/09380000" \
  -H "X-Api-Key: YOUR_API_KEY"

Respuesta de ejemplo

{
  "ok": true,
  "site": {
    "id": "09380000",
    "name": "COLORADO RIVER AT LEES FERRY, AZ",
    "state": "AZ",
    "lat": 36.86433,
    "lng": -111.58787,
    "huc": "140700061105"
  },
  "units": {
    "discharge_cfs": "ft3/s",
    "gage_height_ft": "ft",
    "water_temp_c": "degC"
  },
  "conditions": {
    "gage_height_ft": {
      "value": 8.3,
      "time": "2026-09-13T03:00:00+00:00",
      "stale": false
    },
    "discharge_cfs": {
      "value": 8740,
      "time": "2026-09-13T03:00:00+00:00",
      "stale": false
    },
    "water_temp_c": {
      "value": 21.8,
…

Ver la respuesta completa

{
  "ok": true,
  "site": {
    "id": "09380000",
    "name": "COLORADO RIVER AT LEES FERRY, AZ",
    "state": "AZ",
    "lat": 36.86433,
    "lng": -111.58787,
    "huc": "140700061105"
  },
  "units": {
    "discharge_cfs": "ft3/s",
    "gage_height_ft": "ft",
    "water_temp_c": "degC"
  },
  "conditions": {
    "gage_height_ft": {
      "value": 8.3,
      "time": "2026-09-13T03:00:00+00:00",
      "stale": false
    },
    "discharge_cfs": {
      "value": 8740,
      "time": "2026-09-13T03:00:00+00:00",
      "stale": false
    },
    "water_temp_c": {
      "value": 21.8,
      "time": "2026-09-13T03:00:00+00:00",
      "stale": false
    }
  }
}

GETLive Conditions

https://api-rivers.dataandapis.com/v1/rivers/conditions

Parámetros de consulta

Parámetro	Ejemplo
sites	01646500,09380000	Obligatorio

Petición de ejemplo

curl "https://api-rivers.dataandapis.com/v1/rivers/conditions?sites=01646500%2C09380000" \
  -H "X-Api-Key: YOUR_API_KEY"

Respuesta de ejemplo

{
  "ok": true,
  "units": {
    "discharge_cfs": "ft3/s",
    "gage_height_ft": "ft",
    "water_temp_c": "degC"
  },
  "cache": "readings edge-cached 15 minutes; stale=true means older than 24h",
  "sites": [
    {
      "id": "01646500",
      "name": "POTOMAC RIVER NEAR WASH, DC LITTLE FALLS PUMP STA",
      "state": "MD",
      "lat": 38.94978,
      "lng": -77.12764,
      "huc": "020700081005",
      "conditions": {
        "water_temp_c": {
          "value": 26.6,
          "time": "2026-09-13T03:50:00+00:00",
          "stale": false
        },
        "discharge_cfs": {
          "value": 1940,
          "time": "2026-09-13T03:50:00+00:00",
          "stale": false
        },
        "gage_height_ft": {
…

Ver la respuesta completa

{
  "ok": true,
  "units": {
    "discharge_cfs": "ft3/s",
    "gage_height_ft": "ft",
    "water_temp_c": "degC"
  },
  "cache": "readings edge-cached 15 minutes; stale=true means older than 24h",
  "sites": [
    {
      "id": "01646500",
      "name": "POTOMAC RIVER NEAR WASH, DC LITTLE FALLS PUMP STA",
      "state": "MD",
      "lat": 38.94978,
      "lng": -77.12764,
      "huc": "020700081005",
      "conditions": {
        "water_temp_c": {
          "value": 26.6,
          "time": "2026-09-13T03:50:00+00:00",
          "stale": false
        },
        "discharge_cfs": {
          "value": 1940,
          "time": "2026-09-13T03:50:00+00:00",
          "stale": false
        },
        "gage_height_ft": {
          "value": 2.81,
          "time": "2026-09-13T03:50:00+00:00",
          "stale": false
        }
      }
    },
    {
      "id": "09380000",
      "name": "COLORADO RIVER AT LEES FERRY, AZ",
      "state": "AZ",
      "lat": 36.86433,
      "lng": -111.58787,
      "huc": "140700061105",
      "conditions": {
        "gage_height_ft": {
          "value": 8.3,
          "time": "2026-09-13T03:00:00+00:00",
          "stale": false
        },
        "discharge_cfs": {
          "value": 8740,
          "time": "2026-09-13T03:00:00+00:00",
          "stale": false
        },
        "water_temp_c": {
          "value": 21.8,
          "time": "2026-09-13T03:00:00+00:00",
          "stale": false
        }
      }
    }
  ]
}

GETNearest Gauges

https://api-rivers.dataandapis.com/v1/rivers/nearest

Parámetros de consulta

Parámetro	Ejemplo
lat	40.01	Obligatorio
limit	5	Opcional
lng	-105.27	Obligatorio

Petición de ejemplo

curl "https://api-rivers.dataandapis.com/v1/rivers/nearest?lat=40.01&limit=5&lng=-105.27" \
  -H "X-Api-Key: YOUR_API_KEY"

Respuesta de ejemplo

{
  "ok": true,
  "query": {
    "lat": 40.01,
    "lng": -105.27
  },
  "sites": [
    {
      "id": "06727500",
      "name": "FOURMILE CREEK AT ORODELL, CO",
      "state": "CO",
      "lat": 40.01867,
      "lng": -105.32625,
      "huc": "10190005",
      "distance_km": 4.9,
      "conditions": {
        "discharge_cfs": {
          "value": 0.01,
          "time": "2026-09-13T03:50:00+00:00",
          "stale": false
        },
        "gage_height_ft": {
          "value": 4.09,
          "time": "2026-09-13T03:50:00+00:00",
          "stale": false
        }
      }
    },
…

Ver la respuesta completa

{
  "ok": true,
  "query": {
    "lat": 40.01,
    "lng": -105.27
  },
  "sites": [
    {
      "id": "06727500",
      "name": "FOURMILE CREEK AT ORODELL, CO",
      "state": "CO",
      "lat": 40.01867,
      "lng": -105.32625,
      "huc": "10190005",
      "distance_km": 4.9,
      "conditions": {
        "discharge_cfs": {
          "value": 0.01,
          "time": "2026-09-13T03:50:00+00:00",
          "stale": false
        },
        "gage_height_ft": {
          "value": 4.09,
          "time": "2026-09-13T03:50:00+00:00",
          "stale": false
        }
      }
    },
    {
      "id": "06730160",
      "name": "FOURMILE CANYON CREEK NEAR SUNSHINE, CO",
      "state": "CO",
      "lat": 40.05761,
      "lng": -105.34878,
      "huc": "10190005",
      "distance_km": 8.5,
      "conditions": {
        "gage_height_ft": {
          "value": 0.56,
          "time": "2026-09-13T03:50:00+00:00",
          "stale": false
        },
        "discharge_cfs": {
          "value": 0,
          "time": "2026-09-13T03:50:00+00:00",
          "stale": false
        }
      }
    },
    {
      "id": "06727410",
      "name": "FOURMILE CREEK AT LOGAN MILL ROAD NEAR CRISMAN, CO",
      "state": "CO",
      "lat": 40.04203,
      "lng": -105.36492,
      "huc": "101900050403",
      "distance_km": 8.8,
      "conditions": {
        "gage_height_ft": {
          "value": 9.07,
          "time": "2026-09-13T03:55:00+00:00",
          "stale": false
        },
        "discharge_cfs": {
          "value": 0.15,
          "time": "2026-09-13T03:55:00+00:00",
          "stale": false
        }
      }
    },
    {
      "id": "06730200",
      "name": "BOULDER CREEK AT NORTH 75TH ST. NEAR BOULDER, CO",
      "state": "CO",
      "lat": 40.05167,
      "lng": -105.17833,
      "huc": "101900050601",
      "distance_km": 9.1,
      "conditions": {
        "gage_height_ft": {
          "value": 4.58,
          "time": "2026-09-13T03:15:00+00:00",
          "stale": false
        },
        "discharge_cfs": {
          "value": 29.6,
          "time": "2026-09-13T03:15:00+00:00",
          "stale": false
        }
      }
    },
    {
      "id": "06729470",
      "name": "SOUTH BOULDER CR AT FOREBAY NR ELDORADO SPRINGS CO",
      "state": "CO",
      "lat": 39.93244,
      "lng": -105.30867,
      "huc": "10190005",
      "distance_km": 9.2,
      "conditions": {
        "water_temp_c": {
          "value": 14.6,
          "time": "2026-09-13T03:00:00+00:00",
          "stale": false
        }
      }
    }
  ]
}

GETSearch Gauges

https://api-rivers.dataandapis.com/v1/rivers/sites

Parámetros de consulta

Parámetro	Ejemplo
q	potomac	Opcional
state		Opcional

Petición de ejemplo

curl "https://api-rivers.dataandapis.com/v1/rivers/sites?q=potomac" \
  -H "X-Api-Key: YOUR_API_KEY"

Respuesta de ejemplo

{
  "ok": true,
  "page": 1,
  "limit": 25,
  "total": 21,
  "total_pages": 1,
  "sites": [
    {
      "id": "01606000",
      "name": "N F SOUTH BRANCH POTOMAC RIVER AT CABINS, WV",
      "state": "WV",
      "lat": 38.98455,
      "lng": -79.23365,
      "huc": "02070001"
    },
    {
      "id": "01595800",
      "name": "NORTH BRANCH POTOMAC RIVER AT BARNUM, WV",
      "state": "WV",
      "lat": 39.44511,
      "lng": -79.11081,
      "huc": "020700020207"
    },
    {
      "id": "01595500",
      "name": "NORTH BRANCH POTOMAC RIVER AT KITZMILLER, MD",
      "state": "MD",
      "lat": 39.39389,
…

Ver la respuesta completa

{
  "ok": true,
  "page": 1,
  "limit": 25,
  "total": 21,
  "total_pages": 1,
  "sites": [
    {
      "id": "01606000",
      "name": "N F SOUTH BRANCH POTOMAC RIVER AT CABINS, WV",
      "state": "WV",
      "lat": 38.98455,
      "lng": -79.23365,
      "huc": "02070001"
    },
    {
      "id": "01595800",
      "name": "NORTH BRANCH POTOMAC RIVER AT BARNUM, WV",
      "state": "WV",
      "lat": 39.44511,
      "lng": -79.11081,
      "huc": "020700020207"
    },
    {
      "id": "01595500",
      "name": "NORTH BRANCH POTOMAC RIVER AT KITZMILLER, MD",
      "state": "MD",
      "lat": 39.39389,
      "lng": -79.18169,
      "huc": "02070002"
    },
    {
      "id": "01598500",
      "name": "NORTH BRANCH POTOMAC RIVER AT LUKE, MD",
      "state": "MD",
      "lat": 39.47897,
      "lng": -79.06378,
      "huc": "020700020207"
    },
    {
      "id": "01595000",
      "name": "NORTH BRANCH POTOMAC RIVER AT STEYER, MD",
      "state": "MD",
      "lat": 39.30189,
      "lng": -79.30689,
      "huc": "02070002"
    },
    {
      "id": "01603000",
      "name": "NORTH BRANCH POTOMAC RIVER NEAR CUMBERLAND, MD",
      "state": "MD",
      "lat": 39.62181,
      "lng": -78.77342,
      "huc": "020700020801"
    },
    {
      "id": "01636765",
      "name": "POTOMAC RIVER AT BURKITTSVILLE RD AT BRUNSWICK, MD",
      "state": "MD",
      "lat": 39.30887,
      "lng": -77.63099,
      "huc": "020700080202"
    },
    {
      "id": "0165258890",
      "name": "POTOMAC RIVER AT CAMERON ST DOCK AT ALEXANDRIA, VA",
      "state": "VA",
      "lat": 38.80528,
      "lng": -77.03833,
      "huc": "02070010"
    },
    {
      "id": "01644148",
      "name": "POTOMAC RIVER AT EDWARDS FERRY NEAR POOLESVILLE,MD",
      "state": "MD",
      "lat": 39.09864,
      "lng": -77.47125,
      "huc": "020700080904"
    },
    {
      "id": "01613000",
      "name": "POTOMAC RIVER AT HANCOCK, MD",
      "state": "MD",
      "lat": 39.69756,
      "lng": -78.17789,
      "huc": "020700040504"
    },
    {
      "id": "01620000",
      "name": "POTOMAC RIVER AT HARPERS FERRY, WV",
      "state": "MD",
      "lat": 39.32375,
      "lng": -77.72819,
      "huc": "02070004"
    },
    {
      "id": "01610000",
      "name": "POTOMAC RIVER AT PAW PAW, WV",
      "state": "MD",
      "lat": 39.53886,
      "lng": -78.45561,
      "huc": "02070003"
    },
    {
      "id": "01638500",
      "name": "POTOMAC RIVER AT POINT OF ROCKS, MD",
      "state": "MD",
      "lat": 39.27358,
      "lng": -77.54311,
      "huc": "02070008"
    },
    {
      "id": "01618000",
      "name": "POTOMAC RIVER AT SHEPHERDSTOWN, WV",
      "state": "WV",
      "lat": 39.43472,
      "lng": -77.80139,
      "huc": "020700041106"
    },
    {
      "id": "01646500",
      "name": "POTOMAC RIVER NEAR WASH, DC LITTLE FALLS PUMP STA",
      "state": "MD",
      "lat": 38.94978,
      "lng": -77.12764,
      "huc": "020700081005"
    },
    {
      "id": "01607500",
      "name": "S F SOUTH BRANCH POTOMAC RIVER AT BRANDYWINE, WV",
      "state": "WV",
      "lat": 38.63151,
      "lng": -79.24365,
      "huc": "02070001"
    },
    {
      "id": "01608000",
      "name": "S F SOUTH BRANCH POTOMAC RIVER NR MOOREFIELD, WV",
      "state": "WV",
      "lat": 39.01233,
      "lng": -78.95614,
      "huc": "02070001"
    },
    {
      "id": "01605500",
      "name": "SOUTH BRANCH POTOMAC RIVER AT FRANKLIN, WV",
      "state": "WV",
      "lat": 38.63567,
      "lng": -79.33782,
      "huc": "02070001"
    },
    {
      "id": "01608070",
      "name": "SOUTH BRANCH POTOMAC RIVER NEAR MOOREFIELD, WV",
      "state": "WV",
      "lat": 39.10392,
      "lng": -78.95931,
      "huc": "02070001"
    },
    {
      "id": "01606500",
      "name": "SOUTH BRANCH POTOMAC RIVER NEAR PETERSBURG, WV",
      "state": "WV",
      "lat": 38.99122,
      "lng": -79.17587,
      "huc": "02070001"
    },
    {
      "id": "01608500",
      "name": "SOUTH BRANCH POTOMAC RIVER NEAR SPRINGFIELD, WV",
      "state": "WV",
      "lat": 39.44704,
      "lng": -78.65418,
      "huc": "02070001"
    }
  ]
}

De dónde salen los datos

Fuente: Directorio de estaciones fluviales del USGS y servicio Water Data del USGS para lecturas en vivo (dominio público).
Actualización: Lecturas consultadas en vivo y cacheadas en el borde 15 minutos.

Una instalación. Todos los endpoints.

No necesitas SDKs propietarios. Funciona con cualquier cliente HTTP. Elige tu lenguaje y pega el código.

3lenguajes

5endpoints

RESTarquitectura

1clave para todas las APIs

Respuestas totalmente tipadas — autocompletado en tu IDE
Sigue la API al día — los nuevos endpoints llegan el mismo día
Una sola clave funciona en más de 125 APIs de la plataforma

import axios from 'axios';

const { data } = await axios.get(
  'https://api-rivers.dataandapis.com/v1/sources',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

River Conditions API · X-Api-Key

Explora los endpoints

Explora los parámetros de solicitud e inspecciona ejemplos de respuesta en vivo.

Endpoints disponibles

Parámetros de la solicitud

URL de la API

Encabezados

X-Api-Key

Lenguaje:

Cliente:

import axios from 'axios';

const url = 'https://api-rivers.dataandapis.com/v1/sources';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});

Una suscripción. Todas las APIs.

Los tokens desbloquean esta API y más de 20 más en DataAndAPIs. Cambia de API cuando quieras.

GRATIS

$0/mes

500 tokens / mes

Acceso a todas las APIs
Tokens se renuevan mensualmente
Soporte comunitario

Comienza gratis

Más Popular

STARTER

$6.99/mes

25.000 tokens / mes

Acceso a todas las APIs
Tokens se renuevan mensualmente
Soporte por email

PRO

$24.99/mes

100.000 tokens / mes

Acceso a todas las APIs
Tokens se renuevan mensualmente
Soporte por email prioritario

ULTRA

$99.99/mes

1.000.000 tokens / mes

Acceso a todas las APIs
Tokens se renuevan mensualmente
Soporte prioritario

¿Necesitas mayor volumen, infraestructura dedicada o un contrato personalizado? Habla con ventas →

River Conditions API

Casos de uso de River Conditions API

Endpoints de River Conditions API

GETData Sources

GETGauge Detail

GETLive Conditions

GETNearest Gauges

GETSearch Gauges

De dónde salen los datos

Explora los endpoints

Una suscripción. Todas las APIs.

Preguntas sobre River Conditions API

APIs que suelen usarse con River Conditions API

Lanza River Conditions API esta tarde.