淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	描述
ship_to_country	String	可选	US	Country
product_id	Number	可选	32982857990	Item ID
target_currency	String	可选	USD	Target currency
target_language	String	可选	EN	Target language

名称	类型	示例值	描述
result	AeItemQueryResultDTO		Product search results
ae_item_base_info_dto AeItemBaseInfoDTO Basic commodity information └ product_id Number 32839190109 Item ID └ category_id Number 123456 ID of the category of the product └ subject String knew odd The title of the product └ currency_code String USD The currency unit of the commodity. U.S. Dollar: USD, Ruble: RUB └ product_status_type String onSelling Product status └ ws_display String expire_offline Reasons for removal of goods └ ws_offline_date Date 0 The date the product was removed from the shelf └ gmt_create Date 0 Commodity creation time └ gmt_modified Date 0 Change the time └ owner_member_seq_long Number 1006680305 Seller's master account ID └ evaluation_count String 100 Evaluation number └ avg_evaluation_rating String 4.7 Average rating stars, 1-5 stars └ detail String <div>This is a product</div> Commodity detailed description └ mobile_detail String {} Mobile detailed description ae_item_sku_info_dtos AeItemSkuInfoDTO [] SKU information └ id String 200000182:193;200007763:201336100 SKU ID └ sku_stock Boolean true SKU inventory, the data format is true if stock is available, false if no stock is available; at least one sku record is available. └ sku_price String 200.07 SKU price. Value range: 0.01-100000; Unit: USD. Such as: 200.07, which means: 200 US dollars 7 points. Need to be in the correct price range. └ sku_code String cfas00978 SKU merchant code. Format: single-byte alphanumeric characters, length 20, excluding spaces greater than and less than signs. If the user only fills in the retail price (productprice) and product code, a complete SKU record needs to be generated and submitted, otherwise the product code cannot be saved. The system will think that only the retail price has been submitted, but there is no SKU, resulting in unsaved product editing. └ ipm_sku_stock Number 1234 The actual saleable inventory attribute of SKU is ipmSkuStock. The reasonable value range of this attribute value is 0~999999. If the product has SKU, please make sure that at least one SKU is in stock, that is, the value of ipmSkuStock is 1~999999. The range of the inventory value of the entire product latitude is 1~999999. If the skuStock attribute is set at the same time, the system will give priority to the ipmSkuStock attribute; if the ipmSkuStock attribute is not set, the system will set the inventory according to the skuStock attribute, true means 999, false means 0. └ currency_code String USD The currency unit of the product. U.S. Dollar: USD, Ruble: RUB ae_sku_property_dtos AeSkuPropertyDTO [] SKU attribute object └ sku_property_id Number 0 Attribute ID └ sku_property_name String color Attribute name └ sku_property_value String blue Attribute value └ property_value_id Number 0 Custom id └ property_value_definition_name String 0 Custom name └ sku_image String 0 SKU pictures └ barcode String 320325455 Commodity barcode └ offer_sale_price String 3.3 SKU discount price └ offer_bulk_sale_price String 3.2 SKU bulk discount price └ sku_bulk_order Number 10 Minimum number of batches └ sku_available_stock Number 10 SKU inventory ae_multimedia_info_dto AeMultimediaInfoDTO Multimedia information ae_video_dtos AeVideoDTO [] Video information └ ali_member_id Number 1006680305 Seller's master account ID └ media_id Number 12345678 Video ID └ media_status String approved Video status └ media_type String video Type of video └ poster_url String http://img01.taobaocdn.com/bao/uploaded/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg The URL of the video cover image └ image_urls 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 List of main images of the product package_info_dto PackageInfoDTO Package information └ package_length Number 10 The length of the product └ package_height Number 2 Product height └ package_width Number 12 Product width └ gross_weight String 40.12 The gross weight of the product └ base_unit Number 2 Number of basic products for custom weighing └ package_type Boolean true Type of packaging └ product_unit Number 100000015 Unit of commodity logistics_info_dto LogisticsInfoDTO Logistics information └ delivery_time Number 7 Goods lead time └ ship_to_country String US Country ae_item_properties AeItemProperty [] Attribute information └ attr_name_id Number 2981 Attribute ID └ attr_name String 型号 Attribute name └ attr_value_id Number 100234 Attribute ID └ attr_value String ABCD Attribute value └ attr_value_start String 1 Interval attribute start value └ attr_value_end String 10 End value of interval attribute └ attr_value_unit String piece Attribute unit ae_store_info AeStoreInfo Store Information └ store_id Number 12345 Store ID └ store_name String Clothes Store Shop name └ item_as_described_rating String 4.8 Product description, 1-5 stars └ communication_rating String 4.8 Seller service, 1-5 stars └ shipping_speed_rating String 4.7 Logistics, 1-5 stars product_id_converter_result ProductIdConverterResultDTO product id converter result └ main_product_id Number 32982857990 main productId └ sub_product_id String {"US":2251832796543238} sub productId
rsp_msg	String	System Error	Error message
rsp_code	String	404	Error code

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressDsProductGetRequest req = new AliexpressDsProductGetRequest();
req.setShipToCountry("US");
req.setProductId(32982857990L);
req.setTargetCurrency("USD");
req.setTargetLanguage("EN");
AliexpressDsProductGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AliexpressDsProductGetRequest req = new AliexpressDsProductGetRequest();
req.ShipToCountry = "US";
req.ProductId = 32982857990L;
req.TargetCurrency = "USD";
req.TargetLanguage = "EN";
AliexpressDsProductGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AliexpressDsProductGetRequest;
$req->setShipToCountry("US");
$req->setProductId("32982857990");
$req->setTargetCurrency("USD");
$req->setTargetLanguage("EN");
$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.ds.product.get' \
-d 'partner_id=apidoc' \
-d 'session=b321dd16-300c-4a0d-b2df-830dceb3b9dc' \
-d 'sign=CD83C321E792563D6936E76E6EB1B037' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-03-10+04%3A08%3A38' \
-d 'v=2.0' \
-d 'product_id=32982857990' \
-d 'ship_to_country=US' \
-d 'target_currency=USD' \
-d 'target_language=EN'

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

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

