Inicio
Explorar Qué puede hacer GeoCables Cables Ubicaciones Mapa Mi ruta Estado de ISP Resiliencia de países Comprobar mi conexión
Live Radar de red Mapa live Monitoreo de cables Registro de eventos Incidentes de cables Pantalla grande
Aprender Investigación Guía Metodología Latencia Enlaces terrestres Puestas en servicio por año Pulso Datos abiertos API Widgets Novedades Acerca de Contacto

Desarrolladores

GeoCables API v1

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

Inicio rápido

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"

Endpoints

EndpointQué devuelveParámetros
GET /incidentsIncidentes 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 /latencyAgregados 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 /statusResumen en vivo: alertas activas, rutas y mediciones de las últimas 24 h.-
GET /openapi.jsonEspecificación OpenAPI 3.0 legible por máquina.-

Sobre de respuesta

{
  "data": [ ... ],
  "meta": {
    "attribution": "GeoCables (https://geocables.com), CC BY 4.0",
    "docs": "https://geocables.com/developers",
    "total": 180, "limit": 25, "offset": 0
  }
}

Lo que deliberadamente no está aquí

Los nombres de cables, rutas y propietarios en nuestros mapas provienen de un inventario sectorial de terceros. No es nuestro conjunto de datos, por lo que esta API no lo redistribuye. Las direcciones IP de sondas y saltos intermedios también se omiten.

Datos masivos y feeds

¿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.

Webhooks

¿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" }
}

Uso justo y contacto

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.

Log In

Access your routes, favorites, and API key

Create account Forgot password?