淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
product_id	Number	可选	1307422965		product ID

名称	类型	示例值	描述
result	GlobalAeopFindProductResultDto	result	result
└ add_unit Number 11 Required when is_pack_sell equals to true. Value range for pieces to be added: 1-1000. Please refer to the field is_pack_sell for details. └ add_weight String 11.11 Required when is_pack_sell equals to true. It means weight to be correspondingly added. Range value: 0.001-500.000, reserving three decimal places and applying scale; Unit: kilogram(s). Please refer to the field is_pack_sell for details. aeop_a_e_multimedia GlobalAeopAeMultimedia aeopAEMultimedia":{"aeopAEVideos":[{"mediaId":30994083,"posterUrl":"http://img02.taobaocdn.com/bao/uploaded/TB16e9MJVXXXXacXVXXXXXXXXXX.jpg","mediaStatus":"approved","mediaType":"video","aliMemberId":225671041}]} Multimedia information aeop_a_e_videos GlobalAeopAeVideo [] [ { "aliMemberId": 117284237, "mediaId": 35683461, "mediaType": "video", "mediaStatus": "approved", "posterUrl": "http://img02.taobaocdn.com/bao/uploaded/TB1a7HKLVXXXXX5XVXXXXXXXXXX.jpg" }] video information └ ali_member_id Number 1006680305 Seller admin ID └ media_id Number 12345678 Video ID └ media_status String approved The status of the video └ media_type String video The type of video └ poster_url String http://img01.taobaocdn.com/bao/uploaded/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg URL of the video cover image aeop_ae_product_propertys GlobalAeopAeProductProperty [] Product properties └ attr_name String size Customized attribute name └ attr_name_id Number 200000043 Attribute Name ID └ attr_value String 2 - 5 kg Customized attribute value └ attr_value_id Number 493 Attribute Value ID └ attr_value_unit String 0 unit of customized attribute value aeop_ae_product_s_k_us GlobalAeopAeProductSku [] List for multiple skus of the product, expressed in json format. aeop_s_k_u_property_list GlobalAeopSkuProperty [] "aeopSKUProperty":[{"skuPropertyId":"14","propertyValueId":"771"},{"skuPropertyId":"25","propertyValueId":"775"}] List of SKU attributes └ property_value_definition_name String pink Customized attribute value name └ property_value_id Number 366 SKU attribute value id └ sku_image String http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg Self-defined image url for this sku. └ sku_property_id Number 14 SKU attribute name id └ barcode String 0 all of warehouse goods will return barcode └ currency_code String USD The Currency code. "USD" will be used as the default value if this information is not provided; Currency code is mandatory for Russian sellers(RUB) and Spanish sellers(EUR). └ id String "200000182:193;200007763:201336100" SKU ID. Can uniquely represent a SKU within a product range. └ ipm_sku_stock Number 1234 Ranges from 1 to 999999 for one sku. The total stock of the entire product within multiple skus should also be in the range of 1 to 999999. └ sku_code String cfas00978 Sku merchant code from the seller's system. Format: alphanumeric, length 20, does not contain spaces greater than and less than sign. If you only fill in the product price and product code, you need to create a complete SKU record submission, otherwise the product code can not be saved. The system will consider that only the retail price is submitted, but no SKU, resulting in product editing is not saved. └ sku_price String 200.07 Sku price. Value range: 0.01-100000; Such as: 200.07 means 200 US dollars 7 cents(if other currency_code is used, referring to the corresponding price in that currency, e.g., 200.07 Euros). └ sku_stock Boolean true True means stock available for the sku, false means out of stock. The stock of at least one should be available. └ sku_discount_price String 10.01 SKU discount price, also called sale price, value range: 0.01 - 100000. └ ean_code String 12345678 EAN, or EAN13, stands for International Article Number (originally European Article Number). It is an extension of the UPC codes and you'll find them as barcodes on most everyday products. Sometimes the barcode is also called GTIN or GTIN13 (Global Trade Identifier) └ base_unit Number 2 Required when is_pack_sell equals to true. It means no additional freight will be charged when the number of pieces to be purchased is under the base unit. Value range: 1-1000. └ bulk_discount Number 90 Bulk discount for wholesale. It must be multiplied by 100 and selected and saved as integer. Value range: 1-99. Note: It is discount, other than discount rate. For example, if the discount is 68, it should be selected and saved as 32. bulk_order and bulk_discount must have value or have no value simultaneously. └ bulk_order Number 10 Minimum bulk for wholesale. Value range: 2-100000. bulk_order and bulk_discount must have value or have no value simultaneously. └ category_id Number 123456 Product category ID. It must be leaf category to be obtained from the category interface. └ currency_code String USD the Currency code. "USD" will be used as the default value if this information is not provided; Currency code is mandatory for Russian sellers and Spanish sellers. For Russian sellers, RUB should be filled in while EUR for Spanish sellers. └ delivery_time Number 60 Stocking period. Value range: 1-60; Unit: day(s). Referring to the preparation time before the order could be dispatched. └ detail String <div></div> Deprecated, please use multi_language_description_list └ freight_template_id Number 12345 shipping template id └ gmt_create Date 2018-12-03 15:17:33 created time └ gmt_modified Date 2018-12-18 17:11:08 modified time └ gross_weight String 40.12 Product gross weight. Range value: 0.001-500.000, reserving three decimal places and applying scale; Unit: kilogram(s). └ group_id Number 10023 Group ID that the product belongs to. └ group_ids Number [] [1002141,10024524] All the groups that the product belongs to. └ image_u_r_ls String http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg image urls for the product └ is_pack_sell Boolean true Whether customized weighting is enabled or not. True means customized weighting enabled. When is_pack_sell equals to true, add_unit, add_weight and base_unit must be filled in. For example, base_unit equals to 5, add_unit equals to 2 and add_weight equals to 1.2. It means that Basic shipping cost will cover the first 5 pieces, freight calculating of which will base on a single product. For every additional 2 pieces, the shipping cost will be added to the total shipping cost for 1.2kg └ lot_num Number 1 Number of piece(s) in each pack. In case of packing sale,lotNum>1, and in case of unpacking sale, lotNum=1. └ mobile_detail String balalaba mobile detail └ owner_member_id String aliqatest01 Out of date, please ignore └ owner_member_seq Number 1006680305 Out of date, please ignore. └ package_height Number 30 package height └ package_length Number 10 package length └ package_width Number 20 package width └ product_id Number 1234 product ID └ product_price String 10.23 Price for product └ product_status_type String onSelling product status type └ product_unit Number 100000015 Product unit └ promise_template_id Number 100 Service template ID which the product is associated with └ reduce_strategy String place_order_withhold或payment_success_deduct Stock reduction strategy. It is divided into 2 types: stock reduction after placing order (place_order_withhold) or stock reduction after payment (payment_success_deduct). └ sizechart_id Number 123 Size chart template ID that the product is associated with. └ subject String English description Deprecated, please use multi_language_subject_list └ ws_offline_date Date 2018-12-19 11:24:27 The offline date of the product └ package_type Boolean true Packing sale: true; Unpacking sale: false. multi_language_subject_list GlobalSubject [] Please refer to the elements in the list multi language subject list └ locale String es_ES locale of the subject └ subject String Versión Global Xiaomi Redmi Note 5 subject multi_language_description_list GlobalDescription [] Please refer to the elements in the list multo language description list └ locale String es_ES locale of the descripiton └ mobile_detail String {"version":"2.0.0","moduleList":[{"type":"html","html":{"content":"Versión Global Xiaomi Redmi Note 5"}}]} mobile detail └ web_detail String {"version":"2.0.0","moduleList":[{"type":"html","html":{"content":"Versión Global Xiaomi Redmi Note 5"}}]} web detail multi_country_price_configuration MultiCountryPriceConfigurationDto multi country price configuration └ price_type String absolute price type country_price_list SingleCountryPriceDto [] Price list for different countries └ ship_to_country String ES ship to country sku_price_by_country_list SingleSkuPriceByCountryDto [] Sku price list under the same ship_to_country └ sku_code String abc123 sku code └ price String 16 price └ discount_price String 12.99 discount price

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressSolutionProductInfoGetRequest req = new AliexpressSolutionProductInfoGetRequest();
req.setProductId(1307422965L);
AliexpressSolutionProductInfoGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AliexpressSolutionProductInfoGetRequest req = new AliexpressSolutionProductInfoGetRequest();
req.ProductId = 1307422965L;
AliexpressSolutionProductInfoGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AliexpressSolutionProductInfoGetRequest;
$req->setProductId("1307422965");
$resp = $c->execute($req, $sessionKey);

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=aliexpress.solution.product.info.get' \
-d 'partner_id=apidoc' \
-d 'session=40e52d6f-9b10-48fb-84ee-81f8bf93a63b' \
-d 'sign=50E53D5C008A953C466CD2142B4AB1FA' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-10-31+11%3A00%3A10' \
-d 'v=2.0' \
-d 'product_id=1307422965'

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

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

