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

Добро пожаловать в официальную документацию API сервиса CopeSearch. Актуальная версия предоставляет инструменты для поиска информации по открытым и закрытым базам данных.

ℹ Базовый адрес API: https://api.copeflud.space

Авторизация

Для выполнения запросов передавайте API-ключ в заголовках HTTP-запроса. Ключ можно получить в боте через команду /api.

X-API-Key: YOUR_API_KEY

⚠ Никогда не передавайте ваш ключ третьим лицам.

Тарификация

Категория	Типы (type)	Стоимость
Telegram	`tg`, `telegram`, `id`, `username`	15 ₽
Базовый поиск	`phone`, `email`, `vk`, `auto`, `other`	2 ₽

POST Поиск информации

Эндпоинт: /api/v1/search

Параметры

query

Обязательно

Поисковый запрос (номер телефона, почта, ID, ссылка и т.д.)

type

Опционально

Тип поиска. По умолчанию auto.

Пример ответа

{
  "ok": true,
  "query": "79991234567",
  "type": "phone",
  "balance_after": 450,
  "results": [
    {
      "source": "Leaked DB 2023",
      "data": "Иван Иванович П., г. Казань"
    }
  ]
}

Коды ошибок

401 Unauthorized

Неверный или отсутствующий X-API-Key.

402 Payment Required

Недостаточно средств на балансе API.

403 Forbidden

Аккаунт пользователя заблокирован.

502/504 Error

Ошибка внешних провайдеров. Списания нет.