淘宝客高级API
淘宝联盟选品库商品详情接口
255人使用

淘宝联盟选品库商品详情接口

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

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

appkey

STRING

自己淘宝开放平台appkey

appsecret

STRING

自己淘宝开放平台appsecret

favorites_id

STRING

选品库ID,通过选品库列表获取

pid

STRING

完整三段推广位

page_no

int

1

第几页,默认:1

page_size

int

20

页大小,默认20,1~100

返回参数说明

标记

类型

例子

说明

category_id

Number

162201

商品信息-叶子类目id

click_url

String

//item.taobao.com/item.htm?id=556633720749&scm=1007.16190.92234.0&pvid=41362290-fa0b-4252-b172-6afc9c00e2c8&app_pvid=0ab0fac715095507006577956e

链接-宝贝推广链接

commission_rate

String

5.50

商品信息-佣金比率(%)

coupon_amount

Number

40

优惠券(元) 若属于预售商品,该优惠券付尾款可用,付定金不可用

coupon_click_url

String

//uland.taobao.com/coupon/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&mt=1&app_pvid=0ab0fac715095507006577956e&ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8

链接-宝贝+券二合一页面链接(该字段废弃,请勿再用)

coupon_end_time

String

2017-11-02

优惠券信息-优惠券结束时间

coupon_info

String

满299减30元

优惠券信息-优惠券满减信息

coupon_remain_count

Number

1936

优惠券信息-优惠券剩余量

coupon_share_url

String

//uland.taobao.com/coupon/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&mt=1&app_pvid=0ab0fac715095507006577956e&ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8

链接-宝贝+券二合一页面链接

coupon_start_fee

String

69

优惠券信息-优惠券起用门槛,满X元可用。如:满299元减20元

coupon_start_time

String

2017-10-29

优惠券信息-优惠券开始时间

coupon_total_count

Number

30000

优惠券信息-优惠券总量

item_id

Number

556633720749

商品信息-宝贝id

level_one_category_id

Number

商品信息-一级类目ID

nick

String

秉迪数码专营店

店铺信息-卖家昵称

pict_url

String

//img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg

商品信息-商品主图

reserve_price

String

2.99

商品信息-一口价

seller_id

Number

745957850

店铺信息-卖家id

shop_title

String

魔黛娅内衣旗舰店

店铺信息-店铺名称

small_images

String[]

商品信息-商品小图列表

title

String

毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款

商品信息-商品标题

user_type

Number

1

店铺信息-卖家类型,0表示集市,1表示天猫

volume

Number

3887

商品信息-30天销量

white_image

String

https://img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg

商品信息-商品白底图

zk_final_price

String

79.9