req.product_id=1307422965
try:
	resp= req.getResponse(sessionkey)
	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,"aliexpress.solution.product.info.get");
add_param(pRequest,"product_id","1307422965");
pResponse = top_execute(pClient,pRequest,sessionKey);
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('aliexpress.solution.product.info.get', {
	'product_id':'1307422965'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<aliexpress_solution_product_info_get_response>
    <result>
        <add_unit>11</add_unit>
        <add_weight>11.11</add_weight>
        <aeop_a_e_multimedia>
            <aeop_a_e_videos>
                <global_aeop_ae_video>
                    <ali_member_id>1006680305</ali_member_id>
                    <media_id>12345678</media_id>
                    <media_status>approved</media_status>
                    <media_type>video</media_type>
                    <poster_url>http://img01.taobaocdn.com/bao/uploaded/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg</poster_url>
                </global_aeop_ae_video>
            </aeop_a_e_videos>
        </aeop_a_e_multimedia>
        <aeop_ae_product_propertys>
            <global_aeop_ae_product_property>
                <attr_name>size</attr_name>
                <attr_name_id>200000043</attr_name_id>
                <attr_value>2 - 5 kg</attr_value>
                <attr_value_id>493</attr_value_id>
                <attr_value_unit>0</attr_value_unit>
            </global_aeop_ae_product_property>
        </aeop_ae_product_propertys>
        <aeop_ae_product_s_k_us>
            <global_aeop_ae_product_sku>
                <aeop_s_k_u_property_list>
                    <global_aeop_sku_property>
                        <property_value_definition_name>pink</property_value_definition_name>
                        <property_value_id>366</property_value_id>
                        <sku_image>http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg</sku_image>
                        <sku_property_id>14</sku_property_id>
                    </global_aeop_sku_property>
                </aeop_s_k_u_property_list>
                <barcode>0</barcode>
                <currency_code>USD</currency_code>
                <id>&quot;200000182:193;200007763:201336100&quot;</id>
                <ipm_sku_stock>1234</ipm_sku_stock>
                <sku_code>cfas00978</sku_code>
                <sku_price>200.07</sku_price>
                <sku_stock>true</sku_stock>
                <sku_discount_price>10.01</sku_discount_price>
                <ean_code>12345678</ean_code>
            </global_aeop_ae_product_sku>
        </aeop_ae_product_s_k_us>
        <base_unit>2</base_unit>
        <bulk_discount>90</bulk_discount>
        <bulk_order>10</bulk_order>
        <category_id>123456</category_id>
        <currency_code>USD</currency_code>
        <delivery_time>60</delivery_time>
        <detail>&lt;div&gt;&lt;/div&gt;</detail>
        <freight_template_id>12345</freight_template_id>
        <gmt_create>2018-12-03 15:17:33</gmt_create>
        <gmt_modified>2018-12-18 17:11:08</gmt_modified>
        <gross_weight>40.12</gross_weight>
        <group_id>10023</group_id>
        <group_ids>
            <number>[1002141</number>
            <number>10024524]</number>
        </group_ids>
        <image_u_r_ls>http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg</image_u_r_ls>
        <is_pack_sell>true</is_pack_sell>
        <lot_num>1</lot_num>
        <mobile_detail>balalaba</mobile_detail>
        <owner_member_id>aliqatest01</owner_member_id>
        <owner_member_seq>1006680305</owner_member_seq>
        <package_height>30</package_height>
        <package_length>10</package_length>
        <package_width>20</package_width>
        <product_id>1234</product_id>
        <product_price>10.23</product_price>
        <product_status_type>onSelling</product_status_type>
        <product_unit>100000015</product_unit>
        <promise_template_id>100</promise_template_id>
        <reduce_strategy>place_order_withhold或payment_success_deduct</reduce_strategy>
        <sizechart_id>123</sizechart_id>
        <subject>English description</subject>
        <ws_offline_date>2018-12-19 11:24:27</ws_offline_date>
        <package_type>true</package_type>
        <multi_language_subject_list>
            <global_subject>
                <locale>es_ES</locale>
                <subject>Versión Global Xiaomi Redmi Note 5</subject>
            </global_subject>
        </multi_language_subject_list>
        <multi_language_description_list>
            <global_description>
                <locale>es_ES</locale>
                <mobile_detail>{&quot;version&quot;:&quot;2.0.0&quot;,&quot;moduleList&quot;:[{&quot;type&quot;:&quot;html&quot;,&quot;html&quot;:{&quot;content&quot;:&quot;Versión Global Xiaomi Redmi Note 5&quot;}}]}</mobile_detail>
                <web_detail>{&quot;version&quot;:&quot;2.0.0&quot;,&quot;moduleList&quot;:[{&quot;type&quot;:&quot;html&quot;,&quot;html&quot;:{&quot;content&quot;:&quot;Versión Global Xiaomi Redmi Note 5&quot;}}]}</web_detail>
            </global_description>
        </multi_language_description_list>
        <multi_country_price_configuration>
            <price_type>absolute</price_type>
            <country_price_list>
                <single_country_price_dto>
                    <ship_to_country>ES</ship_to_country>
                    <sku_price_by_country_list>
                        <single_sku_price_by_country_dto>
                            <sku_code>abc123</sku_code>
                            <price>16</price>
                            <discount_price>12.99</discount_price>
                        </single_sku_price_by_country_dto>
                    </sku_price_by_country_list>
                </single_country_price_dto>
            </country_price_list>
        </multi_country_price_configuration>
    </result>
</aliexpress_solution_product_info_get_response>

{
    "aliexpress_solution_product_info_get_response":{
        "result":{
            "add_unit":11,
            "add_weight":"11.11",
            "aeop_a_e_multimedia":{
                "aeop_a_e_videos":{
                    "global_aeop_ae_video":[
                        {
                            "ali_member_id":1006680305,
                            "media_id":12345678,
                            "media_status":"approved",
                            "media_type":"video",
                            "poster_url":"http:\/\/img01.taobaocdn.com\/bao\/uploaded\/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg"
                        }
                    ]
                }
            },
            "aeop_ae_product_propertys":{
                "global_aeop_ae_product_property":[
                    {
                        "attr_name":"size",
                        "attr_name_id":200000043,
                        "attr_value":"2 - 5 kg",
                        "attr_value_id":493,
                        "attr_value_unit":"0"
                    }
                ]
            },
            "aeop_ae_product_s_k_us":{
                "global_aeop_ae_product_sku":[
                    {
                        "aeop_s_k_u_property_list":{
                            "global_aeop_sku_property":[
                                {
                                    "property_value_definition_name":"pink",
                                    "property_value_id":366,
                                    "sku_image":"http:\/\/ae01.alicdn.com\/kf\/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg",
                                    "sku_property_id":14
                                }
                            ]
                        },
                        "barcode":"0",
                        "currency_code":"USD",
                        "id":"\"200000182:193;200007763:201336100\"",
                        "ipm_sku_stock":1234,
                        "sku_code":"cfas00978",
                        "sku_price":"200.07",
                        "sku_stock":true,
                        "sku_discount_price":"10.01",
                        "ean_code":"12345678"
                    }
                ]
            },
            "base_unit":2,
            "bulk_discount":90,
            "bulk_order":10,
            "category_id":123456,
            "currency_code":"USD",
            "delivery_time":60,
            "detail":"<div><\/div>",
            "freight_template_id":12345,
            "gmt_create":"2018-12-03 15:17:33",
            "gmt_modified":"2018-12-18 17:11:08",
            "gross_weight":"40.12",
            "group_id":10023,
            "group_ids":{
                "number":[
                    [1002141,
                    10024524]
                ]
            },
            "image_u_r_ls":"http:\/\/g01.a.alicdn.com\/kf\/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http:\/\/g02.a.alicdn.com\/kf\/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http:\/\/g02.a.alicdn.com\/kf\/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http:\/\/g03.a.alicdn.com\/kf\/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http:\/\/g02.a.alicdn.com\/kf\/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg",
            "is_pack_sell":true,
            "lot_num":1,
            "mobile_detail":"balalaba",
            "owner_member_id":"aliqatest01",
            "owner_member_seq":1006680305,
            "package_height":30,
            "package_length":10,
            "package_width":20,
            "product_id":1234,
            "product_price":"10.23",
            "product_status_type":"onSelling",
            "product_unit":100000015,
            "promise_template_id":100,
            "reduce_strategy":"place_order_withhold或payment_success_deduct",
            "sizechart_id":123,
            "subject":"English description",
            "ws_offline_date":"2018-12-19 11:24:27",
            "package_type":true,
            "multi_language_subject_list":{
                "global_subject":[
                    {
                        "locale":"es_ES",
                        "subject":"Versión Global Xiaomi Redmi Note 5"
                    }
                ]
            },
            "multi_language_description_list":{
                "global_description":[
                    {
                        "locale":"es_ES",
                        "mobile_detail":"{\"version\":\"2.0.0\",\"moduleList\":[{\"type\":\"html\",\"html\":{\"content\":\"Versión Global Xiaomi Redmi Note 5\"}}]}",
                        "web_detail":"{\"version\":\"2.0.0\",\"moduleList\":[{\"type\":\"html\",\"html\":{\"content\":\"Versión Global Xiaomi Redmi Note 5\"}}]}"
                    }
                ]
            },
            "multi_country_price_configuration":{
                "price_type":"absolute",
                "country_price_list":{
                    "single_country_price_dto":[
                        {
                            "ship_to_country":"ES",
                            "sku_price_by_country_list":{
                                "single_sku_price_by_country_dto":[
                                    {
                                        "sku_code":"abc123",
                                        "price":"16",
                                        "discount_price":"12.99"
                                    }
                                ]
                            }
                        }
                    ]
                }
            }
        }
    }
}

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下载

开放平台

Developing documentation（已废弃）

aliexpress.solution.product.info.get (Get Single Product Info)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