使用场景
卖家
按税号、统一社会信用代码或店铺链接查找卖家，以及如何获取其完整商品目录。
查找卖家
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
}
]
}响应始终是一个数组，而不是单个对象。同一个法人主体（同一个税号）可能同时在多个市场平台上以不同的
seller_id 经营——所有匹配结果都会一并返回。店铺链接同样可以作为识别参数使用，并会像 GET /products 的 url 一样自动去除查询参数
（UTM 标记等）：
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"GET /sellers 响应中的 product_count 字段，与您用该筛选条件翻遍 GET /products 全部
分页所得到的数量一致——可以用它来检查您是否已经取完了整个商品目录，没有漏掉任何一页。
核查卖家
一个典型用例：确认某个卖家的合法性（注册时间、通过 stats 反映的销量），核对其注册的税号，
以及核实其当前商品目录是否符合预期（例如与品牌方的授权经销商名单进行比对）。
Last updated on