req.ship_to_country="US"
req.product_id=32982857990
req.target_currency="USD"
req.target_language="EN"
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.ds.product.get");
add_param(pRequest,"ship_to_country","US");
add_param(pRequest,"product_id","32982857990");
add_param(pRequest,"target_currency","USD");
add_param(pRequest,"target_language","EN");
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.ds.product.get', {
	'ship_to_country':'US',
	'product_id':'32982857990',
	'target_currency':'USD',
	'target_language':'EN'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<aliexpress_ds_product_get_response>
    <result>
        <ae_item_base_info_dto>
            <product_id>32839190109</product_id>
            <category_id>123456</category_id>
            <subject>knew odd</subject>
            <currency_code>USD</currency_code>
            <product_status_type>onSelling</product_status_type>
            <ws_display>expire_offline</ws_display>
            <ws_offline_date>0</ws_offline_date>
            <gmt_create>0</gmt_create>
            <gmt_modified>0</gmt_modified>
            <owner_member_seq_long>1006680305</owner_member_seq_long>
            <evaluation_count>100</evaluation_count>
            <avg_evaluation_rating>4.7</avg_evaluation_rating>
            <detail>&lt;div&gt;This is a product&lt;/div&gt;</detail>
            <mobile_detail>{}</mobile_detail>
        </ae_item_base_info_dto>
        <ae_item_sku_info_dtos>
            <ae_item_sku_info_d_t_o>
                <id>200000182:193;200007763:201336100</id>
                <sku_stock>true</sku_stock>
                <sku_price>200.07</sku_price>
                <sku_code>cfas00978</sku_code>
                <ipm_sku_stock>1234</ipm_sku_stock>
                <currency_code>USD</currency_code>
                <ae_sku_property_dtos>
                    <ae_sku_property_d_t_o>
                        <sku_property_id>0</sku_property_id>
                        <sku_property_name>color</sku_property_name>
                        <sku_property_value>blue</sku_property_value>
                        <property_value_id>0</property_value_id>
                        <property_value_definition_name>0</property_value_definition_name>
                        <sku_image>0</sku_image>
                    </ae_sku_property_d_t_o>
                </ae_sku_property_dtos>
                <barcode>320325455</barcode>
                <offer_sale_price>3.3</offer_sale_price>
                <offer_bulk_sale_price>3.2</offer_bulk_sale_price>
                <sku_bulk_order>10</sku_bulk_order>
                <sku_available_stock>10</sku_available_stock>
            </ae_item_sku_info_d_t_o>
        </ae_item_sku_info_dtos>
        <ae_multimedia_info_dto>
            <ae_video_dtos>
                <ae_video_d_t_o>
                    <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>
                </ae_video_d_t_o>
            </ae_video_dtos>
            <image_urls>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>
        </ae_multimedia_info_dto>
        <package_info_dto>
            <package_length>10</package_length>
            <package_height>2</package_height>
            <package_width>12</package_width>
            <gross_weight>40.12</gross_weight>
            <base_unit>2</base_unit>
            <package_type>true</package_type>
            <product_unit>100000015</product_unit>
        </package_info_dto>
        <logistics_info_dto>
            <delivery_time>7</delivery_time>
            <ship_to_country>US</ship_to_country>
        </logistics_info_dto>
        <ae_item_properties>
            <ae_item_property>
                <attr_name_id>2981</attr_name_id>
                <attr_name>型号</attr_name>
                <attr_value_id>100234</attr_value_id>
                <attr_value>ABCD</attr_value>
                <attr_value_start>1</attr_value_start>
                <attr_value_end>10</attr_value_end>
                <attr_value_unit>piece</attr_value_unit>
            </ae_item_property>
        </ae_item_properties>
        <ae_store_info>
            <store_id>12345</store_id>
            <store_name>Clothes Store</store_name>
            <item_as_described_rating>4.8</item_as_described_rating>
            <communication_rating>4.8</communication_rating>
            <shipping_speed_rating>4.7</shipping_speed_rating>
        </ae_store_info>
        <product_id_converter_result>
            <main_product_id>32982857990</main_product_id>
            <sub_product_id>{&quot;US&quot;:2251832796543238}</sub_product_id>
        </product_id_converter_result>
    </result>
    <rsp_msg>System Error</rsp_msg>
    <rsp_code>404</rsp_code>
