Market NinjaMarket Ninja
方法

列出类目

GET
/categories

marketplace 为必填——不同平台的类目体系各不相同，如果不限定平台，列表会把互不 相关的层级结构混在一起。

该接口不计入每日数据配额——只受每分钟请求频率限制约束。它是用于筛选前导航的 查询类接口，不属于数据导出，因此不会返回 quota_exceeded。

这是每日预先计算好的快照，而不是实时查询——数据相较于当天新抓取的内容最多 可能有 24 小时的延迟。

Authorization

bearerAuth
AuthorizationBearer <token>

Bearer 令牌——获取和使用方法请参阅文档中的「API 概览」页面。

In: header

Query Parameters

marketplace?string

Value in

  • "ozon"
  • "wildberries"
  • "yandex_market"
  • "lamoda"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/categories?marketplace=wildberries"
{  "data": [    {      "category_path": [],      "product_count": 11197    },    {      "category_path": [        "Зоотовары",        "Фермерство"      ],      "product_count": 455    },    {      "category_path": [        "Обувь",        "Мужская",        "Кеды и кроссовки"      ],      "product_count": 37    }  ]}

列出品牌 GET

与 `GET /categories` 不同，这里的 `marketplace` 是可选的——品牌在不同市场平台上 指的是同一个真实实体，因此不限定平台的列表（品牌在所有平台上的总覆盖情况）本身就 有意义，这与不限定平台的类目列表不同——后者会把互不相关的各平台分类体系混在一起。 该接口不计入每日数据配额——只受每分钟请求频率限制约束。它是用于筛选前导航的 查询类接口，不属于数据导出，因此不会返回 `quota_exceeded`。 这是每日预先计算好的快照，而不是实时查询——数据相较于当天新抓取的内容最多 可能有 24 小时的延迟。

按 ID 获取商品 GET

`id` 是我们自己的内部标识符（一个 UUID），不是市场平台的 SKU。获取它的唯一途径是 调用 `GET /products`（通过 `url`、`external_id`+`marketplace`，或 `seller_code`）——外部无法提前得知它。