API

DeepResearch

Многошаговые агентные исследования: сервис сам ищет источники, читает их, сопоставляет факты и собирает готовый ответ со ссылками. Один синхронный запрос — соединение держится открытым, пока идёт исследование.

POSThttps://srezai.ru/api/v1/deep

Синхронный вызов на 10 сек – 2 мин

В отличие от обычного поиска, исследование идёт от десяти секунд до двух минут. Соединение держится открытым до готового ответа — задайте на клиенте таймаут не меньше 180 секунд.

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

curl -X POST https://srezai.ru/api/v1/deep \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer srz_live_ВАШ_КЛЮЧ" \
  -d '{ "query": "рынок электромобилей в России в 2026 году" }'

Параметры тела#

querystringrequired

Вопрос или тема исследования. Пробелы схлопываются, обрезается до 2000 символов. Пустой запрос вернёт 400.

Ответ#

json

{
  "answer": "# Рынок электромобилей в России в 2026 году\n\nПо итогам…",
  "sources": [
    { "title": "Обзор рынка EV — 2026", "url": "https://example.ru/ev-2026" },
    { "title": "example.ru", "url": "https://example.ru/stats" }
  ],
  "tookMs": 84210
}

Поля ответа#

answerstringoptional

Готовый ответ в Markdown — структурированный текст с выводами. Можно сразу рендерить или передавать в LLM как контекст.

sourcesarrayoptional

Использованные источники. Каждый — title и url.

tookMsnumberoptional

Время выполнения исследования в миллисекундах.

Доступно и по MCP

Тот же движок доступен как инструмент deep_research на MCP-сервере — подключается к ИИ-агенту без ручной интеграции REST.

Коды ошибок (401, 400, 429, 503) описаны в разделе Ошибки.