Продавцы

Поиск продавца

GET /sellers требует хотя бы один идентифицирующий параметр: tin (ИНН), psrn (ОГРН/ОГРНИП), url (ссылка на магазин) или пару marketplace+seller_id.

curl -G -H "Authorization: Bearer mn_live_..." \
  "https://data.marketninja.ru/v1/sellers" \
  --data-urlencode "tin=7722774359"

{
  "data": [
    {
      "marketplace": "wildberries",
      "seller_id": "2557",
      "name": "Sport Point",
      "tin": "7722774359",
      "psrn": "1127746307754",
      "address": "117638, город Москва, ...",
      "url": "https://www.wildberries.ru/seller/2557",
      "stats": { "rating": 4.7, "items_sold": 1347240 },
      "product_count": 478
    }
  ]
}

Ссылка на магазин тоже работает как идентификатор, с автоматической очисткой query-параметров (UTM-меток и т. п.) — так же, как url в GET /products:

curl -G -H "Authorization: Bearer mn_live_..." \
  "https://data.marketninja.ru/v1/sellers" \
  --data-urlencode "url=https://www.wildberries.ru/seller/2557"

Получение полного каталога продавца

Найдя продавца, используйте его marketplace+seller_id как фильтр в GET /products, чтобы получить весь его текущий ассортимент:

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

Поле product_count в ответе GET /sellers — это то же самое число, которое вы получите, если пройдёте по всем страницам GET /products с этим фильтром: удобно сверять, что вы собрали весь каталог, не пропустив ни одной страницы.

Аудит продавца

Типичный сценарий: узнать, реальный ли это продавец (дата регистрации, объём продаж через stats), под каким ИНН он зарегистрирован, и весь ли его текущий ассортимент соответствует ожиданиям (например, сверка с реестром авторизованных дилеров бренда).