Developers
Acceso JSON de solo lectura a lo que medimos nosotros mismos: incidentes de cables submarinos con cronologias 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 investigacion 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 | Que devuelve | Parametros |
|---|---|---|
GET /incidents | Incidentes de cables detectados: tipo, severidad, estado, RTT medido contra la referencia, veredicto, enlace a la pagina publica. Etiquetado honesto - una anomalia que no resulto averia lo dice. | status (active | monitoring | warning | resolved), limit ≤ 100, offset |
GET /incidents/{alert_number} | Un incidente con su cronologia medida completa (RTT por evento, ratios, descripciones). | - |
GET /latency | Agregados diarios ciudad-sonda a destino: numero de mediciones, mediana, p90, RTT minimo, 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 ultimas 24 h. | - |
GET /openapi.json | Especificacion OpenAPI 3.0 legible por maquina. | - |
{
"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 instantaneas diarias CSV/JSON (las mediciones crudas se guardan en ventana movil; los agregados diarios llegan mas atras, y el historial de versiones en Kaggle / Hugging Face conserva cada instantanea). Prefiere push? Feed RSS de incidentes.
El limite existe para que un script no desplace a los demas. Necesita mas - investigacion, panel de redaccion, integracion - escriba a datasets@geocables.com. La atribucion con enlace a geocables.com es el unico requisito.