# 获取全网淘客商品

# 接口名称

taobao.tbk.sc.material.optional

# 调用方法

https://api.taobaokeapi.com/?usertoken=[usertoken]&method=taobao.tbk.sc.material.optional

# 请求参数

名称 类型 必须 示例值 描述
start_dsr Number false 10 商品筛选(特定媒体支持)-店铺dsr评分。筛选大于等于当前设置的店铺dsr评分的商品0-50000之间
page_size Number false 20 页大小,默认20,1~100
page_no Number false 1 第几页,默认:1
platform Number false 1 链接形式:1:PC,2:无线,默认:1
end_tk_rate Number false 1234 商品筛选-淘客佣金比率上限。如:1234表示12.34%
start_tk_rate Number false 1234 商品筛选-淘客佣金比率下限。如:1234表示12.34%
end_price Number false 10 商品筛选-折扣价范围上限。单位:元
start_price Number false 10 商品筛选-折扣价范围上限。单位:元
is_overseas Boolean false false 商品筛选-是否海外商品。true表示属于海外商品,false或不设置表示不限
is_tmall Boolean false false 商品筛选-是否天猫商品。true表示属于天猫商品,false或不设置表示不限
sort String false tk_rate_des 排序_des(降序),排序_asc(升序),销量(total_sales),淘客佣金比率(tk_rate), 累计推广量(tk_total_sales),总支出佣金(tk_total_commi),价格(price)
itemloc String false 杭州 商品筛选-所在地
cat String false 16,18 商品筛选-后台类目ID。用,分割,最大10个,该ID可以通过taobao.itemcats.get接口获取到
q String false 女装 查询的关键词,可直接传入商品链接进行精准搜索
adzone_id Number true 12345678 mm_xxx_xxx_12345678三段式的最后一段数字
site_id Number true 22 mm_xxx_22_xxx三段式的第二段数字
material_id Number false 2836 物料id(详细物料id见【分类商品库大全】接口或:https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=8576096)。不传时默认为2836
has_coupon Boolean false false 优惠券筛选-是否有优惠券。true表示该商品有优惠券,false或不设置表示不限
ip String false 13.2.33.4 ip参数影响邮费获取,如果不传或者传入不准确,邮费无法精准提供
include_rfd_rate Boolean false true 商品筛选(特定媒体支持)-退款率是否低于行业均值。True表示大于等于,false或不设置表示不限
include_good_rate Boolean false true 商品筛选-好评率是否高于行业均值。True表示大于等于,false或不设置表示不限
include_pay_rate_30 Boolean false true 商品筛选(特定媒体支持)-成交转化是否高于行业均值。True表示大于等于,false或不设置表示不限
need_prepay Boolean false true 商品筛选-是否加入消费者保障。true表示加入,false或不设置表示不限
need_free_shipment Boolean false true 商品筛选-是否包邮。true表示包邮,false或不设置表示不限
npx_level Number false 2 商品筛选-牛皮癣程度。取值:1不限,2无,3轻微
end_ka_tk_rate Number false 1234 商品筛选-KA媒体淘客佣金比率上限。如:1234表示12.34%
start_ka_tk_rate Number false 1234 商品筛选-KA媒体淘客佣金比率下限。如:1234表示12.34%
device_value String false xxx 智能匹配-设备号加密后的值(MD5加密需32位小写)
device_encrypt String false MD5 智能匹配-设备号加密类型:MD5
device_type String false IMEI 智能匹配-设备号类型:IMEI,或者IDFA,或者UTDID(UTDID不支持MD5加密),或者OAID
lock_rate_end_time Number false 1567440000000 锁佣结束时间
lock_rate_start_time Number false 1567440000000 锁佣开始时间

# 响应参数

