淘宝开放平台 - 文档中心

请求地址：

环境	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	默认值：GLOBAL	站点标识：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.
unid	String	可选	123		渠道自定义参数 -- Channel Custom Parameter
urls	String	可选	https://item.taobao.com/item.htm?id=898150820782		商品链接串，用,分割，最大40个 -- Product link string, separated by commas, maximum 40 entries.
item_ids	String	可选	O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ		商品ID串，用,分割，最大40个 -- Product ID string, separated by commas, maximum 40 entries.
adzone_id	Number	必须	123		推广位ID，mm_xxx_xxx_12345678三段式的最后一段数字 -- Promotion position ID, the last segment of numbers in the three-part format mm_xxx_xxx_12345678.
language	String	必须	zh_CN	默认值：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) coupon_localized_amount MaterialItemLocalizedPriceDTO 优惠券信息-券面额，本地化价格 -- Coupon information — coupon denomination and localized price. └ formatted_price String HK$0.97 价格本地化字符串 — Localized price string └ formatted_price_number String 0.97 价格本地化字符串（数字部分） — Localized price string (numeric part) └ currency_symbol String HK$ 币种展示符号 — Currency display symbol └ currency_code String HKD 币种编码 -- Currency code coupon_localized_start_fee MaterialItemLocalizedPriceDTO 优惠券信息-满减的满额，本地化价格 -- Coupon information — threshold amount for full-reduction coupons, localized price └ formatted_price String HK$0.97 价格本地化字符串 — Localized price string └ formatted_price_number String 0.97 价格本地化字符串（数字部分） — Localized price string (numeric part) └ currency_symbol String HK$ 币种展示符号 — Currency display symbol └ currency_code String HKD 币种编码 -- Currency code publish_info MaterialItemPublishInfoDTO 淘客推广信息 – Taobao Partner promotion information └ click_url String https://intl.taobao.com/dp?h5Url=https%3A%2F%2Fpre-wormhole.tmall.com%2Fwow%2Fz%2Foversea%2Fgam%2Fpre-ovs-affiliate-pdp%3Fwh_showError%3Dtrue%26itemId%3D527575926534%26pid%3Dmm_26632943_457000242_108856900407%26relationId%3D2852359894%26language%3Dzh_CN%26site%3DOTHER%26ovs_scene%3Dtop_api_link_convert%26is_ovs_cpa%3D1%26ovs_cpa_scene%3Daffiliate_joint_attribution 默认跳转链接 – Default redirect link └ income_rate String 15.01 商品信息-收入比率(%)；商品佣金比率+补贴比率 – Product information - Revenue ratio (%); Commission ratio + Subsidy ratio └ 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 └ coupon_share_url String https://intl.taobao.com/dp?h5Url=https%3A%2F%2Fpre-wormhole.tmall.com%2Fwow%2Fz%2Foversea%2Fgam%2Fpre-ovs-affiliate-pdp%3Fwh_showError%3Dtrue%26itemId%3D527575926534%26pid%3Dmm_26632943_457000242_108856900407%26relationId%3D2852359894%26language%3Dzh_CN%26site%3DOTHER%26ovs_scene%3Dtop_api_link_convert%26is_ovs_cpa%3D1%26ovs_cpa_scene%3Daffiliate_joint_attribution 券二合一页链接 – Combined coupon page link price_promotion_info MaterialItemPromotionInfoDTO 价格促销信息 – Price promotion information └ reserve_price String 69.8 商品信息-一口价，通常显示为划线价 – Product information - Fixed price, usually displayed as a strike-through price └ final_promotion_price String 9.9 促销信息-预估到手价(元)。若属于预售商品，付定金时间内，预估到手价价=定金+尾款的预估到手价 – Promotion information - Estimated final price (CNY). If it's a pre-sale item, during the deposit payment period, estimated final price = deposit + estimated final price of the balance └ zk_final_price String 17.9 促销信息-销售价格，无促销时等于一口价，有促销时为促销价。若属于预售商品，付定金时间内，在线售卖价=预售价 – Promotion information - Selling price, equals fixed price when no promotion is active, and equals promotional price when a promotion is active. If it's a pre-sale item, during the deposit payment period, online selling price = pre-sale price final_promotion_localized_price MaterialItemLocalizedPriceDTO 促销信息-预估到手价，本地化价格 -- Promotion information — estimated final price (localized price) └ formatted_price String HK$0.97 价格本地化字符串 — Localized price string └ formatted_price_number String 0.97 价格本地化字符串（数字部分） — Localized price string (numeric part) └ currency_symbol String HK$ 币种展示符号 — Currency display symbol └ currency_code String HKD 币种编码 -- Currency code reserve_localized_price MaterialItemLocalizedPriceDTO 商品信息-一口价，通常显示为划线价，本地化价格 -- Product information — list price (usually displayed as a strikethrough), localized price └ formatted_price String HK$0.97 价格本地化字符串 — Localized price string └ formatted_price_number String 0.97 价格本地化字符串（数字部分） — Localized price string (numeric part) └ currency_symbol String HK$ 币种展示符号 — Currency display symbol └ currency_code String HKD 币种编码 -- Currency code zk_final_localized_price MaterialItemLocalizedPriceDTO 促销信息-销售价格，无促销时等于一口价，有促销时为促销价，本地化价格 -- Promotion information — selling price (equals the list price when there's no promotion; when a promotion applies, it's the promotional price), localized price └ formatted_price String HK$0.97 价格本地化字符串 — Localized price string └ formatted_price_number String 0.97 价格本地化字符串（数字部分） — Localized price string (numeric part) └ currency_symbol String HK$ 币种展示符号 — Currency display symbol └ currency_code String HKD 币种编码 -- Currency code

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
OvsTbkMaterialItemLinkConvertRequest req = new OvsTbkMaterialItemLinkConvertRequest();
req.setSite("TW");
req.setUnid("123");
req.setUrls("https://item.taobao.com/item.htm?id=898150820782");
req.setItemIds("O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ");
req.setAdzoneId(123L);
req.setLanguage("zh_CN");
OvsTbkMaterialItemLinkConvertResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
OvsTbkMaterialItemLinkConvertRequest req = new OvsTbkMaterialItemLinkConvertRequest();
req.Site = "TW";
req.Unid = "123";
req.Urls = "https://item.taobao.com/item.htm?id=898150820782";
req.ItemIds = "O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ";
req.AdzoneId = 123L;
req.Language = "zh_CN";
OvsTbkMaterialItemLinkConvertResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new OvsTbkMaterialItemLinkConvertRequest;
$req->setSite("TW");
$req->setUnid("123");
$req->setUrls("https://item.taobao.com/item.htm?id=898150820782");
$req->setItemIds("O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ");
$req->setAdzoneId("123");
$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.link.convert' \
-d 'partner_id=apidoc' \
-d 'sign=75E3A279439F7E095664BB73F74576E8' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-12-15+03%3A29%3A57' \
-d 'v=2.0' \
-d 'adzone_id=123' \
-d 'item_ids=O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ' \
-d 'language=zh_CN' \
-d 'site=TW' \
-d 'unid=123' \
-d 'urls=https%3A%2F%2Fitem.taobao.com%2Fitem.htm%3Fid%3D898150820782'

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

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

