類目 | Market Ninja

列出單一電商平台的類目，並透過 category 篩選參數取得某個類目的完整商品集合。

列出類目

GET /categories 會回傳單一電商平台去重後的 category_path 清單，並附上每個類目對應的商品數量。與 GET /brands 不同，這裡的 marketplace 是必填的——不同電商平台的類目體系各不相同，如果不限定平台，清單會把互不相關的層級結構混在一起。

GET /categories 和 GET /brands 不計入每日資料配額——僅受每分鐘請求頻率限制約束。它們是用於導覽的查詢端點，不屬於資料匯出，因此可以放心呼叫，無需擔心配額消耗。

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

{
  "data": [
    { "category_path": [], "product_count": 11197 },
    { "category_path": ["Зоотовары", "Фермерство"], "product_count": 455 },
    { "category_path": ["Обувь", "Мужская", "Кеды и кроссовки"], "product_count": 37 }
  ]
}

回應中的空 category_path: [] 代表完全沒有類目的商品，而不是層級結構的根節點。如果您要加總各類目的商品數量，請不要自動忽略這一列。

取得某個類目的商品集合

將取得的 category_path 作為 GET /products 的 category 篩選參數——它依包含關係比對，可以比對層級中的任意深度，不僅僅是最後一層。

curl -G -H "Authorization: Bearer mn_live_..." \
  "https://data.marketninja.ru/v1/products" \
  --data-urlencode "marketplace=wildberries" \
  --data-urlencode "category=Обувь" \
  --data-urlencode "page_size=100"

Обувь 既能比對 ["Обувь", "Мужская", "Кеды и кроссовки"]，也能比對 ["Обувь", "Женская", "Туфли и лоферы"]，以及任何在任意層級出現 "Обувь" 的分支——如果您想取得整個頂層類別而不想逐一列出所有子類目，這會很方便。如果只想取得某一個特定分支，請傳入更具體的路徑，例如 Кеды и кроссовки。

category 是包含關係篩選，而不是對整個路徑的精確比對。如果資料集中同時存在 ["Обувь"] 和 ["Спорт", "Обувь для бега"]，兩者都會比對到 category=Обувь。如果您需要的是某一個特定分支，請使用它最具體（最後一層）的部分——這樣與其他分支重疊的可能性較小。

分頁走訪大型類目

對於商品數量達數千筆的頂層類目，請使用最大 page_size 分頁走訪——這與完整匯出資料集所用的模式相同，參閱批次匯出。

您也可以在同一個請求中加上 brand 參數，將範圍進一步縮小到某個品牌；或者直接查找某個品牌的完整商品集合，參閱品牌。

類目

列出類目

取得某個類目的商品集合

分頁走訪大型類目

On this page