淘宝客高级API
淘宝联盟商品库-超级搜索api接口【即将下线,需迁移新接口】
需要授权
53805人使用

淘宝联盟商品库超级搜索api接口,支持搜索商品链接、商品id,商品标题搜索,还有更多强大搜索选项。

注意:接口默认只查【含有优惠券】的商品,如果需要精确搜索,请将 has_coupon 参数设置为 false

如果返回Remote service error,官方异常请在重试请求一遍即可

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

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

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

q

String

运动

搜索关键词,同时支持商品id搜索、淘宝/天猫商品链接、商品标题搜索【该参数与cat参数必选一个】,如果搜商品标题请将has_coupon参数设置为false,新商品id 搜索需要拼接链接 例如:https://uland.taobao.com/item/edetail?id=X4g0DS2OK34iwyyI06AQQCg-XQWo4eH00jgRjx3iB0

cat

String

16,18

商品类目ID,用,分割,最大10个,【该参数与q参数必选一个】,cat 可从 https://www.dingdanxia.com/doc/21/8 接口里返回的tb_cid获取

has_coupon

Boolean

flase

是否有优惠券,默认true,设置为true表示该商品有优惠券,设置为false或不设置表示不判断这个属性

sort

String

tk_rate_des

排序_des(降序),排序_asc(升序),销量(total_sales),淘客佣金比率(tk_rate), 累计推广量(tk_total_sales),总支出佣金(tk_total_commi),价格(price),匹配分(match)

platform

String

1

链接形式:1:PC,2:无线,默认:1

page_size

Number

20

页大小,默认20,1~100

page_no

Number

20

第几页,默认:1

start_dsr

Number

10

店铺dsr评分,筛选高于等于当前设置的店铺dsr评分的商品0-50000之间

end_tk_rate

Number

1234

淘客佣金比率上限,如:1234表示12.34%

start_tk_rate

Number

1234

淘客佣金比率下限,如:1234表示12.34%

end_price

Number

10

折扣价范围上限,单位:元

start_price

Number

10

折扣价范围下限,单位:元

is_overseas

Boolean

false

是否海外商品,设置为true表示该商品是属于海外商品,设置为false或不设置表示不判断这个属性

is_tmall

Boolean

false

是否商城商品,设置为true表示该商品是属于淘宝商城商品,设置为false或不设置表示不判断这个属性

itemloc

String

杭州

所在地

material_id

Number

2836

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

ip

String

13.2.33.4

ip参数影响邮费获取,如果不传或者传入不准确,邮费无法精准提供

include_rfd_rate

Boolean

true

退款率是否低于行业均值

include_good_rate

Boolean

true

好评率是否高于行业均值

include_pay_rate_30

Boolean

true

成交转化是否高于行业均值

need_prepay

Boolean

true

是否加入消费者保障,true表示加入,空或false表示不限

need_free_shipment

Boolean

true

是否包邮,true表示包邮,空或false表示不限

npx_level

Number

2

牛皮癣程度,取值:1:不限,2:无,3:轻微

end_ka_tk_rate

Number

1234

KA媒体淘客佣金比率上限,如:1234表示12.34%

start_ka_tk_rate

Number

1234

KA媒体淘客佣金比率下限,如:1234表示12.34%

device_value

String

xxxx

设备号加密后的值

device_encrypt

String

MD5

设备号加密类型:MD5

device_type

String

IMEI

设备号类型:IMEI,或者IDFA,或者UTDID

lock_rate_end_time

Number

1567440000000

锁佣结束时间

lock_rate_start_time

Number

1567440000000

锁佣开始时间

seller_ids

String

1,2,3,4

商家id,仅支持饿了么卡券商家ID,支持批量请求1-100以内,多个商家ID使用英文逗号分隔

city_code

String

310000

