Sellers

Finding a seller

GET /sellers requires at least one identifying parameter: tin (tax id), psrn (state registration number), url (storefront URL), or marketplace+seller_id together.

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
    }
  ]
}

A storefront URL works as an identifier too, with the same automatic query-parameter stripping (UTM tags, etc.) as url in GET /products:

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

Getting a seller's full catalog

Once you've found a seller, use their marketplace+seller_id as a filter on GET /products to pull their entire current assortment:

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"

The product_count field on the GET /sellers response is the same number you'd get by paging through all of GET /products with that filter — a handy check that you've collected the whole catalog without missing a page.

Auditing a seller

A typical use case: confirming a seller is legitimate (registration date, sales volume via stats), which TIN they're registered under, and whether their current assortment matches expectations (e.g. reconciling against a brand's list of authorized dealers).