淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
page_size	Number	可选	20	默认值：20	页大小，默认20，1~100
page_no	Number	可选	1	默认值：1	第几页，默认：1
adzone_id	Number	必须	123		mm_xxx_xxx_xxx的第三位
material_id	Number	必须	123		官方的物料Id(详细物料id见：https://market.m.taobao.com/app/qn/toutiao-new/index-pc.html#/detail/10628875?_k=gpov9a)
device_value	String	可选	xxx		智能匹配-设备号加密后的值（MD5加密需32位小写），类型为OAID时传原始OAID值
device_encrypt	String	可选	MD5		智能匹配-设备号加密类型：MD5，类型为OAID时不传
device_type	String	可选	IMEI		智能匹配-设备号类型：IMEI，或者IDFA，或者UTDID（UTDID不支持MD5加密），或者OAID
content_id	Number	可选	323		内容专用-内容详情ID
content_source	String	可选	xxx		内容专用-内容渠道信息
item_id	String	可选	33243		商品ID，用于相似商品推荐
favorites_id	String	可选	123445		选品库投放id

名称	类型	示例值	描述
result_list	MapData []		resultList
└ coupon_amount Number 40 优惠券（元）若属于预售商品，该优惠券付尾款可用，付定金不可用 └ small_images String [] 商品信息-商品小图列表 └ shop_title String 魔黛娅内衣旗舰店店铺信息-店铺名称 └ category_id Number 162201 商品信息-叶子类目id └ coupon_start_fee String 69 优惠券信息-优惠券起用门槛，满X元可用。如：满299元减20元 └ item_id String 556633720749 商品信息-宝贝id └ coupon_total_count Number 30000 优惠券信息-优惠券总量 └ user_type Number 1 店铺信息-卖家类型，0表示淘宝，1表示天猫，3表示特价版 └ zk_final_price String 79.9 折扣价（元）若属于预售商品，付定金时间内，折扣价=预售价 └ coupon_remain_count Number 1936 优惠券信息-优惠券剩余量 └ commission_rate String 5.50 商品信息-佣金比率(%) └ coupon_start_time String 2017-10-29 优惠券信息-优惠券开始时间 └ title String 毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款商品信息-商品标题 └ item_description String 裤子商品信息-宝贝描述（推荐理由,不一定有） └ seller_id Number 745957850 店铺信息-卖家id └ volume Number 3837 商品信息-30天销量 └ coupon_end_time String 2017-11-02 优惠券信息-优惠券结束时间 └ coupon_click_url String //uland.taobao.com/coupon/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&mt=1&app_pvid=0ab0fac715095507006577956e&ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8 链接-宝贝+券二合一页面链接(该字段废弃，请勿再用) └ pict_url String //img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg 商品信息-商品主图 └ click_url String //item.taobao.com/item.htm?id=556633720749&scm=1007.16190.92234.0&pvid=41362290-fa0b-4252-b172-6afc9c00e2c8&app_pvid=0ab0fac715095507006577956e 链接-宝贝推广链接 └ stock Number 123 拼团专用-拼团剩余库存 └ sell_num Number 123 拼团专用-拼团已售数量 └ total_stock Number 123 拼团专用-拼团库存数量 └ oetime String 1640317400000 拼团专用-拼团结束时间 └ ostime String 1640317400000 拼团专用-拼团开始时间 └ jdd_num Number 1 拼团专用-拼团几人团 └ jdd_price String 12 拼团专用-拼团拼成价，单位元 └ orig_price String 12 拼团专用-拼团一人价（原价)，单位元 └ level_one_category_name String 美妆商品信息-一级类目名称 └ level_one_category_id Number 1 商品信息-一级类目ID └ category_name String 牛仔裤商品信息-叶子类目名称 └ white_image String https://img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg 商品信息-商品白底图 └ short_title String sss 商品信息-商品短标题 word_list WordMapData [] 商品信息-商品关联词 └ url String https://uland.taobao.com/semm/tbxxxx 链接-商品相关关联词落地页地址 └ word String 孕妇装商品相关的关联词 └ tmall_play_activity_info String 前n件x折营销-天猫营销玩法 └ uv_sum_pre_sale Number 21 商品信息-预售数量 └ x_id String uESS0mv8JvfJRMKlIgCD5At9VuHVBXoqBRihfQlo4ybLiKygRlqiN4eoxoZDfe38uSogWy6GB971jD2N8tLuuc 物料块id(测试中请勿使用) └ new_user_price String 1.99 商品信息-新人价 └ coupon_info String 满299减30元优惠券信息-优惠券满减信息 └ coupon_share_url String //uland.taobao.com/coupon/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&mt=1&app_pvid=0ab0fac715095507006577956e&ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8 链接-宝贝+券二合一页面链接 └ nick String 秉迪数码专营店店铺信息-卖家昵称 └ reserve_price String 2.99 商品信息-一口价 └ ju_online_end_time String 1559750399000 聚划算信息-聚淘结束时间 └ ju_online_start_time String 1559232000000 聚划算信息-聚淘开始时间 └ maochao_play_end_time String 1559750399000 猫超玩法信息-活动结束时间，精确到毫秒 └ maochao_play_start_time String 1559232000000 猫超玩法信息-活动开始时间，精确到毫秒 └ maochao_play_conditions String 2,3 猫超玩法信息-折扣条件，价格百分数存储，件数按数量存储。可以有多个折扣条件，与折扣字段对应，','分割 └ maochao_play_discounts String 500,450 猫超玩法信息-折扣，折扣按照百分数存储，其余按照单位分存储。可以有多个折扣，','分割 └ maochao_play_discount_type String 2 猫超玩法信息-玩法类型，2:折扣(满n件折扣),5:减钱(满n元减m元) └ maochao_play_free_post_fee String 1 猫超玩法信息-当前是否包邮，1:是，0:否 └ multi_coupon_zk_rate String 0.41234 多件券优惠比例 └ price_after_multi_coupon String 9.9 多件券件单价 └ multi_coupon_item_count String 3 多件券单品件数 └ lock_rate String 110 锁住的佣金率 └ lock_rate_end_time Number 1567440000000 锁佣结束时间 └ lock_rate_start_time Number 1567440000000 锁佣开始时间 └ promotion_type String 1 满减满折的类型（1. 满减 2. 满折） └ promotion_info String 满2件打5折；满300减20 满减满折信息 └ promotion_discount String 300 满减满折门槛（满2件打5折中值为2；满300减20中值为300） └ promotion_condition String 5 满减满折优惠（满2件打5折中值为5；满300减20中值为20） └ 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_use_start_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_send_time String 2019-11-10 21:59:59 预售有礼-淘礼金发放时间 └ 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 预售有礼-淘礼金使用结束时间 └ ju_play_end_time Number 1567440000000 聚划算满减 -结束时间（毫秒） └ ju_play_start_time Number 1567440000000 聚划算满减 -开始时间（毫秒） └ play_info String 玩法 1聚划算满减：满N件减X元，满N件X折，满N件X元） 2天猫限时抢：前N分钟每件X元，前N分钟满N件每件X元，前N件每件X元） └ tmall_play_activity_end_time Number 1567440000000 天猫限时抢可售 -结束时间（毫秒） └ tmall_play_activity_start_time Number 1567440000000 天猫限时抢可售 -开始时间（毫秒） └ ju_pre_show_end_time String 1581868800000 聚划算信息-商品预热开始时间（毫秒） └ ju_pre_show_start_time String 1582300799000 聚划算信息-商品预热结束时间（毫秒） favorites_info FavoritesInfo 选品库信息 └ total_count Number 100 选品库总数量 favorites_list FavoritesDetail [] 选品库详细信息 └ favorites_id Number 12334 选品库id └ favorites_title String 测试选品库选品库标题 └ sale_price String 168 活动价 └ kuadian_promotion_info String ["每100减20","每200减50"] 跨店满减信息 └ sub_title String 吉品鲍鱼关西参商品子标题 └ jhs_price_usp_list String 满200减10 聚划算商品价格卖点描述 └ tqg_online_end_time String 1581868800000 淘抢购商品专用-结束时间 └ tqg_online_start_time String 1581868800000 淘抢购商品专用-开团时间 └ tqg_sold_count Number 20 淘抢购商品专用-已抢购数量 └ tqg_total_count Number 50 淘抢购商品专用-总库存 └ superior_brand String 1 是否品牌精选，0不是，1是 └ is_brand_flash_sale String 1 是否品牌快抢，0不是，1是 └ 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，用作“年货节超级单单补”活动合作伙伴奖励统计依据 sp_campaign_list SpCampaign [] 定向计划集合 └ sp_cid String 123 定向计划活动ID └ sp_name String 定向计划活动1 定向计划名称 └ sp_rate String 1550表示15.5% 定向佣金率 └ sp_lock_status String 0 定向是否锁佣，0=不锁佣 1=锁佣 └ sp_apply_link String http://pub.alimama.com/portal/promo/shop/campaign/detail.htm?mode=info&campaignId=1000492470&creatorId=98836808&breadcrumb=false 定向计划申请链接 └ sp_status String 1 定向计划是否可用 1-可用 0-不可用
is_default	String	false	推荐信息-是否抄底
total_count	Number	100	商品总数-目前只有全品库商品查询有该字段

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkDgOptimusMaterialRequest req = new TbkDgOptimusMaterialRequest();
req.setPageSize(20L);
req.setPageNo(1L);
req.setAdzoneId(123L);
req.setMaterialId(123L);
req.setDeviceValue("xxx");
req.setDeviceEncrypt("MD5");
req.setDeviceType("IMEI");
req.setContentId(323L);
req.setContentSource("xxx");
req.setItemId("33243");
req.setFavoritesId("123445");
TbkDgOptimusMaterialResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TbkDgOptimusMaterialRequest req = new TbkDgOptimusMaterialRequest();
req.PageSize = 20L;
req.PageNo = 1L;
req.AdzoneId = 123L;
req.MaterialId = 123L;
req.DeviceValue = "xxx";
req.DeviceEncrypt = "MD5";
req.DeviceType = "IMEI";
req.ContentId = 323L;
req.ContentSource = "xxx";
req.ItemId = "33243";
req.FavoritesId = "123445";
TbkDgOptimusMaterialResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TbkDgOptimusMaterialRequest;
$req->setPageSize("20");
$req->setPageNo("1");
$req->setAdzoneId("123");
$req->setMaterialId("123");
$req->setDeviceValue("xxx");
$req->setDeviceEncrypt("MD5");
$req->setDeviceType("IMEI");
$req->setContentId("323");
$req->setContentSource("xxx");
$req->setItemId("33243");
$req->setFavoritesId("123445");
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.tbk.dg.optimus.material' \
-d 'partner_id=apidoc' \
-d 'sign=B72D0CE8908EA1A794979B06B691A65C' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-01-16+01%3A03%3A52' \
-d 'v=2.0' \
-d 'adzone_id=123' \
-d 'content_id=323' \
-d 'content_source=xxx' \
-d 'device_encrypt=MD5' \
-d 'device_type=IMEI' \
-d 'device_value=xxx' \
-d 'favorites_id=123445' \
-d 'item_id=33243' \
-d 'material_id=123' \
-d 'page_no=1' \
-d 'page_size=20'

# -*- coding: utf-8 -*-
import top.api

req=top.api.TbkDgOptimusMaterialRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.page_size=20
req.page_no=1
req.adzone_id=123
req.material_id=123
req.device_value="xxx"
req.device_encrypt="MD5"
req.device_type="IMEI"
req.content_id=323
req.content_source="xxx"
req.item_id="33243"
req.favorites_id="123445"
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.tbk.dg.optimus.material");
add_param(pRequest,"page_size","20");
add_param(pRequest,"page_no","1");
add_param(pRequest,"adzone_id","123");
add_param(pRequest,"material_id","123");
add_param(pRequest,"device_value","xxx");
add_param(pRequest,"device_encrypt","MD5");
add_param(pRequest,"device_type","IMEI");
add_param(pRequest,"content_id","323");
add_param(pRequest,"content_source","xxx");
add_param(pRequest,"item_id","33243");
add_param(pRequest,"favorites_id","123445");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.tbk.dg.optimus.material', {
	'page_size':'20',
	'page_no':'1',
	'adzone_id':'123',
	'material_id':'123',
	'device_value':'xxx',
	'device_encrypt':'MD5',
	'device_type':'IMEI',
	'content_id':'323',
	'content_source':'xxx',
	'item_id':'33243',
	'favorites_id':'123445'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<tbk_dg_optimus_material_response>
    <result_list>
        <map_data>
            <coupon_amount>40</coupon_amount>
            <small_images>
                <string></string>
            </small_images>
            <shop_title>魔黛娅内衣旗舰店</shop_title>
            <category_id>162201</category_id>
            <coupon_start_fee>69</coupon_start_fee>
            <item_id>556633720749</item_id>
            <coupon_total_count>30000</coupon_total_count>
            <user_type>1</user_type>
            <zk_final_price>79.9</zk_final_price>
            <coupon_remain_count>1936</coupon_remain_count>
            <commission_rate>5.50</commission_rate>
            <coupon_start_time>2017-10-29</coupon_start_time>
            <title>毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款</title>
            <item_description>裤子</item_description>
            <seller_id>745957850</seller_id>
            <volume>3837</volume>
            <coupon_end_time>2017-11-02</coupon_end_time>
            <coupon_click_url>//uland.taobao.com/coupon/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&amp;mt=1&amp;app_pvid=0ab0fac715095507006577956e&amp;ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8</coupon_click_url>
            <pict_url>//img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg</pict_url>
            <click_url>//item.taobao.com/item.htm?id=556633720749&amp;scm=1007.16190.92234.0&amp;pvid=41362290-fa0b-4252-b172-6afc9c00e2c8&amp;app_pvid=0ab0fac715095507006577956e</click_url>
            <stock>123</stock>
            <sell_num>123</sell_num>
            <total_stock>123</total_stock>
            <oetime>1640317400000</oetime>
            <ostime>1640317400000</ostime>
            <jdd_num>1</jdd_num>
            <jdd_price>12</jdd_price>
            <orig_price>12</orig_price>
            <level_one_category_name>美妆</level_one_category_name>
            <level_one_category_id>1</level_one_category_id>
            <category_name>牛仔裤</category_name>
            <white_image>https://img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg</white_image>
            <short_title>sss</short_title>
            <word_list>
                <word_map_data>
                    <url>https://uland.taobao.com/semm/tbxxxx</url>
                    <word>孕妇装</word>
                </word_map_data>
            </word_list>
            <tmall_play_activity_info>前n件x折</tmall_play_activity_info>
            <uv_sum_pre_sale>21</uv_sum_pre_sale>
            <x_id>uESS0mv8JvfJRMKlIgCD5At9VuHVBXoqBRihfQlo4ybLiKygRlqiN4eoxoZDfe38uSogWy6GB971jD2N8tLuuc</x_id>
            <new_user_price>1.99</new_user_price>
            <coupon_info>满299减30元</coupon_info>
            <coupon_share_url>//uland.taobao.com/coupon/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&amp;mt=1&amp;app_pvid=0ab0fac715095507006577956e&amp;ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8</coupon_share_url>
            <nick>秉迪数码专营店</nick>
            <reserve_price>2.99</reserve_price>
            <ju_online_end_time>1559750399000</ju_online_end_time>
            <ju_online_start_time>1559232000000</ju_online_start_time>
            <maochao_play_end_time>1559750399000</maochao_play_end_time>
            <maochao_play_start_time>1559232000000</maochao_play_start_time>
            <maochao_play_conditions>2,3</maochao_play_conditions>
            <maochao_play_discounts>500,450</maochao_play_discounts>
            <maochao_play_discount_type>2</maochao_play_discount_type>
            <maochao_play_free_post_fee>1</maochao_play_free_post_fee>
            <multi_coupon_zk_rate>0.41234</multi_coupon_zk_rate>
            <price_after_multi_coupon>9.9</price_after_multi_coupon>
            <multi_coupon_item_count>3</multi_coupon_item_count>
            <lock_rate>110</lock_rate>
            <lock_rate_end_time>1567440000000</lock_rate_end_time>
            <lock_rate_start_time>1567440000000</lock_rate_start_time>
            <promotion_type>1</promotion_type>
            <promotion_info>满2件打5折；满300减20</promotion_info>
            <promotion_discount>300</promotion_discount>
            <promotion_condition>5</promotion_condition>
            <presale_discount_fee_text>付定金立减5元</presale_discount_fee_text>
            <presale_tail_end_time>1567440000000</presale_tail_end_time>
            <presale_tail_start_time>1567440000000</presale_tail_start_time>
            <presale_end_time>1567440000000</presale_end_time>
            <presale_start_time>1567440000000</presale_start_time>
            <presale_deposit>100</presale_deposit>
            <ysyl_tlj_use_start_time>2019-11-10 21:59:59</ysyl_tlj_use_start_time>
            <ysyl_commission_rate>2030（表示20.3%）</ysyl_commission_rate>
            <ysyl_tlj_send_time>2019-11-10 21:59:59</ysyl_tlj_send_time>
            <ysyl_tlj_face>0.6</ysyl_tlj_face>
            <ysyl_click_url>https://uland.taobao.com/coupon/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&amp;pid=mm_26381042_12970066_52864659&amp;af=1</ysyl_click_url>
            <ysyl_tlj_use_end_time>2019-11-10 21:59:59</ysyl_tlj_use_end_time>
            <ju_play_end_time>1567440000000</ju_play_end_time>
            <ju_play_start_time>1567440000000</ju_play_start_time>
            <play_info>玩法</play_info>
            <tmall_play_activity_end_time>1567440000000</tmall_play_activity_end_time>
            <tmall_play_activity_start_time>1567440000000</tmall_play_activity_start_time>
            <ju_pre_show_end_time>1581868800000</ju_pre_show_end_time>
            <ju_pre_show_start_time>1582300799000</ju_pre_show_start_time>
            <favorites_info>
                <total_count>100</total_count>
                <favorites_list>
                    <favorites_detail>
                        <favorites_id>12334</favorites_id>
                        <favorites_title>测试选品库</favorites_title>
                    </favorites_detail>
                </favorites_list>
            </favorites_info>
            <sale_price>168</sale_price>
            <kuadian_promotion_info>[&quot;每100减20&quot;,&quot;每200减50&quot;]</kuadian_promotion_info>
            <sub_title>吉品鲍鱼 关西参</sub_title>
            <jhs_price_usp_list>满200减10</jhs_price_usp_list>
            <tqg_online_end_time>1581868800000</tqg_online_end_time>
            <tqg_online_start_time>1581868800000</tqg_online_start_time>
            <tqg_sold_count>20</tqg_sold_count>
            <tqg_total_count>50</tqg_total_count>
            <superior_brand>1</superior_brand>
            <is_brand_flash_sale>1</is_brand_flash_sale>
            <hot_flag>1</hot_flag>
            <topn_info>
                <topn_quantity>3000</topn_quantity>
                <topn_total_count>3000</topn_total_count>
                <topn_end_time>1937297392332</topn_end_time>
                <topn_start_time>1937297392332</topn_start_time>
                <topn_rate>30</topn_rate>
            </topn_info>
            <bybt_info>
                <bybt_brand_logo>//img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg</bybt_brand_logo>
                <bybt_pic_url>//img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg</bybt_pic_url>
                <bybt_item_tags>
                    <string>[&quot;https://gw.alicdn.com/tfs/TB1CvN50KH2gK0jSZJnXXaT1FXa-167-42.png?getAvatar=avatar&quot;</string>
                    <string>&quot;https://gw.alicdn.com/tfs/TB10rZqkCR26e4jSZFEXXbwuXXa-132-42.png?getAvatar=avatar&quot;]</string>
                </bybt_item_tags>
                <bybt_coupon_amount>10.00</bybt_coupon_amount>
                <bybt_show_price>100.00</bybt_show_price>
                <bybt_lowest_price>200.00</bybt_lowest_price>
                <bybt_end_time>1559750399000</bybt_end_time>
                <bybt_start_time>1559750399000</bybt_start_time>
            </bybt_info>
            <tt_sold_count>200+</tt_sold_count>
            <maifan_promotion>
                <maifan_promotion_end_time>1559750399000</maifan_promotion_end_time>
                <maifan_promotion_start_time>1559750399000</maifan_promotion_start_time>
                <maifan_promotion_discount>200</maifan_promotion_discount>
                <maifan_promotion_condition>100</maifan_promotion_condition>
            </maifan_promotion>
            <cpa_reward_type>0 1 2</cpa_reward_type>
            <cpa_reward_amount>1.11 2.22 3.21</cpa_reward_amount>
            <activity_id>188</activity_id>
            <sp_campaign_list>
                <sp_campaign>
                    <sp_cid>123</sp_cid>
                    <sp_name>定向计划活动1</sp_name>
                    <sp_rate>1550表示15.5%</sp_rate>
                    <sp_lock_status>0</sp_lock_status>
                    <sp_apply_link>http://pub.alimama.com/portal/promo/shop/campaign/detail.htm?mode=info&amp;campaignId=1000492470&amp;creatorId=98836808&amp;breadcrumb=false</sp_apply_link>
                    <sp_status>1</sp_status>
                </sp_campaign>
            </sp_campaign_list>
        </map_data>
    </result_list>
    <is_default>false</is_default>
    <total_count>100</total_count>
</tbk_dg_optimus_material_response>

{
    "tbk_dg_optimus_material_response":{
        "result_list":{
            "map_data":[
                {
                    "coupon_amount":40,
                    "small_images":{
                        "string":[
                            ""
                        ]
                    },
                    "shop_title":"魔黛娅内衣旗舰店",
                    "category_id":162201,
                    "coupon_start_fee":"69",
                    "item_id":"556633720749",
                    "coupon_total_count":30000,
                    "user_type":1,
                    "zk_final_price":"79.9",
                    "coupon_remain_count":1936,
                    "commission_rate":"5.50",
                    "coupon_start_time":"2017-10-29",
                    "title":"毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款",
                    "item_description":"裤子",
                    "seller_id":745957850,
                    "volume":3837,
                    "coupon_end_time":"2017-11-02",
                    "coupon_click_url":"\/\/uland.taobao.com\/coupon\/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&mt=1&app_pvid=0ab0fac715095507006577956e&ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8",
                    "pict_url":"\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg",
                    "click_url":"\/\/item.taobao.com\/item.htm?id=556633720749&scm=1007.16190.92234.0&pvid=41362290-fa0b-4252-b172-6afc9c00e2c8&app_pvid=0ab0fac715095507006577956e",
                    "stock":123,
                    "sell_num":123,
                    "total_stock":123,
                    "oetime":"1640317400000",
                    "ostime":"1640317400000",
                    "jdd_num":1,
                    "jdd_price":"12",
                    "orig_price":"12",
                    "level_one_category_name":"美妆",
                    "level_one_category_id":1,
                    "category_name":"牛仔裤",
                    "white_image":"https:\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg",
                    "short_title":"sss",
                    "word_list":{
                        "word_map_data":[
                            {
                                "url":"https:\/\/uland.taobao.com\/semm\/tbxxxx",
                                "word":"孕妇装"
                            }
                        ]
                    },
                    "tmall_play_activity_info":"前n件x折",
                    "uv_sum_pre_sale":21,
                    "x_id":"uESS0mv8JvfJRMKlIgCD5At9VuHVBXoqBRihfQlo4ybLiKygRlqiN4eoxoZDfe38uSogWy6GB971jD2N8tLuuc",
                    "new_user_price":"1.99",
                    "coupon_info":"满299减30元",
                    "coupon_share_url":"\/\/uland.taobao.com\/coupon\/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&mt=1&app_pvid=0ab0fac715095507006577956e&ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8",
                    "nick":"秉迪数码专营店",
                    "reserve_price":"2.99",
                    "ju_online_end_time":"1559750399000",
                    "ju_online_start_time":"1559232000000",
                    "maochao_play_end_time":"1559750399000",
                    "maochao_play_start_time":"1559232000000",
                    "maochao_play_conditions":"2,3",
                    "maochao_play_discounts":"500,450",
                    "maochao_play_discount_type":"2",
                    "maochao_play_free_post_fee":"1",
                    "multi_coupon_zk_rate":"0.41234",
                    "price_after_multi_coupon":"9.9",
                    "multi_coupon_item_count":"3",
                    "lock_rate":"110",
                    "lock_rate_end_time":1567440000000,
                    "lock_rate_start_time":1567440000000,
                    "promotion_type":"1",
                    "promotion_info":"满2件打5折；满300减20",
                    "promotion_discount":"300",
                    "promotion_condition":"5",
                    "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",
                    "ysyl_tlj_use_start_time":"2019-11-10 21:59:59",
                    "ysyl_commission_rate":"2030（表示20.3%）",
                    "ysyl_tlj_send_time":"2019-11-10 21:59:59",
                    "ysyl_tlj_face":"0.6",
                    "ysyl_click_url":"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":"2019-11-10 21:59:59",
                    "ju_play_end_time":1567440000000,
                    "ju_play_start_time":1567440000000,
                    "play_info":"玩法",
                    "tmall_play_activity_end_time":1567440000000,
                    "tmall_play_activity_start_time":1567440000000,
                    "ju_pre_show_end_time":"1581868800000",
                    "ju_pre_show_start_time":"1582300799000",
                    "favorites_info":{
                        "total_count":100,
                        "favorites_list":{
                            "favorites_detail":[
                                {
                                    "favorites_id":12334,
                                    "favorites_title":"测试选品库"
                                }
                            ]
                        }
                    },
                    "sale_price":"168",
                    "kuadian_promotion_info":"[\"每100减20\",\"每200减50\"]",
                    "sub_title":"吉品鲍鱼 关西参",
                    "jhs_price_usp_list":"满200减10",
                    "tqg_online_end_time":"1581868800000",
                    "tqg_online_start_time":"1581868800000",
                    "tqg_sold_count":20,
                    "tqg_total_count":50,
                    "superior_brand":"1",
                    "is_brand_flash_sale":"1",
                    "hot_flag":"1",
                    "topn_info":{
                        "topn_quantity":3000,
                        "topn_total_count":3000,
                        "topn_end_time":"1937297392332",
                        "topn_start_time":"1937297392332",
                        "topn_rate":"30"
                    },
                    "bybt_info":{
                        "bybt_brand_logo":"\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg",
                        "bybt_pic_url":"\/\/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\"]"
                            ]
                        },
                        "bybt_coupon_amount":"10.00",
                        "bybt_show_price":"100.00",
                        "bybt_lowest_price":"200.00",
                        "bybt_end_time":"1559750399000",
                        "bybt_start_time":"1559750399000"
                    },
                    "tt_sold_count":"200+",
                    "maifan_promotion":{
                        "maifan_promotion_end_time":"1559750399000",
                        "maifan_promotion_start_time":"1559750399000",
                        "maifan_promotion_discount":"200",
                        "maifan_promotion_condition":"100"
                    },
                    "cpa_reward_type":"0 1 2",
                    "cpa_reward_amount":"1.11 2.22 3.21",
                    "activity_id":"188",
                    "sp_campaign_list":{
                        "sp_campaign":[
                            {
                                "sp_cid":"123",
                                "sp_name":"定向计划活动1",
                                "sp_rate":"1550表示15.5%",
                                "sp_lock_status":"0",
                                "sp_apply_link":"http:\/\/pub.alimama.com\/portal\/promo\/shop\/campaign\/detail.htm?mode=info&campaignId=1000492470&creatorId=98836808&breadcrumb=false",
                                "sp_status":"1"
                            }
                        ]
                    }
                }
            ]
        },
        "is_default":"false",
        "total_count":100
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案
isp.tbkapi-service-unavailable	淘宝客API服务不可用	请稍后重试
isv.invalid-parameter:start_price	参数填写不正确	参数填写不正确
isv.invalid-parameter:end_price	参数填写不正确	参数填写不正确
isv.invalid-parameter:end_tk_rate	参数填写不正确	参数填写不正确
4	查询不到对应的adzoneId	请检查adzoneId是否正确
2	pid不正确	请检查是否输入了正确的adzoneId和siteId
50001	无结果	宝贝数据为空，请重新查询
isp.sys-error	服务异常	请稍后重试
30001	无效物料ID	请传入有效的物料ID
40001	调用失败	请重新调用
50002	调用频率过高	请稍后再试
41	pageSize不合法	参考文档或设置为1~7之间
isp.entry-sys-error	内部服务出错	稍后重试
1103	活动物料id无效	检查调用参数
1201	口令类型无效	检查调用参数

API测试工具错误码查询工具 SDK下载

淘宝客API

taobao.tbk.dg.optimus.material (淘宝客-推广者-物料精选)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