淘宝联盟商品库-超级搜索api接口
需要授权
3162人使用

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

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

接口地址: http://api.tbk.dingdanxia.com/tbk/super_search 在线测试
请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

signature

string

接口签名,查看创建规则,(可在后台开启或关闭,关闭状态可不需要此参数)

q

String

女装

搜索关键词,同时支持商品id搜索、淘宝/天猫商品链接搜索【该参数与cat参数必选一个】

cat

String

16,18

商品类目ID,用,分割,最大10个,【该参数与q参数必选一个】

has_coupon

Boolean

true

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

sort

String

tk_rate_des

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

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://tbk.bbs.taobao.com/detail.html?appId=45301&postId=8576096),不传时默认为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

返回参数说明

标记

类型

例子

说明

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表示商城

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

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

shop_dsr

String

13

店铺dsr评分

white_image

String

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

商品白底图

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

预售数量

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "data": [
        {
            "category_id": 50013194,
            "category_name": "毛呢外套",
            "commission_rate": "1000",
            "commission_type": "MKT",
            "coupon_end_time": "2019-01-09",
            "coupon_id": "a9d7afced39a4a6bad92fefe4c44b3bc",
            "coupon_info": "满399.00元减20元",
            "coupon_remain_count": 80000,
            "coupon_share_url": "//uland.taobao.com/coupon/edetail?e=hoiO8I0q47QNfLV8niU3RwXoB%2BDaBK5LQS0Flu%2FfbSp4QsdWMikAalrisGmre1Id522H2TxuqpKRVjhP%2FTrCmFi%2Fe01tWlc0%2BMUwzxYlSKGGcXQ5A2Rk0hAPFsFDXXOQSvv8366jHreANAwE6l7g9iNAZJyHV6eqkPDSKCH6P1OpOPeim5ps9XCWlHKmFLrGcKyGdLFfF%2BPiINPY4XmmYKJ7%2BkHL3AEW&&app_pvid=59590_11.23.92.101_633_1546951022163&ptl=floorId:2836;app_pvid:59590_11.23.92.101_633_1546951022163;tpp_pvid:100_11.182.80.100_162206_4751546951022166813&union_lens=lensId:0b175c65_0bd6_1682d7756df_b386",
            "coupon_start_time": "2019-01-06",
            "coupon_total_count": 100000,
            "include_dxjh": "true",
            "include_mkt": "true",
            "info_dxjh": "{}",
            "item_url": "https://item.taobao.com/item.htm?id=581777617363",
            "level_one_category_id": 16,
            "level_one_category_name": "女装/女士精品",
            "num_iid": 581777617363,
            "pict_url": "https://img.alicdn.com/bao/uploaded/i2/720853322/O1CN01fsNdc91aPWD4sYhlD_!!720853322.jpg",
            "provcity": "上海",
            "reserve_price": "499.99",
            "seller_id": 720853322,
            "shop_dsr": 48078,
            "shop_title": "MMCO独立时尚店",
            "short_title": "安娜家2018冬季新款复古方扣呢大衣",
            "small_images": {
                "string": [
                    "https://img.alicdn.com/i3/720853322/O1CN01QBXRYq1aPWD3agVxJ_!!720853322.jpg",
                    "https://img.alicdn.com/i2/720853322/O1CN01rFg8wV1aPWD5YBMGG_!!720853322.jpg",
                    "https://img.alicdn.com/i4/720853322/O1CN015jBVmP1aPWDbk3UFT_!!720853322.jpg",
                    "https://img.alicdn.com/i1/720853322/O1CN01sNDoQ11aPWCujVCvu_!!720853322.jpg"
                ]
            },
            "title": "安娜家2018冬季新款复古方扣双面呢大衣中长款气质毛呢外套女装",
            "tk_total_commi": "33906.4",
            "tk_total_sales": "778",
            "url": "//s.click.taobao.com/t?e=m%3D2%26s%3Dkbt8gvO1CxQcQipKwQzePOeEDrYVVa64lwnaF1WLQxlyINtkUhsv0KiVUXvqBOof39GVOnhSqOELs9FBZ0s2fItiTmgleKGLPD2D9iXnZQrUpulEiSZPtF9EeTtntI44nZvhKyvPs04pupk7IoXAb80Q9fK1X0AuhLjO8JFSuq4SIz%2BVIb9tlFEcA%2FyC9V2TePkuGOR%2BGn%2FGJe8N%2FwNpGw%3D%3D&scm=null&pvid=100_11.182.80.100_162206_4751546951022166813&app_pvid=59590_11.23.92.101_633_1546951022163&ptl=floorId:2836;pvid:100_11.182.80.100_162206_4751546951022166813;app_pvid:59590_11.23.92.101_633_1546951022163&union_lens=lensId:0b175c65_0bd6_1682d7756df_b386",
            "user_type": 0,
            "volume": 6382,
            "white_image": "https://img.alicdn.com/bao/uploaded/i1/720853322/O1CN01sNDoQ11aPWCujVCvu_!!720853322.jpg",
            "zk_final_price": "449.99"
        }
    ]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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