Перейти к содержимому
SearchBooster Docs

Стартовый экран

Пустое окно поиска — потерянная возможность. Покажите в нём историю запросов пользователя, популярные запросы и товары: так поиск помогает даже тем, кто ещё не знает, что искать.

История и популярные запросы

Заголовок раздела «История и популярные запросы»

Вызовите /v2/completions с пустым query. В searchBox придут элементы с label: "history" (если передан userId), "popular" и "brands".

GET/api/v2/{uuid}/completions
  1. Передавайте userId в /search. История копится из поисковых запросов этого пользователя (последние 50).
  2. Используйте тот же userId в /completions. Значение — из cookie searchbooster_v2_user_id, которую ставят трекер и поисковый виджет, или ваш собственный стабильный ID посетителя.
  3. Дайте удалить историю. Кнопка «Очистить» вызывает DELETE /api/{uuid}/history?userId=…; чтобы удалить одну запись, добавьте &completion=<текст запроса>.
Окно терминала
curl -X DELETE 'https://api.searchbooster.net/api/{uuid}/history?userId=docs-demo-user'
# {"removed": 5}

Популярные товары

Заголовок раздела «Популярные товары»

Подходят и для стартового экрана, и для страницы «Ничего не найдено»:

GET/api/{uuid}/popular

Популярность считается по событиям покупок, корзин и просмотров за последние недели. Чтобы она была точной, подключите трекер.

«Ничего не найдено»

Заголовок раздела ««Ничего не найдено»»

Если hits равен 0:

  1. Покажите исправленный запрос или suggestions («Возможно, вы искали»), если они есть.
  2. Ниже — популярные товары (/popular) или виджет рекомендаций.
  3. Посмотрите, какие запросы чаще всего не находят товары, в статистике поиска в личном кабинете — и заведите для них синонимы или правила.