名称 类型 示例值 描述
total_results Number 1212 搜索到符合条件的结果总数
result_list MapData [] resultList
coupon_start_time String 2017-10-29 优惠券信息-优惠券开始时间
coupon_end_time String 2017-10-29 优惠券信息-优惠券开始时间
info_dxjh Json {"19013551":"2850","74510538":"2550"} 商品信息-是否包含定向计划
tk_total_sales String 11 商品信息-淘客30天推广量
tk_total_commi String 323 商品信息-月支出佣金(该字段废弃,请勿再用)
coupon_id String d62db1ab8d9546b1bf0ff49bda5fc33b 优惠券信息-优惠券id
num_iid Number 556633720749 商品信息-宝贝id(该字段废弃,请勿再用)
title String 毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款 商品信息-商品标题
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 String false 商品信息-是否包含营销计划
include_dxjh String false 商品信息-是否包含定向计划
commission_rate String 1550表示15.5% 商品信息-佣金比率。1550表示15.5%
volume Number 123 商品信息-30天销量
seller_id Number 232332 店铺信息-卖家id
coupon_total_count Number 22323 优惠券信息-优惠券总量
coupon_remain_count Number 111 优惠券信息-优惠券剩余量
coupon_info String 满299元减20元 优惠券信息-优惠券满减信息
commission_type String MKT表示营销计划,SP表示定向计划,COMMON表示通用计划 商品信息-佣金类型。MKT表示营销计划,SP表示定向计划,COMMON表示通用计划
shop_title String xx旗舰店 店铺信息-店铺名称
url String s.click.xxx 链接-宝贝推广链接
coupon_share_url String uland.xxx 链接-宝贝+券二合一页面链接
shop_dsr Number 13 店铺信息-店铺dsr评分
white_image String https://img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg 商品信息-商品白底图
short_title String xxsd 商品信息-商品短标题
category_id Number 162201 商品信息-叶子类目id
category_name String 连衣裙 商品信息-叶子类目名称
level_one_category_id Number 20 商品信息-一级类目ID
level_one_category_name String 女装 商品信息-一级类目名称
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 23 预售专用-预售数量
coupon_amount String 10.00 优惠券(元) 若属于预售商品,该优惠券付尾款可用,付定金不可用
coupon_start_fee String 29.00 优惠券信息-优惠券起用门槛,满X元可用,如:满299元减20元
item_description String 夏季凉被 全棉亲肤 宝贝描述(推荐理由)
nick String 旗舰店 店铺信息-卖家昵称
x_id String uESS0mv8JvfJRMKlIgCD5At9VuHVBXoqBRihfQlo4ybLiKygRlqiN4eoxoZDfe38uSogWy6GB971jD2N8tLuuc 链接-物料块id(测试中请勿使用)
orig_price String 25 拼团专用-拼团一人价(原价),单位元
total_stock Number 5555 拼团专用-拼团库存数量
sell_num Number 1111 拼团专用-拼团已售数量
stock Number 4444 拼团专用-拼团剩余库存
tmall_play_activity_info String 前n件x折 营销-天猫营销玩法
item_id Number 5678899993 商品信息-宝贝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 预售商品-定金(元)

# 响应示例

{
    "tbk_sc_material_optional_response":{
        "total_results":1212,
        "result_list":{
            "map_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"
                }
            ]
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

# 异常示例

{
	"error_response":{
		"sub_msg":"非法参数",
		"code":50,
		"sub_code":"isv.invalid-parameter",
		"msg":"Remote service error"
	}
}
1
2
3
4
5
6
7
8

# 错误码解释

错误码 错误消息 解决方案
1001 非法的me参数值 传入正确的me参数值,含有券ID与商品ID信息
10000 该itemId对应的宝贝已下架或非淘客宝贝 更换新的itemId查询
4 查询不到对应的adzoneId 请检查adzoneId是否正确
30002 参数q与cat都为空值 参数q与cat不能都为空,至少一个参数有值
2 pid不正确 请检查是否输入了正确的adzoneId和siteId
50001 无结果 宝贝数据为空,请重新查询
30001 无效物料ID 请传入有效的物料ID
41 pageSize参数不合法 参考文档或者设置为1~7之间
isp.entry-sys-error 内部服务出错 稍后重试
isp.sys-error 内部服务异常 稍后重试