req.site="TW"
req.unid="123"
req.urls="https://item.taobao.com/item.htm?id=898150820782"
req.item_ids="O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ"
req.adzone_id=123
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.link.convert");
add_param(pRequest,"site","TW");
add_param(pRequest,"unid","123");
add_param(pRequest,"urls","https://item.taobao.com/item.htm?id=898150820782");
add_param(pRequest,"item_ids","O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ");
add_param(pRequest,"adzone_id","123");
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.link.convert', {
	'site':'TW',
	'unid':'123',
	'urls':'https://item.taobao.com/item.htm?id=898150820782',
	'item_ids':'O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ',
	'adzone_id':'123',
	'language':'zh_CN'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<ovs_tbk_material_item_link_convert_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_localized_amount>
                    <formatted_price>HK$0.97</formatted_price>
                    <formatted_price_number>0.97</formatted_price_number>
                    <currency_symbol>HK$</currency_symbol>
                    <currency_code>HKD</currency_code>
                </coupon_localized_amount>
                <coupon_localized_start_fee>
                    <formatted_price>HK$0.97</formatted_price>
                    <formatted_price_number>0.97</formatted_price_number>
                    <currency_symbol>HK$</currency_symbol>
                    <currency_code>HKD</currency_code>
                </coupon_localized_start_fee>
            </coupon_info>
            <publish_info>
                <click_url>https://intl.taobao.com/dp?h5Url=https%3A%2F%2Fpre-wormhole.tmall.com%2Fwow%2Fz%2Foversea%2Fgam%2Fpre-ovs-affiliate-pdp%3Fwh_showError%3Dtrue%26itemId%3D527575926534%26pid%3Dmm_26632943_457000242_108856900407%26relationId%3D2852359894%26language%3Dzh_CN%26site%3DOTHER%26ovs_scene%3Dtop_api_link_convert%26is_ovs_cpa%3D1%26ovs_cpa_scene%3Daffiliate_joint_attribution</click_url>
                <income_rate>15.01</income_rate>
                <commission_type>MKT</commission_type>
                <coupon_share_url>https://intl.taobao.com/dp?h5Url=https%3A%2F%2Fpre-wormhole.tmall.com%2Fwow%2Fz%2Foversea%2Fgam%2Fpre-ovs-affiliate-pdp%3Fwh_showError%3Dtrue%26itemId%3D527575926534%26pid%3Dmm_26632943_457000242_108856900407%26relationId%3D2852359894%26language%3Dzh_CN%26site%3DOTHER%26ovs_scene%3Dtop_api_link_convert%26is_ovs_cpa%3D1%26ovs_cpa_scene%3Daffiliate_joint_attribution</coupon_share_url>
            </publish_info>
            <price_promotion_info>
                <reserve_price>69.8</reserve_price>
                <final_promotion_price>9.9</final_promotion_price>
                <zk_final_price>17.9</zk_final_price>
                <final_promotion_localized_price>
                    <formatted_price>HK$0.97</formatted_price>
                    <formatted_price_number>0.97</formatted_price_number>
                    <currency_symbol>HK$</currency_symbol>
                    <currency_code>HKD</currency_code>
                </final_promotion_localized_price>
                <reserve_localized_price>
                    <formatted_price>HK$0.97</formatted_price>
                    <formatted_price_number>0.97</formatted_price_number>
                    <currency_symbol>HK$</currency_symbol>
                    <currency_code>HKD</currency_code>
                </reserve_localized_price>
                <zk_final_localized_price>
                    <formatted_price>HK$0.97</formatted_price>
                    <formatted_price_number>0.97</formatted_price_number>
                    <currency_symbol>HK$</currency_symbol>
                    <currency_code>HKD</currency_code>
                </zk_final_localized_price>
            </price_promotion_info>
        </material_item_summary_info>
    </items>
