REST API GET / POST JSON auto all search

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

Основной endpoint стал проще: передайте ключ и строку поиска. API сам определит тип запроса и всегда запустит общий поиск по доступным источникам.

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

Минимальный запрос состоит из двух полей: key и search.

GET /api/search?key=YOUR_API_KEY&search=79999999999

Endpoints

основной

/api/search

Телефон, email, Telegram, VK, ФИО, документы, IP, авто, ник и общий поиск.

/api/telegram/search

Отдельный Sherlock-поиск. У него свой лимит и очередь запросов.

image

/api/photo/search

Поиск по лицу. Принимает прямую ссылку на изображение или base64/data URL.

Параметры /api/search

keyобязательный

API-ключ. По нему проверяются срок, лимиты, доступные типы и разрешенные IP.

searchобязательный

Строка поиска: телефон, email, ник, ФИО, документ, IP, авто, Telegram, VK и другие значения.

GET

/api/search?key=YOUR_API_KEY&search=79999999999

POST JSON

{
  "key": "YOUR_API_KEY",
  "search": "79999999999"
}

Ответ /api/search

Ответ общего поиска содержит быстрые собранные поля в fast-result, полный список найденных строк в full-result, количество результатов и число источников.

{
  "success": true,
  "detected_type": "phone",
  "search": "79999999999",
  "fast-result": {},
  "full-result": {
    "Базовая информация": {},
    "Базы Данных": []
  },
  "results_count": 0,
  "search_time": "1.23",
  "sources_count": 0,
  "uid": "..."
}

Sherlock

Sherlock вынесен отдельно: /api/telegram/search. По умолчанию на ключе 3 запроса.

GET /api/telegram/search?key=YOUR_API_KEY&search=@username

Фото

Поиск по лицу вынесен в /api/photo/search. Можно передать прямую ссылку через image_url или base64/data URL через image_base64.

URL

GET /api/photo/search?key=YOUR_API_KEY&image_url=https://example.com/photo.jpg

Base64

{
  "key": "YOUR_API_KEY",
  "image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ..."
}

Ошибки

401 / 403

Ключ невалидный, истек срок, IP не разрешен или тип поиска недоступен.

429

Лимит превышен. Нужно подождать или увеличить лимит на ключе.

503

Один из модулей временно отключен. Общий поиск продолжит собирать доступные источники.

Reply timeout

Внешний источник не ответил за отведенное время.