淘宝客高级API
商品多级分类-带图标api接口
13515人使用

分类中包含二级子类目,以及分类icon小图标

开发建议:为了更精确搜出对应商品数据,在二级分类搜索商品时,建议将 tb_cid 和 q 参数一起入参,q参数对应name字段,例如: tb_cid=50010850&q=连衣裙 

接口地址: http://api.tbk.dingdanxia.com/spk/cate 在线测试

非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

tree

String

是否按照分类登记显示树状结构,如果为 true 则显示,默认为空,不显示

返回参数说明

标记

类型

例子

说明

id

Number

1

数据编号

name

String

女装

分类名称

cid

Number

12

商品分类id(多个平台整合后的分类id)

pid

Number

0

分类所属id

child

String[]

[]

子数据

tb_cid

String

12

对应淘宝真实分类id

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"data": [{
		"id": 1,
		"name": "女装",
		"cid": 1,
		"pid": 0,
		"icon": "https://img.alicdn.com/imgextra/i1/2053469401/TB2oX82HL9TBuNjy0FcXXbeiFXa-2053469401.png",
		"tb_cid": "16",
		"child": [{
				"id": 2,
				"name": "外套",
				"cid": 1,
				"pid": 1,
				"icon": "https://img.alicdn.com/imgextra/i4/2053469401/O1CN012JJhsoAOrYNlKbb-2053469401.jpg",
				"tb_cid": "50010548"
			},
			{
				"id": 3,
				"name": "T恤",
				"cid": 1,
				"pid": 1,
				"icon": "https://img.alicdn.com/imgextra/i4/2053469401/O1CN01FI5Y912JJhtRlF1PP-2053469401.png",
				"tb_cid": "50000436"
			},
			{
				"id": 4,
				"name": "连衣裙",
				"cid": 1,
				"pid": 1,
				"icon": "https://img.alicdn.com/imgextra/i4/2053469401/O1CN01Tevn7I2JJhtfK39LK-2053469401.png",
				"tb_cid": "50010850"
			},
			{
				"id": 5,
				"name": "卫衣",
				"cid": 1,
				"pid": 1,
				"icon": "https://img.alicdn.com/imgextra/i2/2053469401/O1CN012JJhsmFofvZn9Qi-2053469401.jpg",
				"tb_cid": "50008898"
			},
			{
				"id": 6,
				"name": "套装",
				"cid": 1,
				"pid": 1,
				"icon": "https://img.alicdn.com/imgextra/i3/2053469401/TB2wcqxtDlYBeNjSszcXXbwhFXa-2053469401.png",
				"tb_cid": "1624"
			}
		]
	}]
}
更多数据不予展示			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。