</ovs_tbk_material_item_link_convert_response>

{
    "ovs_tbk_material_item_link_convert_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,
                        "coupon_localized_amount":{
                            "formatted_price":"HK$0.97",
                            "formatted_price_number":"0.97",
                            "currency_symbol":"HK$",
                            "currency_code":"HKD"
                        },
                        "coupon_localized_start_fee":{
                            "formatted_price":"HK$0.97",
                            "formatted_price_number":"0.97",
                            "currency_symbol":"HK$",
                            "currency_code":"HKD"
                        }
                    },
                    "publish_info":{
                        "click_url":"https:\/\/intl.taobao.com\/dp?h5Url=https%3A%2F%2Fpre-wormhole.tmall.com%2Fwow%2Fz%2Foversea%2Fgam%2Fpre-ovs-affiliate-pdp%3Fwh_showError%3Dtrue%26itemId%3D527575926534%26pid%3Dmm_26632943_457000242_108856900407%26relationId%3D2852359894%26language%3Dzh_CN%26site%3DOTHER%26ovs_scene%3Dtop_api_link_convert%26is_ovs_cpa%3D1%26ovs_cpa_scene%3Daffiliate_joint_attribution",
                        "income_rate":"15.01",
                        "commission_type":"MKT",
                        "coupon_share_url":"https:\/\/intl.taobao.com\/dp?h5Url=https%3A%2F%2Fpre-wormhole.tmall.com%2Fwow%2Fz%2Foversea%2Fgam%2Fpre-ovs-affiliate-pdp%3Fwh_showError%3Dtrue%26itemId%3D527575926534%26pid%3Dmm_26632943_457000242_108856900407%26relationId%3D2852359894%26language%3Dzh_CN%26site%3DOTHER%26ovs_scene%3Dtop_api_link_convert%26is_ovs_cpa%3D1%26ovs_cpa_scene%3Daffiliate_joint_attribution"
                    },
                    "price_promotion_info":{
                        "reserve_price":"69.8",
                        "final_promotion_price":"9.9",
                        "zk_final_price":"17.9",
                        "final_promotion_localized_price":{
                            "formatted_price":"HK$0.97",
                            "formatted_price_number":"0.97",
                            "currency_symbol":"HK$",
                            "currency_code":"HKD"
                        },
                        "reserve_localized_price":{
                            "formatted_price":"HK$0.97",
                            "formatted_price_number":"0.97",
                            "currency_symbol":"HK$",
                            "currency_code":"HKD"
                        },
                        "zk_final_localized_price":{
                            "formatted_price":"HK$0.97",
                            "formatted_price_number":"0.97",
                            "currency_symbol":"HK$",
                            "currency_code":"HKD"
                        }
                    }
                }
            ]
        }
    }
}

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

错误码	错误描述	解决方案
10101	TOP API 返回商品物料结果为空	请求参数错误

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

开放平台

海外-淘宝客API

taobao.ovs.tbk.material.item.link.convert (淘宝客-推广者-商品链接转换正式版)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