淘宝客高级API
淘宝客官方推荐商品库物料精选/猜你喜欢/相似推荐接口【即将下线,需迁移新接口】
需要授权
1428人使用

通过该API可获取官方提供的所有商品库,好券直播,大额券,高佣榜,品牌券,母婴主题,有好货,潮流范,特惠商品,一键转链,且数据实时,使用更便捷

物料信息地址:https://www.yuque.com/kuaifan/vcftkp/one1uyd9ipbvrnd1

查看详细说明
接口地址: http://api.tbk.dingdanxia.com/spk/optimus 在线测试

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

material_id

Number

官方的物料Id(详细物料id见:https://market.m.taobao.com/app/qn/toutiao-new/index-pc.html?spm=a219t.11816995.1998910419.d1856e3ff.2a8f75a5RbY5YX#/detail/10628875?_k=hpdbfc)

page_size

Number

页大小,默认20,1~100

page_no

Number

第几页,默认:1

device_type

String

智能匹配-设备号类型:IMEI,或者IDFA,或者UTDID(UTDID不支持MD5加密)

device_encrypt

String

智能匹配-设备号加密类型:MD5

device_value

String

智能匹配-设备号加密后的值(MD5加密需32位小写)

content_id

Number

内容专用-内容详情ID

content_source

String

内容专用-内容渠道信息

item_id

Number

商品ID,用于相似商品推荐

返回参数说明

标记

类型

例子

说明

coupon_amount

Number

40

优惠券信息-优惠券面额。如:满299元减20元

small_images

String[]

商品信息-商品小图列表

shop_title

String

魔黛娅内衣旗舰店

店铺信息-店铺名称

category_id

Number

162201

商品信息-叶子类目id

coupon_start_fee

String

69

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

item_id

Number

556633720749

商品信息-宝贝id

coupon_total_count

Number

30000

优惠券信息-优惠券总量

zk_final_price

String

79.9

商品信息-商品折扣价

coupon_remain_count

Number

1936

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

commission_rate

String

5.50

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

coupon_start_time

String

2017-10-29

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

title

String

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

商品信息-商品标题

item_description

String

商品信息-宝贝描述(推荐理由,不一定有)

seller_id

Number

745957850

店铺信息-卖家id

volume

Number

3837

商品信息-30天销量

coupon_end_time

String

2017-11-02

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

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

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

pict_url

String

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

商品信息-商品主图

click_url

String

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

链接-宝贝推广链接

stock

Number

拼团专用-拼团剩余库存

sell_num

Number

拼团专用-拼团已售数量

total_stock

Number

拼团专用-拼团库存数量

oetime

String

拼团专用-拼团结束时间

ostime

String

拼团专用-拼团开始时间

jdd_num

Number

拼团专用-拼团几人团

jdd_price

String

拼团专用-拼团拼成价,单位元

orig_price

String

拼团专用-拼团一人价(原价),单位元

level_one_category_name

String

商品信息-一级类目名称

level_one_category_id

Number

商品信息-一级类目ID

category_name

String

商品信息-叶子类目名称

short_title

String

商品信息-商品短标题

white_image

String

商品信息-商品白底图

word_list

WordMapData[]

商品信息-商品关联词

word

String

商品信息-商品相关的关联词

url

String

链接-商品相关关联词落地页地址

tmall_play_activity_info

String

营销-天猫营销玩法

uv_sum_pre_sale

Number

商品信息-预售数量

new_user_price

String

商品信息-新人价

coupon_info

String

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

user_type

Number

1

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

coupon_share_url

String

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

nick

String

店铺信息-卖家昵称

is_default

String

false

推荐信息-是否抄底

reserve_price

String

102.00

商品信息-一口价通常显示为划线价

ju_online_end_time

String

1559750399000

营销-聚划算聚淘结束时间

ju_online_start_time

String

1559232000000

营销-聚划算聚淘开始时间

maochao_play_free_post_fee

String

1

猫超玩法信息-当前是否包邮,1:是,0:否

maochao_play_end_time

String

1559750399000

猫超玩法信息-活动结束时间,精确到毫秒

maochao_play_start_time

String

1559750399000

猫超玩法信息-活动开始时间,精确到毫秒

maochao_play_conditions

String

2,3

猫超玩法信息-折扣条件,价格百分数存储,件数按数量存储。可以有多个折扣条件,与折扣字段对应,','分割

maochao_play_discounts

String

100,300

猫超玩法信息-折扣,折扣按照百分数存储,其余按照单位分存储。可以有多个折扣,','分割

maochao_play_discount_type

String

2

猫超玩法信息-玩法类型,2:折扣(满n件折扣),5:减钱(满n元减m元)

multi_coupon_zk_rate

String

0.12345

营销-多件券优惠比例

price_after_multi_coupon

String

9.9

营销-多件券件单价

multi_coupon_item_count

String

3

营销-多件券件数

lock_rate

String

110

商品信息-锁住的佣金率

lock_rate_end_time

String

1567440000000

商品信息-锁佣结束时间

lock_rate_start_time

String

1567440000000

商品信息-锁佣开始时间

presale_discount_fee_text

String

付定金立减5元

预售商品-优惠信息

presale_tail_end_time

String

1567440000000

预售商品-付尾款结束时间(毫秒)

presale_tail_start_time

String

1567440000000

预售商品-付尾款开始时间(毫秒)

presale_end_time

String

1567440000000

预售商品-付定金结束时间(毫秒)

presale_start_time

String

1567440000000

预售商品-付定金开始时间(毫秒)

presale_deposit

String

100

预售商品-定金(元)

ysyl_tlj_send_time

String

2019-11-10 21:59:59

预售有礼-淘礼金发放时间

ysyl_click_url

String

预售有礼-推广链接

ysyl_tlj_face

String

1

预售有礼-预估淘礼金(元)

ysyl_commission_rate

String

2030(表示20.3%)

预售有礼-佣金比例(预售有礼活动享受的推广佣金比例,注:推广该活动有特殊分成规则,请详见:https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=9334376)

ysyl_tlj_use_end_time

String

2019-11-10 21:59:59

预售有礼-淘礼金使用结束时间

ysyl_tlj_use_start_time

String

2019-11-10 21:59:59

预售有礼-淘礼金使用开始时间

tmall_play_activity_end_time

Number

1567440000000

天猫限时抢可售 -结束时间(毫秒)

tmall_play_activity_start_time

Number

1567440000000

天猫限时抢可售 -开始时间(毫秒)

play_info

String

营销-1、聚划算满减满折:满N件减X元、满N件X折、满N件X元;2、天猫限时抢:前N分钟每件X元、前N分钟满N件每件X元、前N件每件X元

ju_play_end_time

Number

1567440000000

营销-聚划算满减结束时间(毫秒)

ju_play_start_time

Number

1567440000000

营销-聚划算满减开始时间(毫秒)

promotion_type

String

1

营销-满减满折的类型(1. 满减 2. 满折)

promotion_info

String

满2件打5折;满300减20

营销-满减满折信息

promotion_discount

String

500

营销-满减满折门槛(满2件打5折中值为2,满300减20中值为300)

promotion_condition

String

5

营销-满减满折优惠(满2件打5折中值为5,满300减20中值为20)

ju_pre_show_end_time

String

1567440000000

营销-聚划算商品预热开始时间(毫秒)

ju_pre_show_start_time

String

1567440000000

营销-聚划算商品预热结束时间(毫秒)

sale_price

String

168

商品信息-大促活动预热价

kuadian_promotion_info

String

["每100减20","每200减50"]

营销-跨店满减信息

sub_title

String

吉品鲍鱼 关西参

商品信息-商品子标题

jhs_price_usp_list

String

满200减10

营销-聚划算商品价格卖点描述

tqg_total_count

String

50

淘抢购商品专用-总库存

tqg_sold_count

String

20

淘抢购商品专用-已抢购数量

tqg_online_start_time

String

1582300799000

淘抢购商品专用-开团时间

tqg_online_end_time

String

1582300799000

淘抢购商品专用-结束时间

返回示例
{
	"code": 200,
	"msg": "请求成功【success】",
	"data": [{
		"category_id": 50496015,
		"click_url": "\/\/s.click.taobao.com\/t?e=m%3D2%26s%3DQEljWCRAsEtw4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0D0yr%2BXRGwGyp9OhI%2FAffM6XX8jSMzRlNjF3Y%2BbYt%2FaMJpZDSlCQtzzY06PVtVSdYVMjacS34Cq9I1qc6ZupxAtf4OFyYG8oj%2BwM9ZnCPMlHC2TKqEFvn7i1ezIf87pSBC0JfZhIq3yPICXhDdXVYMwugekJCUMwfiGFCzYOOqAQ&scm=1007.19011.107455.0_4094&pvid=8728c282-be4e-455a-ad90-f50ad0ba3adc&app_pvid=59590_11.23.91.213_34177_1553764915543&ptl=floorId:4094;pvid:8728c282-be4e-455a-ad90-f50ad0ba3adc;app_pvid:59590_11.23.91.213_34177_1553764915543&union_lens=lensId:0b175bd5_0c59_169c39b1a39_e56a",
		"commission_rate": "0.6",
		"coupon_amount": 10,
		"coupon_click_url": "\/\/uland.taobao.com\/coupon\/edetail?e=l1khzliOqEkNfLV8niU3R5TgU2jJNKOfNNtsjZw%2F%2FoJJBc0Nz%2FXIVBtKoeZh%2FMLXLspxGy3zBjaiuj3CzrHp9chouCqZLg4hwdt5TpIjVUa2TCzAtVNtbqwbAntFj%2BXYEHpTAWQ%2BSRFKtlcJRLR%2FXjX87iaJhzXLElAxyrvB6mYOA9IyHvt%2BInHddMIpLB%2FnG2kwgoJllApUd1pR11M9KlVusqqnhify&&app_pvid=59590_11.23.91.213_34177_1553764915543&ptl=floorId:4094;app_pvid:59590_11.23.91.213_34177_1553764915543;tpp_pvid:8728c282-be4e-455a-ad90-f50ad0ba3adc&union_lens=lensId:0b175bd5_0c59_169c39b1a39_e56a",
		"coupon_end_time": "1554220799000",
		"coupon_remain_count": 99924,
		"coupon_share_url": "\/\/uland.taobao.com\/coupon\/edetail?e=l1khzliOqEkNfLV8niU3R5TgU2jJNKOfNNtsjZw%2F%2FoJJBc0Nz%2FXIVBtKoeZh%2FMLXLspxGy3zBjaiuj3CzrHp9chouCqZLg4hwdt5TpIjVUa2TCzAtVNtbqwbAntFj%2BXYEHpTAWQ%2BSRFKtlcJRLR%2FXjX87iaJhzXLElAxyrvB6mYOA9IyHvt%2BInHddMIpLB%2FnG2kwgoJllApUd1pR11M9KlVusqqnhify&&app_pvid=59590_11.23.91.213_34177_1553764915543&ptl=floorId:4094;app_pvid:59590_11.23.91.213_34177_1553764915543;tpp_pvid:8728c282-be4e-455a-ad90-f50ad0ba3adc&union_lens=lensId:0b175bd5_0c59_169c39b1a39_e56a",
		"coupon_start_fee": "20.0",
		"coupon_start_time": "1553616000000",
		"coupon_total_count": 100000,
		"item_description": "简约新款 暖色元素 送安装工具",
		"item_id": 575377112382,
		"level_one_category_id": 50468001,
		"level_one_category_name": "手表",
		"nick": "型爵手表旗舰店",
		"pict_url": "\/\/gw.alicdn.com\/bao\/uploaded\/i2\/3319254258\/O1CN017RIm0B1hKCxIi3bHI_!!0-item_pic.jpg",
		"seller_id": 3319254258,
		"shop_title": "型爵手表旗舰店",
		"small_images": {
			"string": ["\/\/img.alicdn.com\/i2\/3319254258\/O1CN011hKCul12FDWcAV4_!!3319254258.jpg", "\/\/img.alicdn.com\/i1\/3319254258\/TB2SskYo5MnBKNjSZFoXXbOSFXa_!!3319254258.jpg", "\/\/img.alicdn.com\/i1\/3319254258\/TB2R1qXpmcqBKNjSZFgXXX_kXXa_!!3319254258.jpg", "\/\/img.alicdn.com\/i1\/3319254258\/O1CN01LwRTjO1hKCvPMg6s2_!!3319254258.jpg"]
		},
		"title": "迪士尼儿童表带男女款真皮针扣表链配件代用浪琴天梭卡西欧表带女",
		"user_type": 1,
		"volume": 483,
		"white_image": "https:\/\/img.alicdn.com\/imgextra\/TB1TgkCjxnaK1RjSZFBXXcW7VXa.png",
		"zk_final_price": "23.9"
	}, {
		"category_id": 50012668,
		"click_url": "\/\/s.click.taobao.com\/t?e=m%3D2%26s%3D8cjHSTWozihw4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0D0yr%2BXRGwGyp9OhI%2FAffM6XX8jSMzRlNjF3Y%2BbYt%2FaMJpZDSlCQtzzY06PVtVSdYVMjacS34Cq9I1qc6ZupxAvFEQkgqasihwS1nvmR2uQTC2TKqEFvn7i1ezIf87pSBC0JfZhIq3yP4pI%2FNnogNwshpTeyG8sogyGFCzYOOqAQ&scm=1007.19011.107455.0_4094&pvid=8728c282-be4e-455a-ad90-f50ad0ba3adc&app_pvid=59590_11.23.91.213_34177_1553764915543&ptl=floorId:4094;pvid:8728c282-be4e-455a-ad90-f50ad0ba3adc;app_pvid:59590_11.23.91.213_34177_1553764915543&union_lens=lensId:0b175bd5_0c59_169c39b1a39_e56b",
		"commission_rate": "0.3",
		"coupon_amount": 10,
		"coupon_click_url": "\/\/uland.taobao.com\/coupon\/edetail?e=pEkDGS9XKtANfLV8niU3R5TgU2jJNKOfNNtsjZw%2F%2FoLAtthYTRE17vRAFvUl9U5pLspxGy3zBjaiuj3CzrHp9chouCqZLg4hMsOxv6HVEQ5oxT6gQKB%2FUKwbAntFj%2BXYEHpTAWQ%2BSRFKtlcJRLR%2FXrkKb4V2mVawUMYEdA7bi%2FoOA9IyHvt%2BInHddMIpLB%2FnG2kwgoJllApUd1pR11M9KlVusqqnhify&&app_pvid=59590_11.23.91.213_34177_1553764915543&ptl=floorId:4094;app_pvid:59590_11.23.91.213_34177_1553764915543;tpp_pvid:8728c282-be4e-455a-ad90-f50ad0ba3adc&union_lens=lensId:0b175bd5_0c59_169c39b1a39_e56b",
		"coupon_end_time": "1554220799000",
		"coupon_remain_count": 100000,
		"coupon_share_url": "\/\/uland.taobao.com\/coupon\/edetail?e=pEkDGS9XKtANfLV8niU3R5TgU2jJNKOfNNtsjZw%2F%2FoLAtthYTRE17vRAFvUl9U5pLspxGy3zBjaiuj3CzrHp9chouCqZLg4hMsOxv6HVEQ5oxT6gQKB%2FUKwbAntFj%2BXYEHpTAWQ%2BSRFKtlcJRLR%2FXrkKb4V2mVawUMYEdA7bi%2FoOA9IyHvt%2BInHddMIpLB%2FnG2kwgoJllApUd1pR11M9KlVusqqnhify&&app_pvid=59590_11.23.91.213_34177_1553764915543&ptl=floorId:4094;app_pvid:59590_11.23.91.213_34177_1553764915543;tpp_pvid:8728c282-be4e-455a-ad90-f50ad0ba3adc&union_lens=lensId:0b175bd5_0c59_169c39b1a39_e56b",
		"coupon_start_fee": "18.0",
		"coupon_start_time": "1553702400000",
		"coupon_total_count": 100000,
		"item_description": "创意镭射设计卡套",
		"item_id": 571524376271,
		"level_one_category_id": 50018004,
		"level_one_category_name": "文具电教\/文化用品\/商务用品",
		"nick": "kinbor旗舰店",
		"pict_url": "\/\/gw.alicdn.com\/bao\/uploaded\/i2\/2780232547\/TB2JMlptTdYBeNkSmLyXXXfnVXa_!!2780232547-0-item_pic.jpg",
		"seller_id": 2780232547,
		"shop_title": "kinbor旗舰店",
		"small_images": {
			"string": ["\/\/img.alicdn.com\/i2\/2780232547\/TB2sY3LxGSWBuNjSsrbXXa0mVXa_!!2780232547-0-item_pic.jpg", "\/\/img.alicdn.com\/i4\/2780232547\/TB2yoZcpDdYBeNkSmLyXXXfnVXa_!!2780232547.jpg", "\/\/img.alicdn.com\/i1\/2780232547\/TB2ev4nx1OSBuNjy0FdXXbDnVXa_!!2780232547.jpg", "\/\/img.alicdn.com\/i3\/2780232547\/TB2A1MSxFGWBuNjy0FbXXb4sXXa_!!2780232547.jpg"]
		},
		"title": "kinbor原创镭射卡套卡插公交卡挂脖吊绳工作牌学生饭卡保护套",
		"user_type": 1,
		"volume": 104,
		"white_image": "https:\/\/img.alicdn.com\/imgextra\/TB18pFskMDqK1RjSZSyXXaxEVXa.png",
		"zk_final_price": "25"
	}]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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