您当前的位置：首页 > IT编程 > python
| C语言 | Java | VB | VC | python | Android | TensorFlow | C++ | oracle | 学术与代码 | cnn卷积神经网络 | gnn | 图像修复 | Keras | 数据集 | Neo4j | 自然语言处理 | 深度学习 | 医学CAD | 医学影像 | 超参数 | pointnet | pytorch |

自学教程：taobao.tbk.dg.material.optional( 淘宝客-推广者-物料搜索 )字段
51自学网 2022-01-15 20:41:09
  python
这篇教程taobao.tbk.dg.material.optional( 淘宝客-推广者-物料搜索 )字段写得很实用，希望能帮到您。
taobao.tbk.dg.material.optional( 淘宝客-推广者-物料搜索 )https://open.taobao.com/api.htm?docId=35896&docType=2&scopeId=16516
通用物料搜索API（导购）
 
 

公共参数

请求地址:
环境
HTTP地址
HTTPS地址
正式环境
http://gw.api.taobao.com/router/rest
https://eco.taobao.com/router/rest
 
公共请求参数:
名称
类型
必须
描述
method
String
是
API接口名称，例如:taobao.tbk.dg.material.optional
app_key
String
是
TOP分配给应用的AppKey，例如：12345678
session
String
否
用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选
timestamp
String
是
时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟
v
String
是
API协议版本，可选值：2.0
sign_method
String
是
签名的摘要算法，可选值为：hmac，md5，hmac-sha256。
sign
String
是
API输入参数签名结果，签名算法介绍请点击这里
format
String
否
响应格式。默认为xml格式，可选值：xml，json。
simplify
Boolean
否
是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false
 
公共响应参数:
名称
类型
描述
request_id
String
平台颁发的每次请求访问的唯一标识
error_response
String
请求访问失败时返回的根节点
code
String
请求失败返回的错误码
msg
String
请求失败返回的错误信息
sub_code
String
请求失败返回的子错误码
sub_msg
String
请求失败返回的子错误信息
***_response
String
请求成功返回的根节点，'***' 为API名称的下划线模式
 

请求参数

名称
类型
必须
示例值
描述
start_dsr
Number
false
10
商品筛选(特定媒体支持)-店铺dsr评分。筛选大于等于当前设置的店铺dsr评分的商品0-50000之间
page_size
Number
false
20
页大小，默认20，1~100
page_no
Number
false
1
第几页，默认：１
platform
Number
false
1
链接形式：1：PC，2：无线，默认：１
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），匹配分（match）
itemloc
String
false
杭州
商品筛选-所在地
cat
String
false
16,18
商品筛选-后台类目ID。用,分割，最大10个，该ID可以通过taobao.itemcats.get接口获取到
q
String
false
女装
商品筛选-查询词
material_id
Number
false
2836
不传时默认物料id=2836；如果直接对消费者投放，可使用官方个性化算法优化的搜索物料id=17004
has_coupon
Boolean
false
false
优惠券筛选-是否有优惠券。true表示该商品有优惠券，false或不设置表示不限
ip
String
false
13.2.33.4
ip参数影响邮费获取，如果不传或者传入不准确，邮费无法精准提供
adzone_id
Number
true
12345678
mm_xxx_xxx_12345678三段式的最后一段数字
need_free_shipment
Boolean
false
true
商品筛选-是否包邮。true表示包邮，false或不设置表示不限
need_prepay
Boolean
false
true
商品筛选-是否加入消费者保障。true表示加入，false或不设置表示不限
include_pay_rate_30
Boolean
false
true
商品筛选(特定媒体支持)-成交转化是否高于行业均值。True表示大于等于，false或不设置表示不限
include_good_rate
Boolean
false
true
商品筛选-好评率是否高于行业均值。True表示大于等于，false或不设置表示不限
include_rfd_rate
Boolean
false
true
商品筛选(特定媒体支持)-退款率是否低于行业均值。True表示大于等于，false或不设置表示不限
npx_level
Number
false
2
商品筛选-牛皮癣程度。取值：1不限，2无，3轻微
device_encrypt
String
false
MD5
智能匹配-设备号加密类型：MD5
device_value
String
false
xxx
智能匹配-设备号加密后的值（MD5加密需32位小写）
device_type
String
false
IMEI
智能匹配-设备号类型：IMEI，或者IDFA，或者UTDID（UTDID不支持MD5加密），或者OAID
end_ka_tk_rate
Number
false
1234
商品筛选-KA媒体淘客佣金比率上限。如：1234表示12.34%
start_ka_tk_rate
Number
false
1234
商品筛选-KA媒体淘客佣金比率下限。如：1234表示12.34%
lock_rate_end_time
Number
false
1567440000000
锁佣结束时间
lock_rate_start_time
Number
false
1567440000000
锁佣开始时间
longitude
String
false
121.473701
本地化业务入参-LBS信息-经度
latitude
String
false
31.230370
本地化业务入参-LBS信息-纬度
city_code
String
false
310000
本地化业务入参-LBS信息-国标城市码，仅支持单个请求，请求饿了么卡券物料时，该字段必填。 （详细城市ID见：https://mo.m.taobao.com/page_2020010315120200508）
seller_ids
String
false
1,2,3,4
商家id，仅支持饿了么卡券商家ID，支持批量请求1-100以内，多个商家ID使用英文逗号分隔
special_id
String
false
2323
会员运营ID
relation_id
String
false
3243
渠道关系ID，仅适用于渠道推广场景
page_result_key
String
false
abcdef
本地化业务入参-分页唯一标识，非首页的请求必传，值为上一页返回结果中的page_result_key字段值
ucrowd_id
Number
false
1
人群ID，仅适用于物料评估场景material_id=41377
ucrowd_rank_items
Ucrowdrankitems[]
false
 
