Developers
Acces JSON en lecture seule a ce que nous mesurons nous-memes : incidents de cables sous-marins avec chronologies mesurees, agregats quotidiens de latence de notre reseau de sondes distribue et statut de surveillance en direct. Sans inscription ni cle. Libre pour usage commercial et de recherche sous CC BY 4.0 - il suffit de crediter GeoCables avec un lien.
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 | Ce qu'il renvoie | Parametres |
|---|---|---|
GET /incidents | Incidents de cables detectes : type, gravite, statut, RTT mesure contre la reference, verdict, lien vers la page publique. Etiquetage honnete - une anomalie qui n'est pas une avarie le dit. | status (active | monitoring | warning | resolved), limit ≤ 100, offset |
GET /incidents/{alert_number} | Un incident avec sa chronologie mesuree complete (RTT par evenement, ratios, descriptions). | - |
GET /latency | Agregats quotidiens ville-sonde vers cible : nombre de mesures, mediane, p90, RTT minimal, sauts moyens. Memes colonnes que le jeu de donnees ouvert. | from, to (max 92 d), probe_city, target_city, target_country, limit ≤ 1000 |
GET /status | Resume en direct : alertes actives, routes et mesures des dernieres 24 h. | - |
GET /openapi.json | Specification OpenAPI 3.0 lisible par machine. | - |
{
"data": [ ... ],
"meta": {
"attribution": "GeoCables (https://geocables.com), CC BY 4.0",
"docs": "https://geocables.com/developers",
"total": 180, "limit": 25, "offset": 0
}
}Tout d'un coup ? Le jeu de donnees ouvert fournit des instantanes quotidiens CSV/JSON (les mesures brutes sont conservees en fenetre glissante ; les agregats quotidiens remontent plus loin, et l'historique des versions sur Kaggle / Hugging Face conserve chaque instantane). Plutot abonnement ? Flux RSS des incidents.
La limite existe pour qu'un script ne chasse pas les autres. Besoin de plus - recherche, tableau de bord de redaction, integration - ecrivez a datasets@geocables.com. L'attribution avec un lien vers geocables.com est la seule exigence.