淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
channel	String	可选	Chanel ex		Chanel
country	String	可选	RU		Contry of product
product_id	Number	可选	4000214130241		product to get full details
terminal	String	可选	ex terminal	默认值：msite	terminal

名称	类型	示例值	描述
result	OpenApiResult	{}	Call result
└ error_code String error Error code └ error_message String failed to get details error message result FullDetailOpenApiVo {} DTO result attributes Attributes Color: Black Product properties └ empty Boolean "" "" └ average_star String 4.5 Product rating └ base_currency_code String USD Currency of product price └ brand String Apple Product brand └ category_url String //www.aliexpress.com/item/4000214130241.html category url └ complaints_url String //report.aliexpress.com/health/reportIndex.htm?product_id=4000214130241&b_login_id=ru1343159888ppmp url for complaints for proudct └ currency_code String RUB Actual currency └ currency_rate String 66.4 Currency rate └ description String Best product ever Product page description └ detail_page_url String //www.aliexpress.com/item/4000402826383.html product page url └ discount_rate Number 33 discount └ display_category_id Number 11 display Category Id └ height Number 66 height of product └ id Number 4000214130241 Id of product └ image_path_list String [] https://ae01.alicdn.com/kf/Ha68587afb00342f288d0934b4e16ab50X/Happy-Baby-WINGY.jpg product images └ is_online Boolean true if product available or not └ keywords String Highchairs, Cheap Highchairs product keywords └ length Number 22 length └ lot Boolean false if it has several lots └ lot_num String 10 number of items in lot └ order_count Number 1000 blured order count └ package_type String sell_by_piece type of package └ send_goods_country String CN contry to send goods from sku_info SkuInfo {} sku details └ has_sku_property Boolean true if the product has several skus product_s_k_u_property_list ProductSkuProperty [] {} product properties └ is_show_type_color Boolean true if sku contains color prop └ order Number 2 sku orders └ show_type String none if show type └ show_type_color Boolean true if show color size_info SizeChartDto {} size info └ has_size_info Boolean true if has size info └ size_info_url String "" url for size info └ title String XL size title └ sku_property_id Number 1 property id └ sku_property_name String size property name sku_property_values ProductSkuPropertyValue [] {} list of properties └ property_value_definition_name String name Property value definition name └ property_value_display_name String Серый Property value name └ property_value_id Number 2 property value id └ property_value_id_long Number 10 property value ID └ property_value_name String Розовый Property value name └ sku_color_value String F8F7E7 color └ sku_property_image_path String https://ae01.alicdn.com/kf/Ha68587afb00342f288d0934b4e16ab50X/Happy-Baby-WINGY.jpg_640x640.jpg" image path └ sku_property_image_summ_path String https://ae01.alicdn.com/kf/Ha68587afb00342f288d0934b4e16ab50X/Happy-Baby-WINGY.jpg_640x640.jpg image └ sku_property_send_goods_country_code String CN send goods country └ sku_property_tips String Бежевый Property of sku └ sku_property_value_show_order Number 1 display order for sku └ sku_property_value_tips String Бежевый sku property └ sku_property_json String [[691,173,1052,365458,771,200002130,200003699],[201336103]] all properties of sku sku_list SkuOpenApiVo [] {} sku list └ act_sku_bulk_cal_price String 50.0 actul sku price └ act_sku_deposit_bulk_price String 50.0 actual sku deposit bulk price └ act_sku_deposit_price String 50.0 actual sku deposit price └ act_sku_multi_currency_bulk_price String 50.0 actual sku multicurrency bulk price └ activity Boolean false is activity └ avail_quantity Number 2 stock └ bulk_order Number 1 bulk orders count └ formatted_sku_activity_amount String "" formatted activity amount └ formatted_sku_amount String 6?599,00 руб Formatted amount └ inventory Number 2 stock └ sku_attr String 14:200002130;200007763:201336103 sku attributes └ sku_big_sale_price String 50.0 sale price └ sku_deposit_amount String 10 deposit amount └ sku_id Number 1 skuId └ sku_prop_ids String 200003699,201336103 properties └ original_price_cents Number 9999 Sku price in subcurrency └ discount_price_cents Number 7777 Sku discount price in subcurrency └ subject String Стул для кормления Happy Baby \"WINGY\ product title └ total_avail_quantity Number stock 36 └ total_feedback_number Number 40 Feedbacks count └ unit_type String шт. Type of stock └ weight String 10 total weight └ width Number 10 pack width └ seller_name String Xiaomi official store Store name └ product_price String 2.0 Not formatted product price └ eng_title String Mobile Phone Product title ENG └ is_local_product Boolean true Is local or CB └ discount_product_price String 1.0 Not formatted price after discount (actual price) └ video_url String https://cloud.video.taobao.com/play/u/2207099077094/p/1/e/6/t/10301/249671896727.mp4 video url └ description_url String https://aeproductsourcesite.alicdn.com/product/description/pc/v2/ru_RU/desc.htm?spm=a1zdd.8414359.0.0.6f0d1712i8ppOo&productId=1005001627619109&key=H334b70b9bcc749fcab052e32c8ae4f28s.zip&token=ad09fde878c15a7f26a04fac1bd0d109 Url to description html └ success Boolean true success

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressSocialProductFulldetailQueryRequest req = new AliexpressSocialProductFulldetailQueryRequest();
req.setChannel("Chanel ex");
req.setCountry("RU");
req.setProductId(4000214130241L);
req.setTerminal("ex terminal");
AliexpressSocialProductFulldetailQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AliexpressSocialProductFulldetailQueryRequest req = new AliexpressSocialProductFulldetailQueryRequest();
req.Channel = "Chanel ex";
req.Country = "RU";
req.ProductId = 4000214130241L;
req.Terminal = "ex terminal";
AliexpressSocialProductFulldetailQueryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AliexpressSocialProductFulldetailQueryRequest;
$req->setChannel("Chanel ex");
$req->setCountry("RU");
$req->setProductId("4000214130241");
$req->setTerminal("ex terminal");
$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=aliexpress.social.product.fulldetail.query' \
-d 'partner_id=apidoc' \
-d 'sign=168DE0C986FF793D0D821912D457AAFF' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-24+11%3A50%3A49' \
-d 'v=2.0' \
-d 'channel=Chanel+ex' \
-d 'country=RU' \
-d 'product_id=4000214130241' \
-d 'terminal=ex+terminal'

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

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