物料评估-商品列表
commirate
Number
false
1234
物料评估-商品佣金率，如：1234表示12.34%，material_id=41377时选填
price
BigDecimal
false
10.12
物料评估-商品价格，单位：元，material_id=41377时选填
item_id
String
false
542808901898
物料评估-商品ID，material_id=41377时必填
get_topn_rate
Number
false
0
是否获取前N件佣金信息 0否，1是，其他值否

响应参数

名称
类型
示例值
描述
total_results
Number
1212
搜索到符合条件的结果总数
result_list
MapData []
 
resultList
coupon_start_time
String
2017-10-29
优惠券信息-优惠券开始时间
coupon_end_time
String
2017-10-29
优惠券信息-优惠券结束时间
info_dxjh
String
{"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
shop_title
String
xx旗舰店
店铺信息-店铺名称
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_dsr
Number
13
店铺信息-店铺dsr评分
coupon_share_url
String
uland.xxx
链接-宝贝+券二合一页面链接
url
String
s.click.xxx
链接-宝贝推广链接
level_one_category_name
String
女装
商品信息-一级类目名称
level_one_category_id
Number
20
商品信息-一级类目ID
category_name
String
连衣裙
商品信息-叶子类目名称
category_id
Number
162201
商品信息-叶子类目id
short_title
String
xxsd
商品信息-商品短标题
white_image
String
https://img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg
商品信息-商品白底图
oetime
String
2018-08-21 11:23:43
拼团专用-拼团结束时间
ostime
String
2018-08-21 11:23:43
拼团专用-拼团开始时间
jdd_num
Number
10
拼团专用-拼团几人团
jdd_price
String
5
拼团专用-拼团拼成价，单位元
uv_sum_pre_sale
Number
23
预售专用-预售数量
x_id
String
uESS0mv8JvfJRMKlIgCD5At9VuHVBXoqBRihfQlo4ybLiKygRlqiN4eoxoZDfe38uSogWy6GB971jD2N8tLuuc
链接-物料块id(测试中请勿使用)
coupon_start_fee
String
29.00
优惠券信息-优惠券起用门槛，满X元可用。如：满299元减20元
coupon_amount
String
10.00
优惠券（元） 若属于预售商品，该优惠券付尾款可用，付定金不可用
item_description
String
季凉被 全棉亲肤
商品信息-宝贝描述(推荐理由)
nick
String
旗舰店
店铺信息-卖家昵称
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
String
1567440000000
锁住的佣金率
lock_rate_end_time
Number
1567440000000
锁佣结束时间
lock_rate_start_time
Number
1567440000000
锁佣开始时间
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_commission_rate
String
2030（表示20.3%）
预售有礼-佣金比例（ 预售有礼活动享受的推广佣金比例，注：推广该活动有特殊分成规则，请详见：https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=9334376 ）
ysyl_tlj_face
String
0.6
预售有礼-预估淘礼金（元）
ysyl_click_url
String
https://uland.taobao.com/coupon/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&pid=mm_26381042_12970066_52864659&af=1
预售有礼-推广链接
ysyl_tlj_use_end_time
String
2019-11-10 21:59:59
预售有礼-淘礼金使用结束时间
ysyl_tlj_use_start_time
String
2019-11-10 21:59:59
预售有礼-淘礼金使用开始时间
sale_begin_time
String
1567440000000
本地化-销售开始时间
sale_end_time
String
1567440000000
本地化-销售结束时间
distance
String
300
本地化-到门店距离（米）
usable_shop_id
String
10001
本地化-可用店铺id
usable_shop_name
String
饿了么卡券专营店
本地化-可用店铺名称
sale_price
String
168
活动价
kuadian_promotion_info
String
["每100减20","每200减50"]
跨店满减信息
superior_brand
String
1
是否品牌精选，0不是，1是
reward_info
Number
1
比价场景专用，当系统检测到入参消费者ID购买当前商品会获得《天天开彩蛋》玩法的彩蛋时，该字段显示1，否则为0
is_brand_flash_sale
String
1
是否品牌快抢，0不是，1是
localization_extend
LocalizationMapData
 
本地化-扩展信息
order_lead_time
String
45
本地化-配送时间
user_rating
String
4.8
本地化-用户评分
delivery_min_price
String
20
本地化-起送价
delivery_fee
String
1
本地化-配送费
original_delivery_fee
String
3
本地化-配送费原价
delivery_type
String
1
本地化-配送类型；0：蜂鸟专送 1：蜂鸟快送 2：商家自配 3: 全城送
recommend_reasons
String[]
["酱油无骨炸鸡性价比很高","韩国炸鸡中的热卖餐厅"]
本地化-推荐理由
sale_tags
String[]
["15减10","吃货联盟","首次光顾减1"]
本地化-营销标签
food_item_list
FoodMapData[]
 
本地化-单店商品列表
food_pic
String
https://cube.elemecdn.com/f/7d/7e6f36533e279518460043f81a9c4jpeg.jpeg
本地化-商品图片
food_title
String
单人超巨1+1+1+1自选套餐
本地化-商品标题
food_promotion_price
String
39.88
本地化-商品促销价
food_reserve_price
String
76.8
本地化-商品原价
match_score
String
10.0
物料评估-匹配分
commi_score
String
20.0
物料评估-收益分
hot_flag
String
1
是否是热门商品，0不是，1是
topn_info
TopNInfoDTO
 
前N件佣金信息-前N件佣金生效或预热时透出以下字段
topn_quantity
Number
3000
前N件剩余库存
topn_total_count
Number
3000
前N件初始总库存
topn_end_time
String
1937297392332
前N件佣金结束时间
topn_start_time
String
1937297392332
前N件佣金开始时间
topn_rate
String
30
前N件佣金率
bybt_info
BybtInfoDTO
 
百亿补贴信息
bybt_brand_logo
String
//img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg
百亿补贴品牌logo
bybt_pic_url
String
//img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg
百亿补贴白底图
bybt_item_tags
String[]
["https://gw.alicdn.com/tfs/TB1CvN50KH2gK0jSZJnXXaT1FXa-167-42.png?getAvatar=avatar","https://gw.alicdn.com/tfs/TB10rZqkCR26e4jSZFEXXbwuXXa-132-42.png?getAvatar=avatar"]
百亿补贴商品特征标签，eg.今日发货、晚发补偿、限购一件等
bybt_coupon_amount
String
10.00
百亿补贴专属券面额，仅限百亿补贴场景透出
bybt_show_price
String
100.00
百亿补贴页面实时价
bybt_lowest_price
String
200.00
全网对比参考价格
bybt_end_time
String
1559750399000
商品的百亿补贴开始时间
bybt_start_time
String
1559750399000
商品的百亿补贴结束时间
tt_sold_count
String
200+
商品入驻淘特后产生的所有销量量级，不特指某段具体时间
maifan_promotion
MaifanPromotionDTO
 
猫超买返卡信息
maifan_promotion_end_time
String
1559750399000
猫超买返卡活动结束时间
maifan_promotion_start_time
String
1559750399000
猫超买返卡活动开始时间
maifan_promotion_discount
String
200
猫超买返卡面额
maifan_promotion_condition
String
100
猫超买返卡总数，-1代表不限量，其他大于等于0的值为总数
cpa_reward_type
String
0 1 2
额外奖励活动类型，如果一个商品有多个奖励类型，返回结果使用空格分割，0=单单奖励(已失效)，1=超级单单奖励(已失效)，2=年货节单单奖励
cpa_reward_amount
String
1.11 2.22 3.21
额外奖励活动金额，活动奖励金额的类型与cpa_reward_type字段对应，如果一个商品有多个奖励类型，返回结果使用空格分割
activity_id
String
188
合作伙伴单单补ID，用作“年货节超级单单补”活动合作伙伴奖励统计依据
page_result_key
String
abcde
本地化-lbs分页标识，请在下一次翻页时作为入参传入

解决 Package 'setuptools' requires a different Python: 2.7.12 not in '>=3.5' 问题
淘宝api开发实例python
51自学网，即我要自学网，自学EXCEL、自学PS、自学CAD、自学C语言、自学css3实例，是一个通过网络自主学习工作技能的自学平台，网友喜欢的软件自学网站。
京ICP备13026421号-1