Developers
JSON-доступ только для чтения к тому, что мы измеряем сами: инциденты подводных кабелей с измеренными таймлайнами, посуточные агрегаты задержек с собственной распределенной сети зондов и живой статус мониторинга. Без регистрации и ключей. Свободно для коммерческого и исследовательского использования по CC BY 4.0 - достаточно указать GeoCables со ссылкой.
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"| Эндпойнт | Что возвращает | Параметры |
|---|---|---|
GET /incidents | Обнаруженные инциденты кабелей: тип, серьезность, статус, измеренный RTT против базлайна, вердикт, ссылка на публичную страницу инцидента. Честная маркировка - аномалия, оказавшаяся не аварией, так и подписана. | status (active | monitoring | warning | resolved), limit ≤ 100, offset |
GET /incidents/{alert_number} | Один инцидент с полным измеренным таймлайном (RTT по событиям, коэффициенты, описания). | - |
GET /latency | Посуточные агрегаты «город зонда - цель»: число замеров, медиана, p90, минимальный RTT, среднее число хопов. Те же колонки, что в открытом датасете. | from, to (max 92 d), probe_city, target_city, target_country, limit ≤ 1000 |
GET /status | Живая сводка: активные алерты, маршруты и измерения за последние 24 часа. | - |
GET /openapi.json | Машиночитаемая спецификация OpenAPI 3.0. | - |
{
"data": [ ... ],
"meta": {
"attribution": "GeoCables (https://geocables.com), CC BY 4.0",
"docs": "https://geocables.com/developers",
"total": 180, "limit": 25, "offset": 0
}
}Нужно все сразу? Открытый датасет отдает ежедневные снапшоты CSV/JSON (сырые измерения хранятся скользящим окном; посуточные агрегаты - глубже, а история версий на Kaggle / Hugging Face сохраняет каждый снапшот). Удобнее подписка? RSS-лента инцидентов.
Лимит существует, чтобы один скрипт не вытеснял остальных. Нужно больше - исследование, дашборд редакции, интеграция - напишите на datasets@geocables.com, договоримся. Опубликовали что-то на этом API - покажите нам; единственное требование - атрибуция со ссылкой на geocables.com.