cat_get-获得淘宝分类详情 注册开通
onebound.taobao.cat_get
公共参数
名称 | 类型 | 必须 | 描述 |
key | String | 是 | 调用key（必须以GET方式拼接在URL中） |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes，将调用缓存的数据，速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言，默认cn简体中文 |
version | String | 否 | API版本 |
请求参数
请求参数：cid=0
参数说明：cid:商品分类ID，可以用cid=0来获得所有一级类目
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
info | Mix | 0 | 分类信息 | |
item | Mix | 0 | 子分类id:子分类名称 |
请求示例
- Curl
- PHP
- PHPsdk
- JAVA
- C#
- Python
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/cat_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&cid=0"响应示例
"items": {
"item": [
{
"id": "1",
"pid": "0",
"root_id": "0",
"name": "游戏话费",
"note": "virtual"
},
{
"id": "2",
"pid": "0",
"root_id": "0",
"name": "服装鞋包",
"note": "virtual"
},
{
"id": "3",
"pid": "0",
"root_id": "0",
"name": "手机数码",
"note": "virtual"
},
{
"id": "4",
"pid": "0",
"root_id": "0",
"name": "家用电器",
"note": "virtual"
},
{
"id": "5",
"pid": "0",
"root_id": "0",
"name": "美妆饰品",
"note": "virtual"
},
{
"id": "6",
"pid": "0",
"root_id": "0",
"name": "母婴用品",
"note": "virtual"
},
{
"id": "7",
"pid": "0",
"root_id": "0",
"name": "家居建材",
"note": "virtual"
},
{
"id": "8",
"pid": "0",
"root_id": "0",
"name": "百货食品",
"note": "virtual"
},
{
"id": "9",
"pid": "0",
"root_id": "0",
"name": "运动户外",
"note": "virtual"
},
{
"id": "10",
"pid": "0",
"root_id": "0",
"name": "文化玩乐",
"note": "virtual"
},
{
"id": "13",
"pid": "0",
"root_id": "0",
"name": "汽配摩托",
"note": "virtual"
},
{
"id": "98",
"pid": "0",
"root_id": "0",
"name": "包装",
"note": ""
},
{
"id": "2128",
"pid": "0",
"root_id": "0",
"name": "已删除",
"note": ""
},
{
"id": "50004958",
"pid": "0",
"root_id": "0",
"name": "移动/联通/电信充值中心",
"note": ""
},
{
"id": "50007216",
"pid": "0",
"root_id": "0",
"name": "鲜花速递/花卉仿真/绿植园艺",
"note": ""
},
{
"id": "50008075",
"pid": "0",
"root_id": "0",
"name": "餐饮美食卡券",
"note": ""
},
{
"id": "50008141",
"pid": "0",
"root_id": "0",
"name": "酒类",
"note": ""
},
{
"id": "50008907",
"pid": "0",
"root_id": "0",
"name": "手机号码/套餐/增值业务",
"note": ""
},
{
"id": "50014811",
"pid": "0",
"root_id": "0",
"name": "网店/网络服务/软件",
"note": ""
},
{
"id": "50014927",
"pid": "0",
"root_id": "0",
"name": "教育培训",
"note": ""
},
{
"id": "50017652",
"pid": "0",
"root_id": "0",
"name": "服务市场",
"note": ""
},
{
"id": "50019095",
"pid": "0",
"root_id": "0",
"name": "线下消费卡",
"note": ""
},
{
"id": "50023575",
"pid": "0",
"root_id": "0",
"name": "房产/租房/新房/二手房/委托服务",
"note": ""
},
{
"id": "50023717",
"pid": "0",
"root_id": "0",
"name": "互联网医疗/保健用品",
"note": ""
},
{
"id": "50023721",
"pid": "0",
"root_id": "0",
"name": "医疗器械",
"note": ""
},
{
"id": "50023722",
"pid": "0",
"root_id": "0",
"name": "隐形眼镜/护理液",
"note": ""
},
{
"id": "50023724",
"pid": "0",
"root_id": "0",
"name": "其他",
"note": ""
},
{
"id": "50023878",
"pid": "0",
"root_id": "0",
"name": "自用闲置转让",
"note": ""
},
{
"id": "50024153",
"pid": "0",
"root_id": "0",
"name": "计生用品",
"note": ""
},
{
"id": "50024186",
"pid": "0",
"root_id": "0",
"name": "保险",
"note": ""
},
{
"id": "50024612",
"pid": "0",
"root_id": "0",
"name": "阿里健康送药服务",
"note": ""
},
{
"id": "50025004",
"pid": "0",
"root_id": "0",
"name": "个性定制/设计服务/DIY",
"note": ""
},
{
"id": "50025110",
"pid": "0",
"root_id": "0",
"name": "电影/演出/体育赛事",
"note": ""
},
{
"id": "50025111",
"pid": "0",
"root_id": "0",
"name": "本地化生活服务",
"note": ""
},
{
"id": "50025618",
"pid": "0",
"root_id": "0",
"name": "理财",
"note": ""
},
{
"id": "50025968",
"pid": "0",
"root_id": "0",
"name": "司法拍卖拍品专用",
"note": ""
},
{
"id": "50026535",
"pid": "0",
"root_id": "0",
"name": "医疗及健康服务",
"note": ""
},
{
"id": "50026555",
"pid": "0",
"root_id": "0",
"name": "购物提货券",
"note": ""
},
{
"id": "50158001",
"pid": "0",
"root_id": "0",
"name": "网络店铺代金/优惠券",
"note": ""
},
{
"id": "50230002",
"pid": "0",
"root_id": "0",
"name": "服务商品",
"note": ""
},
{
"id": "50734010",
"pid": "0",
"root_id": "0",
"name": "资产",
"note": ""
},
{
"id": "50802001",
"pid": "0",
"root_id": "0",
"name": "数字阅读",
"note": ""
},
{
"id": "120886001",
"pid": "0",
"root_id": "0",
"name": "公益",
"note": ""
},
{
"id": "120894001",
"pid": "0",
"root_id": "0",
"name": "淘女郎",
"note": ""
},
{
"id": "120950002",
"pid": "0",
"root_id": "0",
"name": "天猫点券",
"note": ""
},
{
"id": "121266001",
"pid": "0",
"root_id": "0",
"name": "众筹",
"note": ""
},
{
"id": "121380001",
"pid": "0",
"root_id": "0",
"name": "机票/小交通/增值服务",
"note": ""
},
{
"id": "121536003",
"pid": "0",
"root_id": "0",
"name": "数字娱乐",
"note": ""
},
{
"id": "121536007",
"pid": "0",
"root_id": "0",
"name": "全球购代购市场",
"note": ""
},
{
"id": "121938001",
"pid": "0",
"root_id": "0",
"name": "淘点点预定点菜",
"note": ""
},
{
"id": "121940001",
"pid": "0",
"root_id": "0",
"name": "淘点点现金券",
"note": ""
},
{
"id": "122966004",
"pid": "0",
"root_id": "0",
"name": "处方药",
"note": ""
},
{
"id": "123500005",
"pid": "0",
"root_id": "0",
"name": "资产（政府类专用）",
"note": ""
},
{
"id": "123536002",
"pid": "0",
"root_id": "0",
"name": "阿里通信专属类目",
"note": ""
},
{
"id": "123690003",
"pid": "0",
"root_id": "0",
"name": "精制中药材",
"note": ""
},
{
"id": "124024001",
"pid": "0",
"root_id": "0",
"name": "农业生产资料（农村淘宝专用）",
"note": ""
},
{
"id": "124242008",
"pid": "0",
"root_id": "0",
"name": "智能设备",
"note": ""
},
{
"id": "124466001",
"pid": "0",
"root_id": "0",
"name": "农用物资",
"note": ""
},
{
"id": "124468001",
"pid": "0",
"root_id": "0",
"name": "农机/农具/农膜",
"note": ""
},
{
"id": "124470001",
"pid": "0",
"root_id": "0",
"name": "畜牧/养殖物资",
"note": ""
},
{
"id": "124470006",
"pid": "0",
"root_id": "0",
"name": "整车(经销商)",
"note": ""
},
{
"id": "124568010",
"pid": "0",
"root_id": "0",
"name": "室内设计师",
"note": ""
},
{
"id": "124698018",
"pid": "0",
"root_id": "0",
"name": "装修服务",
"note": ""
},
{
"id": "124750013",
"pid": "0",
"root_id": "0",
"name": "俪人购(俪人购专用)",
"note": ""
},
{
"id": "124844002",
"pid": "0",
"root_id": "0",
"name": "拍卖会专用",
"note": ""
},
{
"id": "124868003",
"pid": "0",
"root_id": "0",
"name": "盒马",
"note": ""
},
{
"id": "124912001",
"pid": "0",
"root_id": "0",
"name": "合约机",
"note": ""
},
{
"id": "125102006",
"pid": "0",
"root_id": "0",
"name": "到家业务",
"note": ""
},
{
"id": "125406001",
"pid": "0",
"root_id": "0",
"name": "享淘卡",
"note": ""
},
{
"id": "126252002",
"pid": "0",
"root_id": "0",
"name": "门店O2O",
"note": ""
},
{
"id": "126488005",
"pid": "0",
"root_id": "0",
"name": "天猫零售O2O",
"note": ""
},
{
"id": "126488008",
"pid": "0",
"root_id": "0",
"name": "阿里健康B2B平台",
"note": ""
},
{
"id": "126602002",
"pid": "0",
"root_id": "0",
"name": "生活娱乐充值",
"note": ""
},
{
"id": "126700003",
"pid": "0",
"root_id": "0",
"name": "家装灯饰光源",
"note": ""
},
{
"id": "126762001",
"pid": "0",
"root_id": "0",
"name": "美容美体仪器",
"note": ""
},
{
"id": "127076003",
"pid": "0",
"root_id": "0",
"name": "平台充值活动(仅内部店铺)",
"note": ""
},
{
"id": "127110013",
"pid": "0",
"root_id": "0",
"name": "疫苗服务",
"note": ""
},
{
"id": "127442006",
"pid": "0",
"root_id": "0",
"name": "纺织面料/辅料/配套",
"note": ""
},
{
"id": "127450004",
"pid": "0",
"root_id": "0",
"name": "金属材料及制品",
"note": ""
},
{
"id": "127452002",
"pid": "0",
"root_id": "0",
"name": "橡塑材料及制品",
"note": ""
},
{
"id": "127458007",
"pid": "0",
"root_id": "0",
"name": "搬运/仓储/物流设备",
"note": ""
},
{
"id": "127484003",
"pid": "0",
"root_id": "0",
"name": "润滑/胶粘/试剂/实验室耗材",
"note": ""
},
{
"id": "127492006",
"pid": "0",
"root_id": "0",
"name": "标准件/零部件/工业耗材",
"note": ""
},
{
"id": "127508003",
"pid": "0",
"root_id": "0",
"name": "机械设备",
"note": ""
},
{
"id": "127588002",
"pid": "0",
"root_id": "0",
"name": "阿里云云市场",
"note": ""
},
{
"id": "127876007",
"pid": "0",
"root_id": "0",
"name": "清洗/食品/商业设备",
"note": ""
},
{
"id": "127878006",
"pid": "0",
"root_id": "0",
"name": "新制造",
"note": ""
},
{
"id": "127882008",
"pid": "0",
"root_id": "0",
"name": "菜鸟驿站生活店",
"note": ""
},
{
"id": "127924022",
"pid": "0",
"root_id": "0",
"name": "零售通",
"note": ""
},
{
"id": "201136401",
"pid": "0",
"root_id": "0",
"name": "闲鱼优品",
"note": ""
},
{
"id": "201149009",
"pid": "0",
"root_id": "0",
"name": "旅行购物",
"note": ""
},
{
"id": "201156706",
"pid": "0",
"root_id": "0",
"name": "商务/设计服务",
"note": ""
},
{
"id": "201160314",
"pid": "0",
"root_id": "0",
"name": "口碑/饿了么本地生活",
"note": ""
},
{
"id": "201162107",
"pid": "0",
"root_id": "0",
"name": "汽车零部件/养护/美容/维保",
"note": ""
},
{
"id": "201173506",
"pid": "0",
"root_id": "0",
"name": "兑换卡",
"note": ""
},
{
"id": "201175701",
"pid": "0",
"root_id": "0",
"name": "淘小铺",
"note": ""
},
{
"id": "201207402",
"pid": "0",
"root_id": "0",
"name": "婴童尿裤",
"note": ""
},
{
"id": "201230407",
"pid": "0",
"root_id": "0",
"name": "体检/医疗保障卡",
"note": ""
},
{
"id": "201236409",
"pid": "0",
"root_id": "0",
"name": "店铺经营主体变更",
"note": ""
},
{
"id": "201273575",
"pid": "0",
"root_id": "0",
"name": "OTC药品/国际医药",
"note": ""
},
{
"id": "201304427",
"pid": "0",
"root_id": "0",
"name": "民生服务",
"note": ""
},
{
"id": "201307427",
"pid": "0",
"root_id": "0",
"name": "购物金",
"note": ""
},
{
"id": "201310232",
"pid": "0",
"root_id": "0",
"name": "能源出行",
"note": ""
},
{
"id": "201402901",
"pid": "0",
"root_id": "0",
"name": "商业加盟",
"note": ""
},
{
"id": "201412401",
"pid": "0",
"root_id": "0",
"name": "钉钉电商",
"note": ""
}
]
},
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:194 max:10100 all[367=194+92+81];expires:2030-12-31",
"execution_time": "0.089",
"server_time": "Beijing/2022-11-04 13:38:14",
"client_ip": "106.6.39.250",
"call_args": [],
"api_type": "taobao",
"translate_language": "zh-CN",
"translate_engine": "google_new",
"server_memory": "0.96MB",
"request_id": "gw-4.6364a546e01c6",
"last_id": "1333187065"
}异常示例相关资料错误码解释
状态代码(error_code) | 状态信息 | 详细描述 | 是否收费 |
0000 | success | 接口调用成功并返回相关数据 | 是 |
2000 | Search success but no result | 接口访问成功，但是搜索没有结果 | 是 |
4000 | Server internal error | 服务器内部错误 | 否 |
4001 | Network error | 网络错误 | 否 |
4002 | Target server error | 目标服务器错误 | 否 |
4003 | Param error | 用户输入参数错误 | 忽略 |
4004 | Account not found | 用户帐号不存在 | 忽略 |
4005 | Invalid authentication credentials | 授权失败 | 忽略 |
4006 | API stopped | 您的当前API已停用 | 忽略 |
4007 | Account stopped | 您的账户已停用 | 忽略 |
4008 | API rate limit exceeded | 并发已达上限 | 忽略 |
4009 | API maintenance | API维护中 | 忽略 |
4010 | API not found with these values | API不存在 | 忽略 |
4012 | Please add api first | 请先添加api | 忽略 |
4013 | Number of calls exceeded | 调用次数超限 | 忽略 |
4014 | Missing url param | 参数缺失 | 忽略 |
4015 | Wrong pageToken | 参数pageToken有误 | 忽略 |
4016 | Insufficient balance | 余额不足 | 忽略 |
4017 | timeout error | 请求超时 | 否 |
5000 | unknown error | 未知错误 | 否 |
