淘宝开放平台 - 文档中心

请求地址：

环境	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。

名称	类型	是否必须	示例值	描述
site	String	必须	TW	站点标识：TW(台湾)；HK(香港)；MY(马来)；SG(新加坡)；AU(澳大利亚)；CA(加拿大)；MO(澳门)；GLOBAL(全球)，GLOBAL（全球）不存在禁限售的逻辑，若填写指定的站点，会校验禁限售的逻辑。 -- Site Identifier: TW (Taiwan); HK (Hong Kong); MY (Malaysia); SG (Singapore); AU (Australia); CA (Canada); MO (Macau); GLOBAL (Global). The "GLOBAL" identifier does not apply any restricted or prohibited sales logic. If a specific site is specified, the restricted/prohibited sales logic will be enforced.
item_ids	String	必须	O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ	商品ID串，用,分割，最大40个 -- Product ID string, separated by commas, maximum 40 entries.
language	String	必须	zh_CN	语言：zh_CN(中文)；en_US(英文) -- Language: zh_CN (Chinese); en_US (English)

名称	类型	示例值	描述
items	MaterialItemSummaryInfo []		商品列表 -- Product list
└ item_id String O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ 商品信息-淘宝客新商品ID -- Product information - Taobao Partner new product ID coupon_info MaterialItemCouponInfoDTO 商品优惠券信息 -- Product coupon information └ coupon_start_fee String 17 优惠券信息-满减的满额 -- Coupon information - Minimum amount for discount └ coupon_remain_count Number 27000 优惠券信息-券数量 -- Coupon information - Number of coupons └ coupon_amount String 5 优惠券信息-券面额 -- Coupon information - Coupon value └ coupon_activity_id String 30660aec6d334a929186b8ca49892bca 优惠券信息-券模版ID -- Coupon information - Coupon template ID └ coupon_sale_text_info String 满17元减5元优惠券信息-券文案 -- Coupon information - Coupon description └ coupon_effective_start_time Number 1748361600000 优惠券信息-券有效时间-开始时间毫秒时间戳 – Coupon information - Coupon validity period - Start time (in milliseconds timestamp) └ coupon_effective_end_time Number 1749052799000 优惠券信息-券有效时间-结束时间毫秒时间戳 – Coupon information - Coupon validity period - End time (in milliseconds timestamp) publish_info MaterialItemPublishInfoDTO 淘客推广信息 -- Taobao Partner promotion information income_info MaterialItemIncomeInfoDTO 商品佣金信息 -- Product commission information └ commission_rate String 200 商品佣金比率 -- Product commission rate └ lock_rate_start_time Number 1748361600000 推广信息-商品信息-锁佣开始时间 -- Promotion information - product information - commission lock start time └ lock_rate String 300 推广信息-商品信息-锁住的佣金率 -- Promotion information - product information - locked commission rate └ lock_rate_end_time Number 1749052799000 推广信息-商品信息-锁佣结束时间 -- Promotion information - product information - commission lock end time └ commission_amount String 0.30 商品佣金金额 -- Product commission amount └ income_rate String 2.00 商品信息-收入比率(%)；商品佣金比率+补贴比率 -- Product Info - Income Rate (%); Product Commission Rate + Subsidy Rate └ commission_type String MKT 佣金类型。MKT表示营销计划，SP表示定向计划，COMMON表示通用计划，ZX表示自选计划 –- Commission type. MKT represents Marketing Plan, SP represents Targeted Plan, COMMON represents General Plan, ZX represents Custom Plan price_promotion_info MaterialItemPromotionInfoDTO 价格促销信息 -- Price promotion information └ reserve_price String 69.8 商品信息-一口价，通常显示为划线价 –- Product information - Fixed price, usually displayed as a strike-through price └ predict_rounding_up_price String 9.9 促销信息-预估凑单价（元）。预估凑单叠加优惠后的商品单价 -- Promotion information - estimated bundle price (RMB). Estimated unit price after combining bundle and discounts. promotion_tag_list MaterialItemPromotionTagDTO [] 标签信息列表 -- Tag information list └ tag_name String 满100减10 标签名称 -- Tag name └ final_promotion_price String 59.9 促销信息-预估到手价(元)。若属于预售商品，付定金时间内，预估到手价价=定金+尾款的预估到手价 -- Promotion information - estimated final price (RMB). For pre-sale items, during the deposit payment period, the estimated final price equals the deposit plus the estimated balance payment price. └ predict_rounding_up_price_desc String 需凑单，需买2件促销信息-凑单价说明，描述凑单价的实现说明。如 “可凑单”或“需买X件” -- Promotion information - bundle price description, explaining how the bundle price is achieved, such as "bundling available" or "need to buy X items". final_promotion_path_list MaterialItemPromotionPathDTO [] 到手价优惠路径列表 -- Final price discount path list └ promotion_title String 商品券优惠名称 -- Discount name └ promotion_start_time Number 1750435200000 优惠开始时间 -- Discount start time └ promotion_desc String 满15减6 优惠利益点文案，如“1件7.92折”、“每200减20”等 -- Discount benefit description, such as "7.92% off for 1 item", "20 RMB off every 200 RMB", etc. └ promotion_id String 4c1fd912051543e1ab095e5925618bf7 优惠ID -- Discount ID └ promotion_end_time Number 1751299199000 优惠结束时间 -- Discount end time └ promotion_fee String 6 实际优惠金额（元） -- Actual discount amount (RMB) └ zk_final_price String 29.9 促销信息-销售价格，无促销时等于一口价，有促销时为促销价。若属于预售商品，付定金时间内，在线售卖价=预售价 -- Promotion information - selling price. When there is no promotion, it equals the fixed price; when there is a promotion, it is the promotional price. For pre-sale items, during the deposit payment period, the online selling price equals the pre-sale price. more_promotion_list MaterialItemMorePromotionDTO [] 更多活动优惠 -- More promotional discounts └ promotion_title String 秒杀直降优惠名称 -- Discount name └ promotion_start_time String 1748966401000 优惠开始时间 -- Discount start time └ promotion_desc String 直降9元优惠利益点文案，如“1件7.92折”、“每200减20”等 -- Discount benefit description, such as "7.92% off for 1 item", "20 RMB off every 200 RMB", etc. └ promotion_end_time String 1753943938000 优惠结束时间 -- Discount end time └ promotion_id String 2191463496637 优惠ID -- Discount ID item_basic_info MaterialItemBasicInfoDTO 商品基本信息 -- Basic product information └ white_image String https://img.alicdn.com/bao/uploaded/O1CN01u4x0VE25MYAW4d8ep_!!6000000007512-0-yinhe.jpg 商品信息-商品白底图 -- Product information - product image with white background └ brand_name String 凯利来商品信息-品牌名称 -- Product information - brand name └ level_one_category_name String 零食/坚果/特产商品信息-一级类目名称 -- Product information - primary category name └ pict_url String https://img.alicdn.com/bao/uploaded/i1/3461918757/O1CN01rvW7VL2EYlLspAtaW_!!0-item_pic.jpg 商品信息-商品主图 -- Product information - main product image └ short_title String 凯利来手撕面包蛋糕点心糕点充饥商品信息-商品短标题 -- Product information - short product title └ title String 凯利来千层软手撕面包整箱早餐鲜活蛋糕休闲零食蛋糕点心夜宵充饥商品信息-商品标题 -- Product information - product title └ category_name String 传统西式糕点商品信息-叶子类目名称 -- Product information - leaf category name └ is_prepay Boolean true 商品信息-是否加入消费者保障 -- Product information - participation in consumer protection └ small_images String [] 商品信息-商品小图列表 -- Product information - list of small product images └ seller_id Number 3461918757 店铺信息-卖家ID -- Store information - seller ID └ sub_title String 新老包装交替发货，现做现发。商品信息-商品子标题 -- Product information - product subtitle └ provcity String 河南濮阳商品信息-宝贝所在地 -- Product information - product location └ tk_total_sales String 100000 商品信息-淘客30天推广量 -- Product information - Taoke 30-day promotion volume └ ratesum Number 16 店铺信息-卖家等级 -- Store information - seller level └ annual_vol String 80万+ 年销量 -- Annual sales volume └ shop_title String 凯利来旗舰店店铺信息-店铺名称 -- Store information - store name └ shop_dsr Number 48435 店铺信息-店铺dsr评分 -- Store information - store DSR score └ user_type Number 1 店铺信息-卖家类型，0表示淘宝，1表示天猫，3表示特价版 -- Store information - seller type (0 for Taobao, 1 for Tmall, 3 for Special Price Edition) └ level_one_category_id Number 50002766 商品信息-一级类目ID -- Product information - primary category ID └ category_id Number 50012598 商品信息-叶子类目ID -- Product information - leaf category ID presale_info MaterialItemPresaleInfoDTO 预售信息 -- Pre-sale information └ presale_discount_fee_text String 179 预售商品-预售优惠金额 -- Pre-sale product - pre-sale discount amount └ presale_end_time Number 1747065599000 预售商品-付定金结束时间（毫秒） -- Pre-sale product - deposit payment end time (ms) └ presale_deposit String 1 预售商品-定金（元） -- Pre-sale product - deposit (RMB) └ presale_tail_end_time Number 1747065599000 预售商品-付尾款结束时间（毫秒） -- Pre-sale product - balance payment end time (ms) └ presale_start_time Number 1746532800000 预售商品-付定金开始时间（毫秒） -- Pre-sale product - deposit payment start time (ms) └ presale_tail_start_time Number 1747065599000 预售商品-付尾款开始时间（毫秒） -- Pre-sale product - balance payment start time (ms)

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
OvsTbkMaterialItemInfoGetRequest req = new OvsTbkMaterialItemInfoGetRequest();
req.setSite("TW");
req.setItemIds("O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ");
req.setLanguage("zh_CN");
OvsTbkMaterialItemInfoGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
OvsTbkMaterialItemInfoGetRequest req = new OvsTbkMaterialItemInfoGetRequest();
req.Site = "TW";
req.ItemIds = "O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ";
req.Language = "zh_CN";
OvsTbkMaterialItemInfoGetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new OvsTbkMaterialItemInfoGetRequest;
$req->setSite("TW");
$req->setItemIds("O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ");
$req->setLanguage("zh_CN");
$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.ovs.tbk.material.item.info.get' \
-d 'partner_id=apidoc' \
-d 'sign=532508DEF8556B3155CE8C7C2782EC84' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-10-27+06%3A17%3A48' \
-d 'v=2.0' \
-d 'item_ids=O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ' \
-d 'language=zh_CN' \
-d 'site=TW'

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

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