本地化业务入参-LBS信息-国标城市码,仅支持单个请求,请求饿了么卡券物料时,该字段必填。 (详细城市ID见:https://mo.m.taobao.com/page_2020010315120200508)

latitude

String

31.230370

本地化业务入参-LBS信息-纬度

longitude

String

121.473701

本地化业务入参-LBS信息-经度

relation_id

String

3243

渠道关系ID,仅适用于渠道推广场景

special_id

String

2323

会员运营ID

返回参数说明

标记

类型

例子

说明

coupon_start_time

String

2019-01-26

优惠券起始时间

coupon_end_time

String

2019-09-26

优惠券结束时间

coupon_info

String

满16元减10元

优惠券面额说明

coupon

String

10

优惠券面额

coupon_id

String

d62db1ab8d9546b1bf0ff49bda5fc33b

优惠券id

coupon_total_count

Number

300

优惠券总量

coupon_remain_count

Number

123

优惠券剩余量

info_dxjh

Json

{

妈妈优惠券剩余量

tk_total_sales

Number

400

淘客30天月推广量

tk_total_commi

String

12345

月支出佣金

num_iid

Number

12345678

商品id

title

String

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

商品标题

short_title

String

裤显瘦高腰韩版2017新款

商品短标题

category_id

Number

162201

叶子类目id

category_name

String

连衣裙

叶子类目名称

level_one_category_id

Number

20

一级类目ID

level_one_category_name

String

女装

一级类目名称

pict_url

String

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

商品主图

small_images

String[]

https://img.alicdn.com/i4/3077291146/TB2NA3poDnI8KJjSszgXXc8ApXa_!!3077291146.jpg

商品小图列表

reserve_price

String

102.00

商品一口价格

zk_final_price

String

88.00

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

user_type

Number

1

卖家类型,0表示淘宝,1表示天猫 3表示特价版

provcity

String

杭州

宝贝所在地

item_url

String

https://item.taobao.com/item.htm?id=564591813536

商品地址

include_mkt

Boolean

false

是否包含营销计划

include_dxjh

Boolean

false

是否包含定向计划

commission_rate

Number

1550

佣金比例 1550表示15.5%

volume

Number

3331

30天销量

seller_id

Number

1234567

卖家id

commission_type

String

MKT

MKT表示营销计划,SP表示定向计划,COMMON表示通用计划

shop_title

String

xx旗舰店

店铺名称

url

String

xxx

商品淘客链接

coupon_share_url

String

uland.xxx

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

white_image

String

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

商品白底图

oetime

String

2018-08-21 11:23:31

拼团:结束时间

ostime

String

2018-08-21 11:23:31

拼团:开始时间

jdd_num

Number

10

拼团:几人团

jdd_price

String

5

拼团:拼成价,单位元

uv_sum_pre_sale

Number

50

预售专用-预售数量

coupon_amount

String

10.00

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

coupon_start_fee

String

29.00

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

item_description

String

夏季凉被 全棉亲肤

宝贝描述(推荐理由)

nick

String

旗舰店

店铺信息-卖家昵称

orig_price

String

10

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

total_stock

Number

555

拼团专用-拼团库存数量

sell_num

Number

22

拼团专用-拼团已售数量

stock

Number

23

拼团专用-拼团剩余库存

tmall_play_activity_info

String

前n件x折

营销-天猫营销玩法

item_id

Number

123456789

商品信息-宝贝id

real_post_fee

String

0.00

商品邮费

lock_rate_start_time

Number

1567440000000

锁佣开始时间

lock_rate_end_time

Number

1567440000000

锁佣结束时间

lock_rate

String

110

锁住的佣金率

presale_discount_fee_text

String

付定金立减5元

预售商品-优惠信息

presale_tail_end_time

Number

1567440000000

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

presale_tail_start_time

Number

1567440000000

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

presale_end_time

Number

1567440000000

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

presale_start_time

Number

1567440000000

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

presale_deposit

String

100

预售商品-定金(元)

ysyl_tlj_send_time

String

2019-11-10 21:59:59

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

ysyl_click_url

String

https://uland.taobao.com/coupon/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&pid=mm_26381042_12970066_52864659af=1

预售有礼-推广链接

ysyl_commission_rate

String

2030(表示20.3%)

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

ysyl_tlj_face

String

0.6

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

ysyl_tlj_use_end_time

String

2019-11-10 21:59:59

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

ysyl_tlj_use_start_time

String

2019-11-10 21:59:59

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

usable_shop_name

String

饿了么卡券专营店

本地化-可用店铺名称

usable_shop_id

String

10001

本地化-可用店铺id

distance

String

300

本地化-到门店距离(米)

sale_end_time

String

1567440000000

本地化-销售开始时间

sale_begin_time

String

1567440000000

本地化-销售结束时间

sale_price

String

168

活动价

kuadian_promotion_info

String

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

跨店满减信息

commi_score

String

20.0

物料评估-收益分

match_score

String

10.0

物料评估-匹配分

total_results

Number

2989634

总条数

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "data": [
       {
                    "coupon_start_time":"2017-10-29",
                    "coupon_end_time":"2017-10-29",
                    "info_dxjh":"{\"19013551\":\"2850\",\"74510538\":\"2550\"}",
                    "tk_total_sales":"11",
                    "tk_total_commi":"323",
                    "coupon_id":"d62db1ab8d9546b1bf0ff49bda5fc33b",
                    "num_iid":556633720749,
                    "title":"毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款",
                    "pict_url":"https:\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg",
                    "small_images":{
                        "string":[
                            "https:\/\/img.alicdn.com\/i4\/3077291146\/TB2NA3poDnI8KJjSszgXXc8ApXa_!!3077291146.jpg"
                        ]
                    },
                    "reserve_price":"102.00",
                    "zk_final_price":"88.00",
                    "user_type":1,
                    "provcity":"杭州",
                    "item_url":"https:\/\/item.taobao.com\/item.htm?id=564591813536",
                    "include_mkt":"false",
                    "include_dxjh":"false",
                    "commission_rate":"1550表示15.5%",
                    "volume":123,
                    "seller_id":232332,
                    "coupon_total_count":22323,
                    "coupon_remain_count":111,
                    "coupon_info":"满299元减20元",
                    "commission_type":"MKT表示营销计划,SP表示定向计划,COMMON表示通用计划",
                    "shop_title":"xx旗舰店",
                    "url":"s.click.xxx",
                    "coupon_share_url":"uland.xxx",
                    "shop_dsr":13,
                    "white_image":"https:\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg",
                    "short_title":"xxsd",
                    "category_id":162201,
                    "category_name":"连衣裙",
                    "level_one_category_id":20,
                    "level_one_category_name":"女装",
                    "oetime":"2018-08-21 11:23:31",
                    "ostime":"2018-08-21 11:23:31",
                    "jdd_num":10,
                    "jdd_price":"5",
                    "uv_sum_pre_sale":23,
                    "coupon_amount":"10.00",
                    "coupon_start_fee":"29.00",
                    "item_description":"夏季凉被 全棉亲肤",
                    "nick":"旗舰店",
                    "x_id":"uESS0mv8JvfJRMKlIgCD5At9VuHVBXoqBRihfQlo4ybLiKygRlqiN4eoxoZDfe38uSogWy6GB971jD2N8tLuuc",
                    "orig_price":"25",
                    "total_stock":5555,
                    "sell_num":1111,
                    "stock":4444,
                    "tmall_play_activity_info":"前n件x折",
                    "item_id":5678899993,
                    "real_post_fee":"0.00",
                    "lock_rate_start_time":1567440000000,
                    "lock_rate_end_time":1567440000000,
                    "lock_rate":"110",
                    "presale_discount_fee_text":"付定金立减5元",
                    "presale_tail_end_time":1567440000000,
                    "presale_tail_start_time":1567440000000,
                    "presale_end_time":1567440000000,
                    "presale_start_time":1567440000000,
                    "presale_deposit":"100"
         }
    ]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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