Товары по id и URL

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

Товар по ID

GET/api/{uuid}/find-by-id

uuid проектДемо-проект SearchBooster. Подставьте UUID своего проекта из личного кабинета.idОдин товар → ответ {"offer": …}idsНесколько через запятую → {"offers": […]}regionId

Помимо обычных полей, возвращаются description, все характеристики params с единицами измерения и regions — цены и наличие во всех регионах. Если товар не найден — 404.

Товар по URL

Удобно, когда на странице есть только адрес — например, в браузерном расширении или при разборе ссылок из рассылки.

curl 'https://api.searchbooster.net/api/{uuid}/find-by-url?url=https%3A%2F%2Fshop.ru%2Fp%2F110166'

Ссылка нормализуется перед сравнением, поэтому мелкие отличия от url в фиде (например, протокол или слеш в конце) не мешают найти товар. 400 — не передан или некорректный url, 404 — товар не найден.

Варианты одной модели

Все варианты (размеры, цвета) одной группы group_id, до 1 000 штук:

curl -G 'https://api.searchbooster.net/api/{uuid}/grouped' \
  --data-urlencode 'id=1101' \
  --data-urlencode 'params={"Цвет":"белый"}'

id — значение group_id из фида (не ID товара). params — JSON-объект «параметр → значение» для выбранных опций. В ответе у каждого варианта есть groupedParams (все значения опций в группе) и selectedGroupedParams (значения этого варианта) — этого достаточно для переключателя «цвет / размер» на карточке.

Дерево категорий

GET/api/{uuid}/settings

uuid проектДемо-проект SearchBooster. Подставьте UUID своего проекта из личного кабинета.parentIdДочерние категории указаннойlevelУровень вложенности, 0 — кореньmaxLevelГлубина (по умолчанию 10)

Категории в ответе — в порядке nested set (lft/rgt): дерево строится за один проход. Используйте для меню каталога и фильтра по категориям.

Выдача по нескольким категориям сразу

Блоки «Найдено в категориях» с товарами для каждой — одним запросом:

GET/api/{uuid}/search/structure-by-category

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

Ответ — {"categories": {"8145": <ответ /search>, "8144": …}}. Принимает все параметры /search.