AI-каталог

AI-каталог — это виджет рекомендаций, который ведёт себя как полноценная категория: возвращает сотни товаров с пагинацией, фасетами и общим количеством, но сортирует их под интересы конкретного посетителя.

Где используют: персональная главная, «Рекомендуем для вас» с бесконечной лентой, персональная сортировка категории, главный экран мобильного приложения.

GET/api/{uuid}/widgets/{widgetId}

uuid проектДемо-проект SearchBooster. Подставьте UUID своего проекта из личного кабинета.widgetIdpathID виджета AI-каталога из личного кабинета (здесь — встроенный персональный)userIdcategoryIdПерсональная выдача внутри категорииlimitoffsetparams

Отличия от обычного виджета

	Виджет рекомендаций	AI-каталог
Товаров	до 100	весь подходящий каталог
Пагинация	—	`limit` + `offset`
Фасеты `params` в ответе	—	✓
`hits`	—	✓
Интеграция	`<sb-widget>` или API	только API

Интеграция

Создайте в личном кабинете виджет типа «Персональные» в режиме каталога и скопируйте его ID.
Запросите первую страницу: GET /widgets/{id}?userId=…&limit=24&offset=0.
Отрисуйте offers, панель фильтров из params (как) и пагинацию из hits.
Следующая страница — offset = (страница − 1) × limit; при смене фильтров начинайте с offset=0.
Отправляйте show и click в аналитику виджетов — по ним считается эффективность.

Параметр	Описание
`userId`	Обязателен для персонализации. Без него — выдача по популярности.
`categoryId`	Персональная выдача внутри категории.
`limit`, `offset`	Пагинация.
`params`, `paramKey`	Фильтры — как в поиске, или набор, сохранённый в виджете.
`regionId`, `withNotAvailable`, `segmentId`	Регион, товары не в наличии, сегмент.
`withSort`	По умолчанию выдача слегка перемешивается, чтобы лента не была одинаковой при каждом визите; `withSort=true` отключает это.