req.site="TW"
req.item_ids="O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ"
req.language="zh_CN"
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.ovs.tbk.material.item.info.get");
add_param(pRequest,"site","TW");
add_param(pRequest,"item_ids","O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ");
add_param(pRequest,"language","zh_CN");
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.ovs.tbk.material.item.info.get', {
	'site':'TW',
	'item_ids':'O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ',
	'language':'zh_CN'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<ovs_tbk_material_item_info_get_response>
    <items>
        <material_item_summary_info>
            <item_id>O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ</item_id>
            <coupon_info>
                <coupon_start_fee>17</coupon_start_fee>
                <coupon_remain_count>27000</coupon_remain_count>
                <coupon_amount>5</coupon_amount>
                <coupon_activity_id>30660aec6d334a929186b8ca49892bca</coupon_activity_id>
                <coupon_sale_text_info>满17元减5元</coupon_sale_text_info>
                <coupon_effective_start_time>1748361600000</coupon_effective_start_time>
                <coupon_effective_end_time>1749052799000</coupon_effective_end_time>
            </coupon_info>
            <publish_info>
                <income_info>
                    <commission_rate>200</commission_rate>
                    <lock_rate_start_time>1748361600000</lock_rate_start_time>
                    <lock_rate>300</lock_rate>
                    <lock_rate_end_time>1749052799000</lock_rate_end_time>
                    <commission_amount>0.30</commission_amount>
                </income_info>
                <income_rate>2.00</income_rate>
                <commission_type>MKT</commission_type>
            </publish_info>
            <price_promotion_info>
                <reserve_price>69.8</reserve_price>
                <predict_rounding_up_price>9.9</predict_rounding_up_price>
                <promotion_tag_list>
                    <material_item_promotion_tag_d_t_o>
                        <tag_name>满100减10</tag_name>
                    </material_item_promotion_tag_d_t_o>
                </promotion_tag_list>
                <final_promotion_price>59.9</final_promotion_price>
                <predict_rounding_up_price_desc>需凑单，需买2件</predict_rounding_up_price_desc>
                <final_promotion_path_list>
                    <material_item_promotion_path_d_t_o>
                        <promotion_title>商品券</promotion_title>
                        <promotion_start_time>1750435200000</promotion_start_time>
                        <promotion_desc>满15减6</promotion_desc>
                        <promotion_id>4c1fd912051543e1ab095e5925618bf7</promotion_id>
                        <promotion_end_time>1751299199000</promotion_end_time>
                        <promotion_fee>6</promotion_fee>
                    </material_item_promotion_path_d_t_o>
                </final_promotion_path_list>
                <zk_final_price>29.9</zk_final_price>
                <more_promotion_list>
                    <material_item_more_promotion_d_t_o>
                        <promotion_title>秒杀直降</promotion_title>
                        <promotion_start_time>1748966401000</promotion_start_time>
                        <promotion_desc>直降9元</promotion_desc>
                        <promotion_end_time>1753943938000</promotion_end_time>
                        <promotion_id>2191463496637</promotion_id>
                    </material_item_more_promotion_d_t_o>
                </more_promotion_list>
            </price_promotion_info>
            <item_basic_info>
                <white_image>https://img.alicdn.com/bao/uploaded/O1CN01u4x0VE25MYAW4d8ep_!!6000000007512-0-yinhe.jpg</white_image>
                <brand_name>凯利来</brand_name>
                <level_one_category_name>零食/坚果/特产</level_one_category_name>
                <pict_url>https://img.alicdn.com/bao/uploaded/i1/3461918757/O1CN01rvW7VL2EYlLspAtaW_!!0-item_pic.jpg</pict_url>
                <short_title>凯利来手撕面包蛋糕点心糕点充饥</short_title>
                <title>凯利来千层软手撕面包整箱早餐鲜活蛋糕休闲零食蛋糕点心夜宵充饥</title>
                <category_name>传统西式糕点</category_name>
                <is_prepay>true</is_prepay>
                <seller_id>3461918757</seller_id>
                <sub_title>新老包装交替发货，现做现发。</sub_title>
                <provcity>河南 濮阳</provcity>
                <tk_total_sales>100000</tk_total_sales>
                <ratesum>16</ratesum>
                <annual_vol>80万+</annual_vol>
                <shop_title>凯利来旗舰店</shop_title>
                <shop_dsr>48435</shop_dsr>
                <user_type>1</user_type>
                <level_one_category_id>50002766</level_one_category_id>
                <category_id>50012598</category_id>
            </item_basic_info>
            <presale_info>
                <presale_discount_fee_text>179</presale_discount_fee_text>
                <presale_end_time>1747065599000</presale_end_time>
                <presale_deposit>1</presale_deposit>
                <presale_tail_end_time>1747065599000</presale_tail_end_time>
                <presale_start_time>1746532800000</presale_start_time>
                <presale_tail_start_time>1747065599000</presale_tail_start_time>
            </presale_info>
        </material_item_summary_info>
    </items>
