类目 | 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