Desarrolladores
Acceso JSON de solo lectura a lo que medimos nosotros mismos: incidentes de cables submarinos con cronologías medidas, agregados diarios de latencia de nuestra red distribuida de sondas y estado de monitoreo en vivo. Sin registro ni clave. Libre para uso comercial y de investigación bajo CC BY 4.0: solo acredite a GeoCables con un enlace.
Base URL: https://geocables.com/api/v1 60 requests / min / IP Responses cached ~10 min CORS: open
curl https://geocables.com/api/v1/status
curl "https://geocables.com/api/v1/incidents?status=resolved&limit=5"
curl "https://geocables.com/api/v1/latency?from=2026-09-01&target_country=SG"| Endpoint | Qué devuelve | Parámetros |
|---|---|---|
GET /incidents | Incidentes de cables detectados: tipo, severidad, estado, RTT medido frente a la referencia, veredicto, enlace a la página pública. Etiquetado honesto: una anomalía que no resultó avería lo dice. | status (active | monitoring | warning | resolved), limit ≤ 100, offset |
GET /incidents/{alert_number} | Un incidente con su cronología medida completa (RTT por evento, ratios, descripciones). | - |
GET /latency | Agregados diarios ciudad-sonda a destino: número de mediciones, mediana, p90, RTT mínimo, saltos promedio. Mismas columnas que el dataset abierto. | from, to (max 92 d), probe_city, target_city, target_country, limit ≤ 1000 |
GET /status | Resumen en vivo: alertas activas, rutas y mediciones de las últimas 24 h. | - |
GET /openapi.json | Especificación OpenAPI 3.0 legible por máquina. | - |
{
"data": [ ... ],
"meta": {
"attribution": "GeoCables (https://geocables.com), CC BY 4.0",
"docs": "https://geocables.com/developers",
"total": 180, "limit": 25, "offset": 0
}
}¿Todo de una vez? El dataset abierto ofrece instantáneas diarias CSV/JSON (las mediciones crudas se guardan en ventana móvil; los agregados diarios llegan más atrás, y el historial de versiones en Kaggle / Hugging Face conserva cada instantánea). ¿Prefiere suscribirse? Feed RSS de incidentes.
El límite existe para que un script no desplace a los demás. ¿Necesita más (investigación, panel de redacción, integración)? Escriba a datasets@geocables.com. La atribución con enlace a geocables.com es el único requisito.