NebulaApi
NEBULAAPI · ДОКУМЕНТАЦИЯ

NebulaApi
универсальное API
для поиска по данным.

Один endpoint /search для поиска по телефону, email, никнейму, имени, Telegram и VK. Поиск выполняется в двух подключённых облачных индексах.

Получить API ключ Открыть документацию
Base /search Auth Bearer token Format application/json URL https://api.nebula.bot.cd
✦ Один endpoint

Все запросы отправляются методом POST на /search с JSON-телом.

⌁ Быстрые ответы

Оптимизированные запросы и стабильная работа.

⬡ Авторизация Bearer

Каждый запрос защищён API-ключом.

Начало работы

Получение API ключа

Для получения API ключа напишите в личные сообщения.

Как получить ключ?

Для получения API ключа напишите в личные сообщения:

@thremorr

📌 Инструкция:

  1. 1. Напишите @thremorr в Telegram
  2. 2. Укажите желаемый срок действия ключа
  3. 3. Получите готовый API ключ
⚠️ Ключи выдаются вручную. Пожалуйста, дождитесь ответа.
Безопасность

Авторизация

Передавайте API-ключ в заголовке Authorization при каждом запросе.

AUTH Authorization: Bearer YOUR_API_KEY

Храните ключ на сервере в переменных окружения и никогда не встраивайте в публичный интерфейс или открытые репозитории.

API Reference

Основной endpoint

Обязательный endpoint — все запросы отправляются сюда с JSON-телом.

POST https://api.nebula.bot.cd/search

POST /search — все запросы отправляются на этот endpoint с JSON телом.

method: POST · content-type: application/json · auth: Bearer

cURL · POST /search 
curl -X POST https://api.nebula.bot.cd/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"phone": "+79001234567"}'
i

Для тестирования замените YOUR_API_KEY на свой секретный ключ. Не публикуйте его в клиентском коде или открытых репозиториях.

Поиск

поиск по телефону

phone phone
cURL 
curl -X POST https://api.nebula.bot.cd/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_..." \
  -d '{"phone": "+79001234567"}'
phone

номер телефона в международном формате (+79001234567)

Поиск

поиск по email

email email
cURL 
curl -X POST https://api.nebula.bot.cd/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"email": "user@mail.ru"}'
email

email адрес пользователя

Поиск

поиск по никнейму

nick nick
cURL 
curl -X POST https://api.nebula.bot.cd/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"nick": "username"}'
nick

никнейм или логин пользователя

Поиск

поиск по имени

name name
cURL 
curl -X POST https://api.nebula.bot.cd/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"name": "Иван"}'
name first_name last_name fio fullname

различные варианты параметров для поиска по имени пользователя

Поиск

поиск по Telegram

telegram telegram
cURL 
curl -X POST https://api.nebula.bot.cd/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"telegram": "@username"}'
telegram telegram_id username

поиск по username или ID Telegram

Поиск

поиск по VK

vk vk
cURL 
curl -X POST https://api.nebula.bot.cd/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"vk": "id123456789"}'
vk vk_id

поиск по ID пользователя VK (id123456789 или 123456789)

Результат

пример ответа API

При успешном запросе API возвращает JSON с найденными записями.

200 · application/json 
{
  "status": "success",
  "data": {
    "found": true,
    "records": [
      { "info": "..." }
    ]
  }
}
Поле Описание
status success / error
data объект с результатами поиска
records массив найденных записей