Поиск товаров

Как найти товар по ссылке, артикулу маркетплейса, собственному артикулу продавца или бренду — четыре реальных сценария с примерами.

GET /products — единственная точка входа, если вы ещё не знаете внутренний id товара (см. Обзор API про модель «найти → получить»). Ниже — четыре реальных сценария использования, каждый со своим набором параметров.

Сценарий 1: у вас есть ссылка на товар

Самый частый случай — ссылка скопирована прямо из браузера или взята из таблицы.

curl -G -H "Authorization: Bearer mn_live_..." \
  "https://data.marketninja.ru/v1/products" \
  --data-urlencode "url=https://www.wildberries.ru/catalog/231151629/detail.aspx?utm_source=instagram"

Query-параметры и фрагмент (?utm_source=..., #reviews и т. п.) отбрасываются перед сравнением автоматически — можно передавать ссылку как есть, с любым мусором в конце. Ссылка с utm_source и та же ссылка без него найдут один и тот же товар.

Сценарий 2: вы знаете артикул маркетплейса

Если у вас есть SKU конкретного маркетплейса (WB nmId, Ozon sku и т. п.) — передавайте его вместе с marketplace, иначе результат может быть неоднозначным (один и тот же external_id теоретически возможен на разных площадках).

curl -G -H "Authorization: Bearer mn_live_..." \
  "https://data.marketninja.ru/v1/products" \
  --data-urlencode "external_id=231151629" \
  --data-urlencode "marketplace=wildberries"

Сценарий 3: вы знаете артикул продавца

Это отдельный параметр — seller_code — не путайте с external_id (это наш SKU маркетплейса, а seller_code — ваш собственный, тот, что продавец указывает в своей карточке товара). Типичная задача: «найти мой артикул везде, где он продаётся», поэтому параметр специально не требует обязательной пары с seller_id — если ваш товар перепродаёт несколько продавцов, вы увидите все совпадения.

curl -G -H "Authorization: Bearer mn_live_..." \
  "https://data.marketninja.ru/v1/products" \
  --data-urlencode "seller_code=BV2648-010"

Если нужно ограничиться товарами именно одного продавца — добавьте seller_id (и, по желанию, marketplace):

curl -G -H "Authorization: Bearer mn_live_..." \
  "https://data.marketninja.ru/v1/products" \
  --data-urlencode "seller_code=BV2648-010" \
  --data-urlencode "seller_id=2557" \
  --data-urlencode "marketplace=wildberries"

Сценарий 4: нужен весь ассортимент бренда

Это отдельный параметр — brand — не путайте со сценарием 3: seller_code находит конкретный ваш SKU у всех, кто его перепродаёт, а brand находит весь ассортимент бренда в датасете, независимо от артикулов, точным совпадением без учёта регистра. Список доступных названий брендов и примеры — в разделе Бренды.

Другие способы фильтрации

GET /products поддерживает и более широкий поиск — например, по названию (q) или категории (category, совпадение по вхождению в category_path — список категорий конкретного маркетплейса и полное руководство по фильтру см. в Категориях). Полный список параметров — в Справочнике.

Что делать с результатом

Ответ уже содержит текущую цену, изображения, характеристики, статус доверия и данные продавца — для большинства сценариев отдельный запрос GET /products/{id} не нужен. Обращайтесь к нему напрямую по id, только если вам нужно гарантированно свежее состояние в отдельный момент времени, отдельно от результата поиска.