AI-функции

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

beta

Превращает запрос на естественном языке в намерение и структурированные фильтры: «белая собака до 5000» → цвет = белый, цена ≤ 5000. Используйте, чтобы автоматически выставить фильтры, выбрать сценарий (поиск, сравнение, консультация) или переписать запрос.

POST/api/v2/{uuid}/query-understanding

uuid проектДемо-проект SearchBooster. Подставьте UUID своего проекта из личного кабинета.Тело запроса JSON

Поле ответа	Описание
`intent`	`product_search`, `filter_search`, `navigation`, `advice`, `comparison` или `empty`.
`confidence`	Уверенность 0–1.
`rewrite`	Переписанный запрос.
`filters`	`categoryId`, `brandId`, `price.min/max`, `color`, `size`, `material`, `volume`, `attrs` — готовые значения для фильтров.
`should_boosts`	Поля и значения, которые стоит поднять в ранжировании.

AI-резюме выдачи

по запросу

Короткий текст над результатами: «Нашлось 24 самоеда, в основном щенки 2–4 месяцев, цены от 960 ₽». Передайте запрос и товары, которые показываете пользователю (до 40):

curl -X POST 'https://api.searchbooster.net/api/{uuid}/generate-search-digest' \
  -H 'Content-Type: application/json' \
  -d '{"query":"самоед","offers":[{"id":"110166","name":"Самоедская собака 1","price":960,"currency":"RUB","category":"Самоедская собака","available":true}]}'

{ "query": "самоед", "relevant": true, "digest": "…", "meta": { "model": "…", "cacheHit": false, "latencyMs": 820 } }

relevant: false — товары плохо соответствуют запросу; резюме лучше не показывать.
Ответ кэшируется на 6 часов; refresh: true пересчитывает его.
Функция включается для проекта по запросу. Если она выключена, метод вернёт 404.

Нейроотзывы

по запросу

Сводка по отзывам о товаре: краткий вывод и плюсы/минусы по характеристикам.

curl 'https://api.searchbooster.net/api/{uuid}/neuro-reviews?productId=110166'

{
  "product": { "id": "110166", "name": "…", "price": 960 },
  "summary": { "title": "Что говорят покупатели", "text": "…" },
  "opinions": {
    "characteristics": [{ "key": "temper", "title": "Характер", "pros": ["дружелюбный"], "cons": ["много линяет"] }]
  },
  "meta": { "status": "ready", "updatedAt": "2026-10-10T12:00:00Z" }
}

meta.status: ready — показывайте; processing — сводка готовится, повторите позже; no_data — отзывов недостаточно; not_found — функция не включена или товара нет.