# 获取全网淘客商品
# 接口名称
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
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
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 | 内部服务异常 | 稍后重试 |
← 聚划算&淘抢购商品获取 获取商品分类接口 →