淘宝联盟超级搜索api接口|淘宝联盟商品库api接口|淘宝联盟选品库接口|订单侠开放平台

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

参数接口

参数类型

必填

示例

说明

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：无线，默认：１

page_size

Number

否

20

页大小，默认20，1~100

page_no

Number

否

20

第几页，默认：１

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

请求拒绝

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

首页

关于

联系我们