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. Marcas de tiempo: los campos terminados en _utc están en UTC en formato ISO 8601 con desplazamiento (por ejemplo 2026-11-07T20:32:22+00:00); los campos antiguos sin sufijo van en hora local del servidor, como indica meta.time de cada respuesta. | 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.
¿Prefiere recibir avisos? Podemos enviar un POST JSON a su dirección HTTPS cuando se detecta un nuevo incidente de cable (incident.new) y cuando se cierra (incident.resolved). Solo se envían los incidentes que pasan el mismo filtro de significancia que la página de incidentes. El cuerpo lleva los mismos campos que /incidents, incluidas las marcas de tiempo *_utc. Cada mensaje va firmado: la cabecera X-GeoCables-Signature es sha256= seguido del HMAC-SHA256 del cuerpo con su secreto; X-GeoCables-Event nombra el evento y X-GeoCables-Delivery es único por entrega. Responda con cualquier estado 2xx; si no, reintentamos cinco veces en seis horas. Para suscribirse, escriba a datasets@geocables.com con su dirección y unas palabras sobre el proyecto. Mismas condiciones que la API: CC BY 4.0 con atribución.
POST https://your.example/geocables
X-GeoCables-Event: incident.new
X-GeoCables-Delivery: 1842
X-GeoCables-Signature: sha256=3f1c...
{
"event": "incident.new",
"delivery": "1842",
"sent_at_utc": "2026-11-09T06:40:12+00:00",
"data": {
"alert_number": "2026110901", "cable_name": "...", "alert_type": "latency_spike",
"severity": "warning", "status": "active",
"detected_at_utc": "2026-11-09T06:31:05+00:00", "resolved_at_utc": null,
"rtt_baseline_ms": 182, "rtt_current_ms": 371, "affected_countries": "...", "verdict": "...",
"url": "https://geocables.com/incident/2026110901"
},
"meta": { "attribution": "GeoCables (https://geocables.com), CC BY 4.0", "docs": "https://geocables.com/developers#webhooks" }
}
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.