Главная
Обзор Кабели Локации Карта Статус провайдеров Карта транзита Устойчивость стран Проверить мое соединение
Live Радар сети Живая карта Мониторинг кабелей Журнал событий Инциденты кабелей Большой экран
Читать Исследования Инструкция Методология Задержки Наземные линии Ввод кабелей по годам Пульс Открытые данные API Виджеты Что нового О проекте Контакты

Разработчикам

GeoCables API v1

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

Чего здесь осознанно нет

Названия кабелей, маршруты и владельцы на наших картах - сторонний отраслевой реестр. Это не наш набор данных, поэтому API его не раздает. В записях инцидентов имена кабелей упоминаются только как контекст наших собственных измерений. IP-адреса зондов и промежуточных хопов также опущены.

Данные пакетом и ленты

Нужно все сразу? Открытый датасет отдает ежедневные снапшоты CSV/JSON (сырые измерения хранятся скользящим окном; посуточные агрегаты - глубже, а история версий на Kaggle / Hugging Face сохраняет каждый снапшот). Удобнее подписка? RSS-лента инцидентов.

Честное использование и контакт

Лимит существует, чтобы один скрипт не вытеснял остальных. Нужно больше - исследование, дашборд редакции, интеграция - напишите на datasets@geocables.com, договоримся. Опубликовали что-то на этом API - покажите нам; единственное требование - атрибуция со ссылкой на geocables.com.

Log In

Access your routes, favorites, and API key

Create account Forgot password?