折扣价(元) 若属于预售商品,付定金时间内,折扣价=预售价

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"total_results": "2",
	"data": [{
			"category_id": "50018994",
			"click_url": "//s.click.taobao.com/t?e=m%3D2%26s%3DEAr3ide7JxVw4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0Pberr7dEG1QUECVxNjfTc%2BXX8jSMzRlNjF3Y%2BbYt%2FaMCgNxDUIUX3cFV0Sdf%2Fsf4kUYJhTZdbIQLrHGZgcOhEDd7vZihLjx6%2F5UzZSVYF5cEiM%2FlSG%2FbZTEShb1nMjCF3DH63hRObvBk1HHi%2BcbmfrGDF1NzTQoPw%3D%3D&union_lens=lensId%3AMAPI%401616141908%400b847662_98bc_17849907973_1f59%4001",
			"commission_rate": "4.0",
			"coupon_amount": "1",
			"coupon_click_url": "//uland.taobao.com/coupon/edetail?e=3lDwHoPef8ENfLV8niU3R5TgU2jJNKOfNNtsjZw%2F%2FoKLmWQ%2BZyC2Qp9ada35g%2BUfvFyy3aoz7Mc35Lk0sqK5pMuRTiT9oEhVZV8pr6FWc0PPaz0rP7KjmDruGqC41mDzmMHpNfYdHdCSwGwCGDQN%2Fb0LZ%2B2Ah4iObKNfW4yNPXxJ4EN1xlr4ghR155kHpYYFtZ%2B8oLm7sPaie%2FpBy9wBFg%3D%3D&&app_pvid=59590_11.132.118.98_779_1616141908320&ptl=floorId:31539;app_pvid:59590_11.132.118.98_779_1616141908320;tpp_pvid:&union_lens=lensId%3AMAPI%401616141908%400b847662_98bc_17849907973_1f59%4001",
			"coupon_end_time": "1616255999000",
			"coupon_info": "满5元减1元",
			"coupon_remain_count": "43000",
			"coupon_share_url": "//uland.taobao.com/coupon/edetail?e=3lDwHoPef8ENfLV8niU3R5TgU2jJNKOfNNtsjZw%2F%2FoKLmWQ%2BZyC2Qp9ada35g%2BUfvFyy3aoz7Mc35Lk0sqK5pMuRTiT9oEhVZV8pr6FWc0PPaz0rP7KjmDruGqC41mDzmMHpNfYdHdCSwGwCGDQN%2Fb0LZ%2B2Ah4iObKNfW4yNPXxJ4EN1xlr4ghR155kHpYYFtZ%2B8oLm7sPaie%2FpBy9wBFg%3D%3D&&app_pvid=59590_11.132.118.98_779_1616141908320&ptl=floorId:31539;app_pvid:59590_11.132.118.98_779_1616141908320;tpp_pvid:&union_lens=lensId%3AMAPI%401616141908%400b847662_98bc_17849907973_1f59%4001",
			"coupon_start_fee": "5.0",
			"coupon_start_time": "1615996800000",
			"coupon_total_count": "100000",
			"item_id": "633204266847",
			"level_one_category_id": "50025705",
			"nick": "天天特卖工厂店",
			"pict_url": "//img.alicdn.com/i4/3937219703/O1CN015e5vk32LY1h3zT5Sk_!!3937219703-0-C2M.jpg",
			"reserve_price": "8.25",
			"seller_id": "3937219703",
			"shop_title": "天天特卖工厂店",
			"small_images": {
				"string": [
					"//img.alicdn.com/i2/3937219703/O1CN01wZPDj62LY1ekt6VOk_!!0-item_pic.jpg",
					"//img.alicdn.com/i3/2207925376241/O1CN01qBA0Y61vyQTd8CdSm_!!2207925376241-0-scmitem176000.jpg",
					"//img.alicdn.com/i3/2207925376241/O1CN01moVd2L1vyQTVkcTj0_!!2207925376241-0-scmitem176000.jpg",
					"//img.alicdn.com/i3/2207925376241/O1CN01XFny4K1vyQTZQyngH_!!2207925376241-0-scmitem176000.jpg"
				]
			},
			"title": "6卷无芯卷纸卫生纸家用实惠装厕所厕纸手纸整箱卷筒纸巾本色直营",
			"user_type": "1",
			"volume": "313376",
			"white_image": [],
			"zk_final_price": "5.7"
		},
		{
			"category_id": "121480026",
			"click_url": "//s.click.taobao.com/t?e=m%3D2%26s%3Dzh3SlF2AsxRw4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0Pberr7dEG1QUECVxNjfTc%2BXX8jSMzRlNjF3Y%2BbYt%2FaMCgNxDUIUX3cFV0Sdf%2Fsf4kUYJhTZdbIQLrHGZgcOhEC2o1PTbaylSxuKxaGy%2B15xXH5t%2B8W%2BDyXptJY8NV4da3y1iVGE%2BUX5YM4f1dzXfwFxKmPmpIKZsA%3D%3D&union_lens=lensId%3AMAPI%401616141908%400b847662_98bc_17849907973_1f5a%4001",
			"commission_rate": "50.0",
			"coupon_amount": "5",
			"coupon_click_url": "//uland.taobao.com/coupon/edetail?e=vm5CWL64KsQNfLV8niU3R5TgU2jJNKOfNNtsjZw%2F%2FoLKTcrYHixbCIgNUCBEJ%2BAaCq6xWB7%2FspbLcpYNhRU8ZrhtWWjRAlP0awvDoeqYhH2Mqqtiy5%2BbYb%2FlL%2FICw9e4m4VLH9mslwxjUXVF2snoqnkq5AAZz03oDeqUsM2nO4DYsR9aRI9j3LnqwwH3hsKc%2BnoDgTNhwmM%3D&&app_pvid=59590_11.132.118.98_779_1616141908320&ptl=floorId:31539;app_pvid:59590_11.132.118.98_779_1616141908320;tpp_pvid:&union_lens=lensId%3AMAPI%401616141908%400b847662_98bc_17849907973_1f5a%4001",
			"coupon_end_time": "1616255999000",
			"coupon_info": "满9元减5元",
			"coupon_remain_count": "94000",
			"coupon_share_url": "//uland.taobao.com/coupon/edetail?e=vm5CWL64KsQNfLV8niU3R5TgU2jJNKOfNNtsjZw%2F%2FoLKTcrYHixbCIgNUCBEJ%2BAaCq6xWB7%2FspbLcpYNhRU8ZrhtWWjRAlP0awvDoeqYhH2Mqqtiy5%2BbYb%2FlL%2FICw9e4m4VLH9mslwxjUXVF2snoqnkq5AAZz03oDeqUsM2nO4DYsR9aRI9j3LnqwwH3hsKc%2BnoDgTNhwmM%3D&&app_pvid=59590_11.132.118.98_779_1616141908320&ptl=floorId:31539;app_pvid:59590_11.132.118.98_779_1616141908320;tpp_pvid:&union_lens=lensId%3AMAPI%401616141908%400b847662_98bc_17849907973_1f5a%4001",
			"coupon_start_fee": "9.0",
			"coupon_start_time": "1616083200000",
			"coupon_total_count": "100000",
			"item_id": "638426213359",
			"level_one_category_id": "50010788",
			"nick": "帛莎旗舰店",
			"pict_url": "//img.alicdn.com/i3/845635114/O1CN01VA5K0H1neG8s1LVba_!!0-item_pic.jpg",
			"reserve_price": "12",
			"seller_id": "845635114",
			"shop_title": "帛莎旗舰店",
			"small_images": {
				"string": [
					"//img.alicdn.com/i1/845635114/O1CN01XDyux11neG8eHgraB_!!845635114.jpg",
					"//img.alicdn.com/i1/845635114/O1CN01YQ8StN1neG8s0dKcr_!!845635114.jpg",
					"//img.alicdn.com/i2/845635114/O1CN01BzbmOp1neG8pEO3ID_!!845635114.jpg",
					"//img.alicdn.com/i1/845635114/O1CN01FYCQMP1neG8s0d89A_!!845635114.jpg"
				]
			},
			"title": "李佳埼推荐270遮瑕刷无刷痕网红款170粉底刷不吃粉沧州化妆刷套装",
			"user_type": "1",
			"volume": "11960",
			"white_image": [],
			"zk_final_price": "9.5"
		}
	]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。