</ovs_tbk_material_item_info_get_response>

{
    "ovs_tbk_material_item_info_get_response":{
        "items":{
            "material_item_summary_info":[
                {
                    "item_id":"O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ",
                    "coupon_info":{
                        "coupon_start_fee":"17",
                        "coupon_remain_count":27000,
                        "coupon_amount":"5",
                        "coupon_activity_id":"30660aec6d334a929186b8ca49892bca",
                        "coupon_sale_text_info":"满17元减5元",
                        "coupon_effective_start_time":1748361600000,
                        "coupon_effective_end_time":1749052799000
                    },
                    "publish_info":{
                        "income_info":{
                            "commission_rate":"200",
                            "lock_rate_start_time":1748361600000,
                            "lock_rate":"300",
                            "lock_rate_end_time":1749052799000,
                            "commission_amount":"0.30"
                        },
                        "income_rate":"2.00",
                        "commission_type":"MKT"
                    },
                    "price_promotion_info":{
                        "reserve_price":"69.8",
                        "predict_rounding_up_price":"9.9",
                        "promotion_tag_list":{
                            "material_item_promotion_tag_d_t_o":[
                                {
                                    "tag_name":"满100减10"
                                }
                            ]
                        },
                        "final_promotion_price":"59.9",
                        "predict_rounding_up_price_desc":"需凑单，需买2件",
                        "final_promotion_path_list":{
                            "material_item_promotion_path_d_t_o":[
                                {
                                    "promotion_title":"商品券",
                                    "promotion_start_time":1750435200000,
                                    "promotion_desc":"满15减6",
                                    "promotion_id":"4c1fd912051543e1ab095e5925618bf7",
                                    "promotion_end_time":1751299199000,
                                    "promotion_fee":"6"
                                }
                            ]
                        },
                        "zk_final_price":"29.9",
                        "more_promotion_list":{
                            "material_item_more_promotion_d_t_o":[
                                {
                                    "promotion_title":"秒杀直降",
                                    "promotion_start_time":"1748966401000",
                                    "promotion_desc":"直降9元",
                                    "promotion_end_time":"1753943938000",
                                    "promotion_id":"2191463496637"
                                }
                            ]
                        }
                    },
                    "item_basic_info":{
                        "white_image":"https:\/\/img.alicdn.com\/bao\/uploaded\/O1CN01u4x0VE25MYAW4d8ep_!!6000000007512-0-yinhe.jpg",
                        "brand_name":"凯利来",
                        "level_one_category_name":"零食\/坚果\/特产",
                        "pict_url":"https:\/\/img.alicdn.com\/bao\/uploaded\/i1\/3461918757\/O1CN01rvW7VL2EYlLspAtaW_!!0-item_pic.jpg",
                        "short_title":"凯利来手撕面包蛋糕点心糕点充饥",
                        "title":"凯利来千层软手撕面包整箱早餐鲜活蛋糕休闲零食蛋糕点心夜宵充饥",
                        "category_name":"传统西式糕点",
                        "is_prepay":true,
                        "seller_id":3461918757,
                        "sub_title":"新老包装交替发货，现做现发。",
                        "provcity":"河南 濮阳",
                        "tk_total_sales":"100000",
                        "ratesum":16,
                        "annual_vol":"80万+",
                        "shop_title":"凯利来旗舰店",
                        "shop_dsr":48435,
                        "user_type":1,
                        "level_one_category_id":50002766,
                        "category_id":50012598
                    },
                    "presale_info":{
                        "presale_discount_fee_text":"179",
                        "presale_end_time":1747065599000,
                        "presale_deposit":"1",
                        "presale_tail_end_time":1747065599000,
                        "presale_start_time":1746532800000,
                        "presale_tail_start_time":1747065599000
                    }
                }
            ]
        }
    }
}

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"
	}
}

错误码	错误描述	解决方案

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

开放平台

海外-淘宝客API

taobao.ovs.tbk.material.item.info.get (淘宝客-推广者-商品详情查询正式版)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