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

Обзор

Высокопроизводительный REST API для быстрого и точного поиска данных

Формат

JSON

Все запросы и ответы

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

Bearer Token

Простая авторизация

Базовый URL

epicseacrh.club

Все эндпоинты

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

Все запросы требуют Bearer-токена

Bearer Token

Добавьте заголовок Authorization со значением:

Authorization: Bearer YOUR_API_TOKEN

Токен выдаётся после регистрации. Храните его в безопасном месте.

Поиск

Основной эндпоинт для поиска данных

POST

/api/v1/search/

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

Пример запроса

$body = @{ field = 'mail'; value = '[email protected]' } | ConvertTo-Json -Compress
curl.exe -X POST "https://epicseacrh.club/api/v1/search/" `
  -H "Authorization: Bearer YOUR_API_TOKEN" `
  -H "Content-Type: application/json" `
  -d $body
                

Интерактивная песочница (демо без отправки данных)

Поле поиска

Значение

200 OK

Поля поиска

Поддерживаемые типы данных для поиска

mail

Email адрес

phone

Номер телефона

username

Имя пользователя

IP адрес

address

Адрес

passport

Паспорт

fio

ФИО

auto

Автомобиль

inn / vkid

Tax and VK identifiers

fio_birthday

Full name plus date

card / snils

Card and SNILS

domain

DNS, HTTP and geo

OSINT-граф связей

Связи между найденными атрибутами в формате JSON

Передайте include_graph: true, чтобы получить граф связей в поле enrichment.graph. Это не геокарта: граф показывает, какие значения встретились вместе в результатах поиска. API возвращает JSON, а визуализацию партнёр строит в своём интерфейсе самостоятельно.

Пример запроса

{
  "field": "mail",
  "value": "[email protected]",
  "include_graph": true
}
                

Фрагмент ответа

"enrichment": {
  "graph": {
    "nodes": [
      { "id": "a1b2c3...", "type": "email", "value": "[email protected]" },
      { "id": "d4e5f6...", "type": "phone", "value": "+79990000000" }
    ],
    "edges": [
      { "source": "a1b2c3...", "target": "d4e5f6..." }
    ]
  }
}
                

Узлы

Каждый узел содержит id, type и найденное value.

Типы

phone, email, username, person, passport, inn, snils, vkid, telegram, birthday, address, ip и other.

Рёбра

source и target содержат ID связанных узлов. ID используйте только в текущем ответе.

Статистика токена

Информация об использовании API-ключа

GET

/api/v1/token/stats

Возвращает текущий баланс и доступное количество запросов.

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

{

  "token": "YOUR_API_TOKEN",

  "balance": 9.58,

  "balance_requests": 958,

  "created_at": "2026-01-01T00:00:00"

}

EpicAPI

Обзор

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

Поиск

Поля поиска

OSINT-граф связей

Статистика токена