使用情境
賣家
依稅號、國家註冊碼或店鋪連結查找賣家，以及如何取得其完整商品目錄。
查找賣家
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