Official Categories

Retrieve the official category tree for a marketplace shop. Supports 1688 and Weidian (weidian requires shop_id).

GEThttps://open.hiobuy.com/api/client/open-purchase/category/item

If your deployment uses a different base URL, replace `https://open.hiobuy.com` accordingly.

Request headers

Name	Required	Type	Description
`X-Uuid`	Yes	string	Merchant UUID assigned to your account

Query parameters

Name	Required	Type	Description
`platform`	Yes	string	Marketplace: `taobao`, `1688`, `weidian`
`shop_id`	No	string	Shop ID. Required when `platform` is `weidian`
`categoryId`	No	string	Parent category ID to load children. Omit to fetch the full tree

Example request

GET /api/client/open-purchase/category/item?platform=1688

For Weidian:

GET /api/client/open-purchase/category/item?platform=weidian&shop_id=YOUR_SHOP_ID

Sample response

{
  "ret": 1,
  "msg": "操作成功",
  "data": [
    {
      "id": 0,
      "name": "未分类",
      "children": []
    },
    {
      "id": 153155016,
      "name": "女装",
      "children": [
        {
          "id": 153155017,
          "name": "睡衣"
        },
        {
          "id": 153155049,
          "name": "打底裤"
        }
      ]
    },
    {
      "id": 153156429,
      "name": "男装",
      "children": [
        {
          "id": 153156430,
          "name": "羽绒服"
        },
        {
          "id": 153191807,
          "name": "T恤"
        }
      ]
    }
  ]
}

The live `data` array can be large; only a few categories are shown below.

Response fields

Top level

Name	Type	Description
`ret`	number	Status code. `1` indicates success
`msg`	string	Status message
`data`	object	Official category tree

`data[]`

Name	Type	Description
`id`	number	Category ID. `0` means uncategorized
`name`	string	Category display name
`children`	array	Child categories. Empty array if none

`data[].children[]`

Name	Type	Description
`id`	number	Child category ID
`name`	string	Child category name