Документация REST API

Mobius Search предоставляет высокоскоростной программный шлюз для автоматизированного OSINT-поиска по более чем 1000 ведомственным базам, архивам и цифровым следам.

Базовый домен шлюза: https://mobius.mobius-net.workers.dev
Прямой доступ защищен протоколом Cloudflare Edge с задержкой ответа менее 200 ms.

Быстрый старт

Для выполнения первого запроса отправьте POST-запрос с вашим токеном в заголовке X-API-Key:

curl -X POST "https://mobius.mobius-net.workers.dev/api/v1/search" \
     -H "Content-Type: application/json" \
     -H "X-API-Key: MOBIUS-IO-YOURKEY" \
     -d '{"query": "+79001234567"}'
        

Аутентификация

Каждый запрос к защищенным эндпоинтам API должен содержать персональный токен доступа. Токен начинается с префикса MOBIUS-IO-.

Вы можете передать токен одним из трех способов:

Заголовок X-API-Key: MOBIUS-IO-... (рекомендуется)
Заголовок Authorization: Bearer MOBIUS-IO-...
Query-параметр в URL ?key=MOBIUS-IO-...

Сгенерировать персональный ключ можно в Telegram-боте @MobiusSearchBot в разделе «API / Разработчикам».

Лимиты и защита от спама

Базовая квота составляет 70 запросов в минуту. Для предотвращения перегрузки бэкенда действует минимальный интервал между последовательными вызовами — 2 секунды (Rate Limiter nodelay).

В случае превышения частоты запросов сервер возвращает HTTP-статус 429 Too Many Requests.

Основной поиск

POST /api/v1/search

Выполняет сквозной интеллектуальный поиск по переданному идентификатору.

Параметры тела запроса (JSON)

Поле	Тип	Обязательный	Описание
`query`	string	Да	Поисковый идентификатор (телефон, ник, ФИО, госномер, VIN, email, ИНН)
`type`	string	Нет	Принудительный тип (`phone`, `tg`, `vk`, `fio`, `auto`, `email`, `inn`, `passport`)

Пример успешного ответа (200 OK)

{
  "success": true,
  "query": "+79001234567",
  "kind": "phone",
  "elapsed_seconds": 0.22,
  "results_count": 8,
  "results": {
    "phone": "+79001234567",
    "operator": "Tele2",
    "region": "г. Москва",
    "fio": "Иванов Иван Иванович",
    "sbp_banks": ["Сбер", "Т-Банк", "ВТБ"],
    "records_found": 8
  }
}
        

Верификация ключа

GET /api/v1/verify

Проверяет валидность переданного API-ключа и остаток доступных запросов.

curl -H "X-API-Key: MOBIUS-IO-YOURKEY" "https://mobius.mobius-net.workers.dev/api/v1/verify"
        

{
  "valid": true,
  "message": "Ключ активен",
  "key_info": {
    "queries_left": 482,
    "total_used": 18,
    "created_at": "2026-10-15T12:00:00"
  }
}
        

Статус платформы

GET /api/v1/status

Возвращает текущую доступность кластера и информацию о точке присутствия Cloudflare Edge.

{
  "status": "online",
  "network": "Mobius Search Network",
  "edge_region": "DME",
  "latency": "sub-10ms",
  "timestamp": 1792348900
}
        

Сеть суб-ботов

Платформа функционирует на базе распределенного пула из 10 активных Telegram-узлов:

@MobiusSearchBot — Главный шлюз с полным набором модулей
@MobiusFreeBot — Экспресс-узел для быстрых HLR-проверок
@MobiusSearchRobot — Резервное зеркало Nopeek Search
@Banitliik_bot, @Save89Mod09botbot, @xflux7bcc0a2_bobot — Специализированные суб-агенты
@RockyouFind_bot, @Norm_bot_bot, @apsoqpqodjxjxj_bot — Зеркала баз утечек
@tegfddfyiutrdcbjhgfsrtgbot — Автономное зеркало для закрытых поисковых сессий

Коды ответов и ошибок

HTTP Код	Статус	Описание
`200`	OK	Запрос выполнен успешно
`400`	Bad Request	Отсутствует обязательный параметр query
`401`	Unauthorized	Неверный или отозванный токен MOBIUS-IO-
`429`	Too Many Requests	Превышен лимит частоты запросов (2 сек интервал)
`502`	Bad Gateway	Синхронизация шлюза с ядром данных