От ключа
до первого ответа.

Один запрос — структурированные данные, готовый текст и ссылка на полный отчёт.

Подписка или отдельные запросы

У подписок API нет ограничения общего количества запросов. Ограничения частоты сохраняются. Запросы можно покупать отдельно: 1 за $0.07, 10 за $0.70 или 50 за $3.50.

Ключ — в заголовке

Во всех примерах замени YOUR_API_KEY на свой ключ. При первой покупке запросов создаётся отдельный ключ с балансом; следующие покупки пополняют его.

X-API-Key: YOUR_API_KEY

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

Поиск

В query передай свой запрос, в type — его тип. Если не уверен, используй auto. Примеры ниже показывают формат запроса.

curl -X POST 'https://api.devhydra.info/v1/search' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"query":"your_username","type":"tg"}'

import os
import requests

response = requests.post(
    "https://api.devhydra.info/v1/search",
    headers={"X-API-Key": os.environ["HYDRA_API_KEY"]},
    json={"query": "your_username", "type": "tg"},
    timeout=90,
)
response.raise_for_status()
data = response.json()
print(data["formatted_text"])
print(data.get("report_url", ""))

const response = await fetch("https://api.devhydra.info/v1/search", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.HYDRA_API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ query: "your_username", type: "tg" }),
  signal: AbortSignal.timeout(90000)
});
const data = await response.json();
if (!response.ok) throw new Error(data.detail ?? `HTTP ${response.status}`);
console.log(data.formatted_text);
console.log(data.report_url);

Для новых интеграций используй POST и заголовок ключа. GET тоже поддерживается: /v1/search?query=your_username&type=tg.

Как выбрать тип

Актуальный список доступен через GET /v1/types. Алиасы: social_id для socid, ipaddress для ip.

Как читать ответ

Для своей страницы используй smart_sections. Для готового текста — formatted_text. Для сохранения полного отчёта — report_text или HTML-ссылку.

{
  "status": "success",
  "query": "your_username",
  "search_type": "tg",
  "timed_out": false,
  "smart_sections": [
    {
      "title": "Профиль",
      "kv": [{"k": "Имя", "v": "Пример"}],
      "chips": []
    }
  ],
  "formatted_text": "Пример отображения результата",
  "report_url": "https://report.devhydra.info/REPORT_ID.html",
  "report_expires_at": 1791700000,
  "report_text": "Полный текст отчёта",
  "elapsed_seconds": 4.2
}

HTML, TXT и PDF

report_url ведёт на отдельный сайт report.devhydra.info. Ссылка действует 45 минут. report_expires_at — время окончания в Unix-секундах.

Открой HTML-отчёт и нажми «Сохранить PDF». Для TXT сохрани строку report_text в UTF-8. В боте и приложениях есть кнопки HTML-отчёта и сохранения TXT.

Проверить ключ и остаток

curl 'https://api.devhydra.info/v1/key/status' \
  -H 'X-API-Key: YOUR_API_KEY'

limit — общее количество купленных запросов, used — использованное, remaining — остаток. Для подписки limit: 0 означает отсутствие общего лимита, а remaining: null — не нулевой баланс. expires_at показывает срок доступа.

При полностью потраченном балансе метод возвращает 429 с сообщением о лимите. Пополни запросы в зеркале HYDRA, чтобы продолжить с тем же ключом.

Ошибка → действие

Обычная ошибка имеет вид {"detail":"Описание ошибки"}. Для поиска оставляй до 90 секунд ожидания. Если соединение оборвалось, запрос мог продолжить выполняться — не отправляй сразу десятки копий.

Основные методы