1688 categories

Use category_ids on 1688 keyword search to filter by category (Taobao ignores this field). Developers only need the category ID and name.

Node fields

Full tree: data/1688-categories.json (~12k nodes). Upstream noise removed; each node keeps:

Field	Description
`id`	Category ID (string). Pass to search `category_ids`
`name`	English name
`cn`	Chinese name (omitted when identical to `name`)
`children`	Child categories; absent on leaf nodes

Usage

POST /v1/products/search
{
  "channel": "1688",
  "keyword": "phone case",
  "category_ids": "1033104,1033105"
}

Level-1, level-2, or leaf IDs are accepted; separate multiple IDs with commas.
Taobao does not support category filters; the field is ignored.

Structure example (truncated)

[
  {
    "id": "67",
    "name": "Office, culture",
    "cn": "办公、文化",
    "children": [
      {
        "id": "81",
        "name": "Writing Tools",
        "cn": "书写工具",
        "children": [
          {
            "id": "1033104",
            "name": "Other Pens",
            "cn": "其他笔类"
          },
          {
            "id": "1033105",
            "name": "Pen Accessories",
            "cn": "笔配件"
          },
          {
            "id": "1033107",
            "name": "marker pen",
            "cn": "记号笔"
          }
        ]
      }
    ]
  }
]

Top-level categories

Download the full three-level tree: 1688-categories.json. Quick reference for level-1:

ID	Chinese	English
`67`	办公、文化	Office, culture
`54`	服饰配件、饰品	Clothing accessories, accessories
`18`	运动户外	Sports Outdoor
`7`	数码、电脑	Digital, Computer
`1813`	玩具	Toys
`10166`	女装	Women’s Clothing
`201547901`	收纳清洁用具	Storage cleaning appliance
`201547801`	日用餐厨饮具	Daily food, kitchen and drinking utensils
`122916002`	汽车用品	Automotive Supplies
`6`	家用电器	Household appliances
`59`	五金、工具	Hardware, tools
`96`	家纺家饰	Home Textile Home Decoration
`68`	包装	Packaging
`58`	灯饰照明	Lighting
`1042954`	箱包皮具	luggage and leather goods
`312`	内衣	Underwear
`1038378`	鞋	Shoes
`122916001`	宠物及园艺	Pets and Gardening
`13`	家装建材	Home improvement building materials
`97`	美容护肤/彩妆	Beauty skin care/makeup
`10165`	男装	Menswear
`311`	童装	Children’s clothing
`15`	居家日用品	Home daily necessities
`5`	电工电气	Electrician Electrical
`70`	安全、防护	Safety, protection
`130822220`	个护/家清	A guard/home clear
`130823000`	成人用品	Adult Supplies
`130822002`	餐饮生鲜	Catering Fresh
`2`	食品酒水	Food Drinkers
`10208`	仪器仪表	Instrumentation
`123614001`	钢铁	Steel
`201346017`	建材	Building Materials
`12`	交通运输	Transportation
`1426`	机床	Machine tools
`55`	橡塑	Rubber and Plastic
`57`	电子元器件	Electronic components
`4`	纺织、皮革	Textile, leather
`65`	机械及行业设备	Machinery and industry equipment
`66`	医药、保养	Medicine, maintenance
`509`	通信产品	Communication Products
`71`	汽摩及配件	Auto Parts and Accessories
`72`	印刷	Printing
`1`	农业	Agriculture
`10`	能源	Energy
`9`	冶金矿产	metallurgical mineral
`8`	化工	Chemical
`64`	环保	Environmental protection
`202052814`	新能源	new energy
`51`	代理	Agent
`2805`	加工	Processing
`69`	商务服务	Business Services
`2829`	二手设备转让	Transfer of used equipment
`53`	传媒、广电	Media, Radio and Television
`73`	项目合作	Project cooperation