</aliexpress_ds_product_get_response>

{
    "aliexpress_ds_product_get_response":{
        "result":{
            "ae_item_base_info_dto":{
                "product_id":32839190109,
                "category_id":123456,
                "subject":"knew odd",
                "currency_code":"USD",
                "product_status_type":"onSelling",
                "ws_display":"expire_offline",
                "ws_offline_date":"0",
                "gmt_create":"0",
                "gmt_modified":"0",
                "owner_member_seq_long":1006680305,
                "evaluation_count":"100",
                "avg_evaluation_rating":"4.7",
                "detail":"<div>This is a product<\/div>",
                "mobile_detail":"{}"
            },
            "ae_item_sku_info_dtos":{
                "ae_item_sku_info_d_t_o":[
                    {
                        "id":"200000182:193;200007763:201336100",
                        "sku_stock":true,
                        "sku_price":"200.07",
                        "sku_code":"cfas00978",
                        "ipm_sku_stock":1234,
                        "currency_code":"USD",
                        "ae_sku_property_dtos":{
                            "ae_sku_property_d_t_o":[
                                {
                                    "sku_property_id":0,
                                    "sku_property_name":"color",
                                    "sku_property_value":"blue",
                                    "property_value_id":0,
                                    "property_value_definition_name":"0",
                                    "sku_image":"0"
                                }
                            ]
                        },
                        "barcode":"320325455",
                        "offer_sale_price":"3.3",
                        "offer_bulk_sale_price":"3.2",
                        "sku_bulk_order":10,
                        "sku_available_stock":10
                    }
                ]
            },
            "ae_multimedia_info_dto":{
                "ae_video_dtos":{
                    "ae_video_d_t_o":[
                        {
                            "ali_member_id":1006680305,
                            "media_id":12345678,
                            "media_status":"approved",
                            "media_type":"video",
                            "poster_url":"http:\/\/img01.taobaocdn.com\/bao\/uploaded\/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg"
                        }
                    ]
                },
                "image_urls":"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"
            },
            "package_info_dto":{
                "package_length":10,
                "package_height":2,
                "package_width":12,
                "gross_weight":"40.12",
                "base_unit":2,
                "package_type":true,
                "product_unit":100000015
            },
            "logistics_info_dto":{
                "delivery_time":7,
                "ship_to_country":"US"
            },
            "ae_item_properties":{
                "ae_item_property":[
                    {
                        "attr_name_id":2981,
                        "attr_name":"型号",
                        "attr_value_id":100234,
                        "attr_value":"ABCD",
                        "attr_value_start":"1",
                        "attr_value_end":"10",
                        "attr_value_unit":"piece"
                    }
                ]
            },
            "ae_store_info":{
                "store_id":12345,
                "store_name":"Clothes Store",
                "item_as_described_rating":"4.8",
                "communication_rating":"4.8",
                "shipping_speed_rating":"4.7"
            },
            "product_id_converter_result":{
                "main_product_id":32982857990,
                "sub_product_id":"{\"US\":2251832796543238}"
            }
        },
        "rsp_msg":"System Error",
        "rsp_code":"404"
    }
}

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

开放平台

Dropshipping（已废弃）

aliexpress.ds.product.get (商品信息查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