req.channel="Chanel ex"
req.country="RU"
req.product_id=4000214130241
req.terminal="ex terminal"
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,"aliexpress.social.product.fulldetail.query");
add_param(pRequest,"channel","Chanel ex");
add_param(pRequest,"country","RU");
add_param(pRequest,"product_id","4000214130241");
add_param(pRequest,"terminal","ex terminal");
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('aliexpress.social.product.fulldetail.query', {
	'channel':'Chanel ex',
	'country':'RU',
	'product_id':'4000214130241',
	'terminal':'ex terminal'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<aliexpress_social_product_fulldetail_query_response>
    <result>
        <error_code>error</error_code>
        <error_message>failed to get details</error_message>
        <result>
            <attributes>
                <empty>&quot;&quot;</empty>
            </attributes>
            <average_star>4.5</average_star>
            <base_currency_code>USD</base_currency_code>
            <brand>Apple</brand>
            <category_url>//www.aliexpress.com/item/4000214130241.html</category_url>
            <complaints_url>//report.aliexpress.com/health/reportIndex.htm?product_id=4000214130241&amp;b_login_id=ru1343159888ppmp</complaints_url>
            <currency_code>RUB</currency_code>
            <currency_rate>66.4</currency_rate>
            <description>Best product ever</description>
            <detail_page_url>//www.aliexpress.com/item/4000402826383.html</detail_page_url>
            <discount_rate>33</discount_rate>
            <display_category_id>11</display_category_id>
            <height>66</height>
            <id>4000214130241</id>
            <image_path_list>
                <string>https://ae01.alicdn.com/kf/Ha68587afb00342f288d0934b4e16ab50X/Happy-Baby-WINGY.jpg</string>
            </image_path_list>
            <is_online>true</is_online>
            <keywords>Highchairs, Cheap Highchairs</keywords>
            <length>22</length>
            <lot>false</lot>
            <lot_num>10</lot_num>
            <order_count>1000</order_count>
            <package_type>sell_by_piece</package_type>
            <send_goods_country>CN</send_goods_country>
            <sku_info>
                <has_sku_property>true</has_sku_property>
                <product_s_k_u_property_list>
                    <product_sku_property>
                        <is_show_type_color>true</is_show_type_color>
                        <order>2</order>
                        <show_type>none</show_type>
                        <show_type_color>true</show_type_color>
                        <size_info>
                            <has_size_info>true</has_size_info>
                            <size_info_url>&quot;&quot;</size_info_url>
                            <title>XL</title>
                        </size_info>
                        <sku_property_id>1</sku_property_id>
                        <sku_property_name>size</sku_property_name>
                        <sku_property_values>
                            <product_sku_property_value>
                                <property_value_definition_name>name</property_value_definition_name>
                                <property_value_display_name>Серый</property_value_display_name>
                                <property_value_id>2</property_value_id>
                                <property_value_id_long>10</property_value_id_long>
                                <property_value_name>Розовый</property_value_name>
                                <sku_color_value>F8F7E7</sku_color_value>
                                <sku_property_image_path>https://ae01.alicdn.com/kf/Ha68587afb00342f288d0934b4e16ab50X/Happy-Baby-WINGY.jpg_640x640.jpg&quot;</sku_property_image_path>
                                <sku_property_image_summ_path>https://ae01.alicdn.com/kf/Ha68587afb00342f288d0934b4e16ab50X/Happy-Baby-WINGY.jpg_640x640.jpg</sku_property_image_summ_path>
                                <sku_property_send_goods_country_code>CN</sku_property_send_goods_country_code>
                                <sku_property_tips>Бежевый</sku_property_tips>
                                <sku_property_value_show_order>1</sku_property_value_show_order>
                                <sku_property_value_tips>Бежевый</sku_property_value_tips>
                            </product_sku_property_value>
                        </sku_property_values>
                    </product_sku_property>
                </product_s_k_u_property_list>
                <sku_property_json>[[691,173,1052,365458,771,200002130,200003699],[201336103]]</sku_property_json>
            </sku_info>
            <sku_list>
                <sku_open_api_vo>
                    <act_sku_bulk_cal_price>50.0</act_sku_bulk_cal_price>
                    <act_sku_deposit_bulk_price>50.0</act_sku_deposit_bulk_price>
                    <act_sku_deposit_price>50.0</act_sku_deposit_price>
                    <act_sku_multi_currency_bulk_price>50.0</act_sku_multi_currency_bulk_price>
                    <activity>false</activity>
                    <avail_quantity>2</avail_quantity>
                    <bulk_order>1</bulk_order>
                    <formatted_sku_activity_amount>&quot;&quot;</formatted_sku_activity_amount>
                    <formatted_sku_amount>6?599,00 руб</formatted_sku_amount>
                    <inventory>2</inventory>
                    <sku_attr>14:200002130;200007763:201336103</sku_attr>
                    <sku_big_sale_price>50.0</sku_big_sale_price>
                    <sku_deposit_amount>10</sku_deposit_amount>
                    <sku_id>1</sku_id>
                    <sku_prop_ids>200003699,201336103</sku_prop_ids>
                    <original_price_cents>9999</original_price_cents>
                    <discount_price_cents>7777</discount_price_cents>
                </sku_open_api_vo>
            </sku_list>
            <subject>Стул для кормления Happy Baby \&quot;WINGY\</subject>
            <total_avail_quantity>stock</total_avail_quantity>
            <total_feedback_number>40</total_feedback_number>
            <unit_type>шт.</unit_type>
            <weight>10</weight>
            <width>10</width>
            <seller_name>Xiaomi official store</seller_name>
            <product_price>2.0</product_price>
            <eng_title>Mobile Phone</eng_title>
            <is_local_product>true</is_local_product>
            <discount_product_price>1.0</discount_product_price>
            <video_url>https://cloud.video.taobao.com/play/u/2207099077094/p/1/e/6/t/10301/249671896727.mp4</video_url>
            <description_url>https://aeproductsourcesite.alicdn.com/product/description/pc/v2/ru_RU/desc.htm?spm=a1zdd.8414359.0.0.6f0d1712i8ppOo&amp;productId=1005001627619109&amp;key=H334b70b9bcc749fcab052e32c8ae4f28s.zip&amp;token=ad09fde878c15a7f26a04fac1bd0d109</description_url>
        </result>
        <success>true</success>
    </result>
</aliexpress_social_product_fulldetail_query_response>

{
    "aliexpress_social_product_fulldetail_query_response":{
        "result":{
            "error_code":"error",
            "error_message":"failed to get details",
            "result":{
                "attributes":{
                    "empty":""
                },
                "average_star":"4.5",
                "base_currency_code":"USD",
                "brand":"Apple",
                "category_url":"\/\/www.aliexpress.com\/item\/4000214130241.html",
                "complaints_url":"\/\/report.aliexpress.com\/health\/reportIndex.htm?product_id=4000214130241&b_login_id=ru1343159888ppmp",
                "currency_code":"RUB",
                "currency_rate":"66.4",
                "description":"Best product ever",
                "detail_page_url":"\/\/www.aliexpress.com\/item\/4000402826383.html",
                "discount_rate":33,
                "display_category_id":11,
                "height":66,
                "id":4000214130241,
                "image_path_list":{
                    "string":[
                        "https:\/\/ae01.alicdn.com\/kf\/Ha68587afb00342f288d0934b4e16ab50X\/Happy-Baby-WINGY.jpg"
                    ]
                },
                "is_online":true,
                "keywords":"Highchairs, Cheap Highchairs",
                "length":22,
                "lot":false,
                "lot_num":"10",
                "order_count":1000,
                "package_type":"sell_by_piece",
                "send_goods_country":"CN",
                "sku_info":{
                    "has_sku_property":true,
                    "product_s_k_u_property_list":{
                        "product_sku_property":[
                            {
                                "is_show_type_color":true,
                                "order":2,
                                "show_type":"none",
                                "show_type_color":true,
                                "size_info":{
                                    "has_size_info":true,
                                    "size_info_url":"\"\"",
                                    "title":"XL"
                                },
                                "sku_property_id":1,
                                "sku_property_name":"size",
                                "sku_property_values":{
                                    "product_sku_property_value":[
                                        {
                                            "property_value_definition_name":"name",
                                            "property_value_display_name":"Серый",
                                            "property_value_id":2,
                                            "property_value_id_long":10,
                                            "property_value_name":"Розовый",
                                            "sku_color_value":"F8F7E7",
                                            "sku_property_image_path":"https:\/\/ae01.alicdn.com\/kf\/Ha68587afb00342f288d0934b4e16ab50X\/Happy-Baby-WINGY.jpg_640x640.jpg\"",
                                            "sku_property_image_summ_path":"https:\/\/ae01.alicdn.com\/kf\/Ha68587afb00342f288d0934b4e16ab50X\/Happy-Baby-WINGY.jpg_640x640.jpg",
                                            "sku_property_send_goods_country_code":"CN",
                                            "sku_property_tips":"Бежевый",
                                            "sku_property_value_show_order":1,
                                            "sku_property_value_tips":"Бежевый"
                                        }
                                    ]
                                }
                            }
                        ]
                    },
                    "sku_property_json":"[[691,173,1052,365458,771,200002130,200003699],[201336103]]"
                },
                "sku_list":{
                    "sku_open_api_vo":[
                        {
                            "act_sku_bulk_cal_price":"50.0",
                            "act_sku_deposit_bulk_price":"50.0",
                            "act_sku_deposit_price":"50.0",
                            "act_sku_multi_currency_bulk_price":"50.0",
                            "activity":false,
                            "avail_quantity":2,
                            "bulk_order":1,
                            "formatted_sku_activity_amount":"\"\"",
                            "formatted_sku_amount":"6?599,00 руб",
                            "inventory":2,
                            "sku_attr":"14:200002130;200007763:201336103",
                            "sku_big_sale_price":"50.0",
                            "sku_deposit_amount":"10",
                            "sku_id":1,
                            "sku_prop_ids":"200003699,201336103",
                            "original_price_cents":9999,
                            "discount_price_cents":7777
                        }
                    ]
                },
                "subject":"Стул для кормления Happy Baby \\\"WINGY\\",
                "total_avail_quantity":stock,
                "total_feedback_number":40,
                "unit_type":"шт.",
                "weight":"10",
                "width":10,
                "seller_name":"Xiaomi official store",
                "product_price":"2.0",
                "eng_title":"Mobile Phone",
                "is_local_product":true,
                "discount_product_price":"1.0",
                "video_url":"https:\/\/cloud.video.taobao.com\/play\/u\/2207099077094\/p\/1\/e\/6\/t\/10301\/249671896727.mp4",
                "description_url":"https:\/\/aeproductsourcesite.alicdn.com\/product\/description\/pc\/v2\/ru_RU\/desc.htm?spm=a1zdd.8414359.0.0.6f0d1712i8ppOo&productId=1005001627619109&key=H334b70b9bcc749fcab052e32c8ae4f28s.zip&token=ad09fde878c15a7f26a04fac1bd0d109"
            },
            "success":true
        }
    }
}

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

AE-SOCIAL

aliexpress.social.product.fulldetail.query (速卖通.社会的.产品.完整细节.询问)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