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

Поиск в интернете

Доступно только на платных тарифах

Поиск в интернете по заданному запросу. Возвращает подходящие страницы с заголовком, ссылкой и фрагментом текста. Подходит для RAG-сценариев и работы AI-агентов.

POST
https://ai.wormsoft.ru/api/search/v1/web

Структура запроса

  • Обязательное поле query — поисковый запрос.
  • Обязательное поле max_results — лимит количества результатов, прокидывается напрямую провайдеру.

Минимальный пример запроса

curl --request POST \
  --url https://ai.wormsoft.ru/api/search/v1/web \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "NestJS dependency injection"
  }'

Ограничение количества результатов

Поле max_results управляет тем, сколько страниц вернёт провайдер. Если поле не передано — используется значение по умолчанию на стороне провайдера.

{
  "query": "Последние новости про SpaceX",
  "max_results": 5
}

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

Ответ содержит массив results с найденными страницами.

{
  "results": [
    {
      "title": "Провайдеры | NestJS — A progressive Node.js framework",
      "url": "https://docs.nestjs.com/providers",
      "content": "В NestJS внедрение зависимостей (Dependency Injection) реализовано через декораторы @Injectable() и конструктор классов. Контейнер IoC автоматически создаёт экземпляры провайдеров и внедряет их в контроллеры и сервисы при запуске приложения."
    },
    {
      "title": "Dependency Injection в NestJS: как это работает под капотом",
      "url": "https://habr.com/ru/articles/nestjs-di",
      "content": "Разбор того, как контейнер IoC в NestJS резолвит зависимости: scope-ы провайдеров (DEFAULT, REQUEST), использование @Inject для токенов, кастомные провайдеры через useFactory и useClass."
    }
  ]
}

Тарификация

  • Стоимость запроса зависит от количества найденных результатов и рассчитывается как: 3 000 кредитов × N, где N— число элементов в массиве results.
  • Кредиты списываются с буста и лимита подписки
  • При нехватке кредитов остаток уходит в долг
  • Списание происходит только при успешном ответе провайдера

Ошибки

403
Запрос на бесплатном (БАЗОВЫЙ) тарифе.
429
Закончились лимиты подписки
500 +
Ошибка на стороне нашего сервиса