Быстрый старт

1. Создайте проект. Зарегистрируйтесь в личном кабинете и добавьте проект: адрес сайта и ссылку на товарный фид. Индексация небольшого каталога занимает несколько минут.

2. Скопируйте UUID проекта. Он есть в настройках проекта и в коде виджета — это ключ для всех запросов к API.

3. Сделайте первый запрос. Ниже — демо-проект. Вставьте свой UUID в поле uuid, и все примеры на сайте документации будут работать с вашим каталогом.

   GET/api/{uuid}/search

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

   cURLJavaScriptPHPPythonКопировать

   Отправить запрос⌘↵

4. Подключите выдачу на сайт.

   Виджет — без программирования

   В личном кабинете откройте Виджет, укажите CSS-селектор поля поиска и вставьте код в <head>. Подробнее — Поисковый виджет.

   API — своя вёрстка

   const UUID = 'ваш-uuid';
   const userId = document.cookie.match(/(?:^|; )searchbooster_v2_user_id=([^;]*)/)?.[1] ?? crypto.randomUUID();
   
   const res = await fetch(
     `https://api.searchbooster.net/api/${UUID}/search?` +
       new URLSearchParams({ query: 'самоед', limit: '24', userId, client: 'desktop' }),
   );
   const { offers, hits, params, redirect } = await res.json();

   Дальше: фильтры, подсказки, пагинация.

5. Установите трекер — для персонализации и статистики:

   <script defer src="https://cdn2.searchbooster.net/scripts/tracker/PROJECT_UUID/searchbooster.js"></script>

Чек-лист перед запуском

• Фид проходит проверку без ошибок.
• Во все запросы передаётся один и тот же userId.
• Для магазинов с регионами передаётся regionId (подробнее).
• Обрабатывается redirect из ответа поиска.
• Клики и покупки уходят в события (или стоит трекер).