淘宝开放平台 - 文档中心

请求地址：

环境	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		商品ID

名称	类型	示例值	描述
result	AeopFindProductResultDto		result
└ add_unit Number 11 每增加件数.取值范围1-1000。 └ add_weight String 11.11 对应增加的重量.取值范围:0.001-500.000,保留三位小数,采用进位制,单位:公斤。 aeop_a_e_multimedia AeopAeMultimedia aeopAEMultimedia":{"aeopAEVideos":[{"mediaId":30994083,"posterUrl":"http://img02.taobaocdn.com/bao/uploaded/TB16e9MJVXXXXacXVXXXXXXXXXX.jpg","mediaStatus":"approved","mediaType":"video","aliMemberId":225671041}]} 商品多媒体信息，该属性主要包含商品的视频列表 aeop_a_e_videos AeopAeVideo [] [ { "aliMemberId": 117284237, "mediaId": 35683461, "mediaType": "video", "mediaStatus": "approved", "posterUrl": "http://img02.taobaocdn.com/bao/uploaded/TB1a7HKLVXXXXX5XVXXXXXXXXXX.jpg" }] 多媒体信息。 └ media_id Number 12345678 视频ID └ media_type String video 视频的类型 └ poster_url String http://img01.taobaocdn.com/bao/uploaded/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg 视频封面图片的URL aeop_ae_product_propertys AeopAeProductProperty [] 商品的类目属性 └ attr_name String size 自定义属性名属性名。自定义属性名时,该项必填. └ attr_name_id Number 200000043 属性名ID。从类目属性接口getAttributesResultByCateId获取普通类目属性，不可填入sku属性。自定义属性名时,该项不填. └ attr_value String 2 - 5 kg 自定义属性值。自定义属性名时,该项必填。当自定义属性值内容为区间情况时，建议格式2 - 5 kg。(注意，数字'-'单位三者间是要加空格的！) └ attr_value_end String 0 自定义属性值的结束端 └ attr_value_start String 0 自定义属性值的开始端 └ attr_value_unit String 0 自定义属性值单位 └ attr_value_id Number 493 属性值ID aeop_ae_product_s_k_us AeopAeProductSku [] 商品的SKU信息 aeop_s_k_u_property_list AeopSkuProperty [] "aeopSKUProperty":[{"skuPropertyId":"14","propertyValueId":"771"},{"skuPropertyId":"25","propertyValueId":"775"}] Sku属性对象list，允许1-3个sku属性对象，按sku属性顺序排放。sku属性从类目属性接口getAttributesResultByCateId获取。该项值输入sku属性，不能输入普通类目属性。注意，sku属性是有顺序的，必须按照顺序存放。 └ property_value_definition_name String pink 属性值自定义名称 └ sku_image String http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg SKU图片地址 └ sku_property_id Number 14 SKU属性ID └ property_value_id Number 366 SKU属性值ID └ image_url_list String [] [http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg] sku 套图 └ currency_code String USD 产品的货币单位。美元: USD, 卢布: RUB └ id String "200000182:193;200007763:201336100" SKU ID，格式：“sku_property_id:property_value_id” └ ipm_sku_stock Number 1234 SKU实际可售库存属性ipmSkuStock，该属性值的合理取值范围为0~999999，如该商品有SKU时，请确保至少有一个SKU是有货状态，也就是ipmSkuStock取值是1~999999，在整个商品纬度库存值的取值范围是1~999999。如果同时设置了skuStock属性，那么系统以ipmSkuStock属性为优先；如果没有设置ipmSkuStock属性，那么系统会根据skuStock属性进行设置库存，true表示999，false表示0。 └ sku_code String cfas00978 Sku商家编码。格式:半角英数字,长度20,不包含空格大于号和小于号。如果用户只填写零售价（productprice）和商品编码，需要完整生成一条SKU记录提交，否则商品编码无法保存。系统会认为只提交了零售价，而没有SKU，导致商品编辑未保存。 └ sku_price String 200.07 Sku价格。取值范围:0.01-100000;单位:美元。如:200.07，表示:200美元7分。需要在正确的价格区间内。 └ sku_stock Boolean true Sku库存,数据格式有货true，无货false；至少有一条sku记录是有货的。 └ barcode String 0 条码，所有的仓发商品（尖货，自营，假发）会返回这个参数 aeop_s_k_u_national_discount_price_list AeopSkuNationalDiscountPrice [] sku分国家的日常促销价 └ discount_price String 9.98 sku分国家的日常促销价价格 └ shipto_country String RU sku分国家的日常促销价国家 └ sku_discount_price String 10.01 sku日常促销价 └ gross_weight String 1 sku重量，单位公斤 └ package_height Number 2 sku物流尺寸-高，单位cm └ package_width Number 3 sku物流尺寸-宽，单位cm └ package_length Number 4 sku物流尺寸-长，单位cm └ ext_param String "{\"isSkuVatPrice\":true}" 扩展参数 json格式 └ ean_code String 12345678 sku维度eanCode └ base_unit Number 2 自定义计重的基本产品件数 └ bulk_discount Number 90 产品的批发折扣 └ bulk_order Number 10 享受批发价的产品数 └ category_id Number 123456 产品所在类目的ID └ currency_code String USD 产品的货币单位。美元: USD, 卢布: RUB └ delivery_time Number 60 商品的备货期 └ gross_weight String 40.12 产品的毛重 └ group_id Number 10023 产品所关联的产品分组ID └ group_ids Number [] [1002141,10024524] 产品所在的产品分组列表 └ 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 产品的主图列表 └ is_pack_sell Boolean true 是否支持是自定义计重 └ keyword String 0 关键字 └ lot_num Number 1 每包的数量 └ package_height Number 30 产品的高度 └ package_length Number 10 产品的长度 └ package_width Number 20 产品的宽度 └ product_id Number 1234 产品ID └ product_price String 10.23 单品产品的价格。 └ product_status_type String onSelling 产品的状态，包括onSelling（正在销售），offline（已下架），auditing（审核中），editingRequired（审核不通过） └ product_unit Number 100000015 产品的单位 └ promise_template_id Number 100 产品所关联的服务模版 └ reduce_strategy String place_order_withhold或payment_success_deduct 库存的扣减策略 └ sizechart_id Number 123 产品所关联的尺码模版ID └ ws_display String expire_offline 产品的下架原因，包括user_offline：手动下架，expire_offline：到期下架，punish_offline：网规处罚下架，violate_offline：交易违规下架，degrade_offline：降级下架，industry_offline：未续约下架 └ ws_offline_date Date 2018-12-19 11:24:27 产品的下架日期 └ ws_valid_num Number 30 产品的有效期 aeop_national_quote_configuration AeopNationalQuoteConfiguration 商品分国家报价的配置 └ configuration_data String percentage:[{"shiptoCountry":"US","percentage":"5"},{"shiptoCountry":"RU","percentage":"-2"}] relative:[{"shiptoCountry":"RU","relative":0.1},{"shiptoCountry":"US","relative":-0.1}] absolute:[{"absoluteQuoteMap":{"14:193":84.99,"14:771":84.99},"shiptoCountry":"FR"},{"absoluteQuoteMap":{"14:193":89.99,"14:771":89.99},"shiptoCountry":"ES"}] jsonArray格式的分国家定价规则数据。 1)基于基准价格按比例配置的数据格式；2)基于基准价格按涨或者跌多少；3）为每个SKU直接设置价格绝对值。其中shiptoCountry：ISO两位的国家编码（目前支持国家：RU US CA ES FR UK NL IL BR CL AU UA BY JP TH SG KR ID MY PH VN IT DE SA AE PL TR）， percentage：相对于基准价的调价比例（百分比整数，支持负数，当前限制>=-30 && <=100）；configuration_type为absolute：14:193为sku属性ID：SKU属性值，多个属性用，号拼接。 └ configuration_type String percentage, relative, absolute 分国家定价规则类型[absolute: 为每个SKU直接设置价格绝对值；percentage：基于基准价格按比例配置; relative:相对原价涨或跌多少; └ package_type Boolean true 打包销售: true 非打包销售:false └ gmt_modified Date 2018-12-18 17:11:08 修改日期 └ gmt_create Date 2018-12-03 15:17:33 创建日期 subject_list Subject [] 多语言标题 └ value String item subject 多语言标题内容 └ locale String en_US 语种标记locale └ locale String en_US 商品初始发布locale detail_source_list DetailSource [] 多语言详描 └ locale String en_US 详描语种locale └ web_detail String product detail desc PC端详描内容 └ mobile_detail String product detail desc 移动端详描内容 market_images MarketImage [] 营销图列表 └ url String https://ae01.alicdn.com/kf/HTB1C72NbcvrXXX.jpg 营销图片URL └ image_type Number 1 1：代表长图，大小为7501000; 2：代表方图，大小为800800 └ dp_bulk_discount Number 90 产品的批发折扣 └ dp_bulk_order Number 2 享受批发价的产品数 └ freight_template_id Number 1000 产品关联的运费模版ID └ ext_param String { "custom_image": { "image": { "RU": "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", "BR": "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", "ES": "" }, "process_customized_image": true }, "vat_tags": [{ "sku_id": "200007763:201336100", "is_sku_vat_tag": true }] } json格式的扩展参数 custom_image 分国家主图 vat_tags 含税标 mode_size_chart_list AeopAeModeSizeChartDto [] { "hips": "22", "lengthUnit": "CM", "bust": "222", "waist": "222", "modeSize": "2", "height": "2222" } 模特尺码数据 └ mode_size String 试穿尺码 └ height String 身高 └ bust String 胸围 └ waist String 腰围 └ hips String 臀围

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

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

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

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AliexpressOfferProductQueryRequest;
$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.offer.product.query' \
-d 'partner_id=apidoc' \
-d 'session=f18b76b4-6ac8-49dc-b404-357705c4a893' \
-d 'sign=BE1CA20A77064FDAFE5D00D231578C3B' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-28+17%3A16%3A37' \
-d 'v=2.0' \
-d 'product_id=1307422965'

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

req=top.api.AliexpressOfferProductQueryRequest(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.offer.product.query");
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.offer.product.query', {
	'product_id':'1307422965'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<aliexpress_offer_product_query_response>
    <result>
        <add_unit>11</add_unit>
        <add_weight>11.11</add_weight>
        <aeop_a_e_multimedia>
            <aeop_a_e_videos>
                <aeop_ae_video>
                    <media_id>12345678</media_id>
                    <media_type>video</media_type>
                    <poster_url>http://img01.taobaocdn.com/bao/uploaded/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg</poster_url>
                </aeop_ae_video>
            </aeop_a_e_videos>
        </aeop_a_e_multimedia>
        <aeop_ae_product_propertys>
            <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_end>0</attr_value_end>
                <attr_value_start>0</attr_value_start>
                <attr_value_unit>0</attr_value_unit>
                <attr_value_id>493</attr_value_id>
            </aeop_ae_product_property>
        </aeop_ae_product_propertys>
        <aeop_ae_product_s_k_us>
            <aeop_ae_product_sku>
                <aeop_s_k_u_property_list>
                    <aeop_sku_property>
                        <property_value_definition_name>pink</property_value_definition_name>
                        <sku_image>http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg</sku_image>
                        <sku_property_id>14</sku_property_id>
                        <property_value_id>366</property_value_id>
                        <image_url_list>
                            <string>[http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg]</string>
                        </image_url_list>
                    </aeop_sku_property>
                </aeop_s_k_u_property_list>
                <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>
                <barcode>0</barcode>
                <aeop_s_k_u_national_discount_price_list>
                    <aeop_sku_national_discount_price>
                        <discount_price>9.98</discount_price>
                        <shipto_country>RU</shipto_country>
                    </aeop_sku_national_discount_price>
                </aeop_s_k_u_national_discount_price_list>
                <sku_discount_price>10.01</sku_discount_price>
                <gross_weight>1</gross_weight>
                <package_height>2</package_height>
                <package_width>3</package_width>
                <package_length>4</package_length>
                <ext_param>&quot;{\&quot;isSkuVatPrice\&quot;:true}&quot;</ext_param>
                <ean_code>12345678</ean_code>
            </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>
        <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>
        <keyword>0</keyword>
        <lot_num>1</lot_num>
        <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>
        <ws_display>expire_offline</ws_display>
        <ws_offline_date>2018-12-19 11:24:27</ws_offline_date>
        <ws_valid_num>30</ws_valid_num>
        <aeop_national_quote_configuration>
            <configuration_data>percentage:[{&quot;shiptoCountry&quot;:&quot;US&quot;,&quot;percentage&quot;:&quot;5&quot;},{&quot;shiptoCountry&quot;:&quot;RU&quot;,&quot;percentage&quot;:&quot;-2&quot;}] relative:[{&quot;shiptoCountry&quot;:&quot;RU&quot;,&quot;relative&quot;:0.1},{&quot;shiptoCountry&quot;:&quot;US&quot;,&quot;relative&quot;:-0.1}] absolute:[{&quot;absoluteQuoteMap&quot;:{&quot;14:193&quot;:84.99,&quot;14:771&quot;:84.99},&quot;shiptoCountry&quot;:&quot;FR&quot;},{&quot;absoluteQuoteMap&quot;:{&quot;14:193&quot;:89.99,&quot;14:771&quot;:89.99},&quot;shiptoCountry&quot;:&quot;ES&quot;}]</configuration_data>
            <configuration_type>percentage, relative, absolute</configuration_type>
        </aeop_national_quote_configuration>
        <package_type>true</package_type>
        <gmt_modified>2018-12-18 17:11:08</gmt_modified>
        <gmt_create>2018-12-03 15:17:33</gmt_create>
        <subject_list>
            <subject>
                <value>item subject</value>
                <locale>en_US</locale>
            </subject>
        </subject_list>
        <locale>en_US</locale>
        <detail_source_list>
            <detail_source>
                <locale>en_US</locale>
                <web_detail>product detail desc</web_detail>
                <mobile_detail>product detail desc</mobile_detail>
            </detail_source>
        </detail_source_list>
        <market_images>
            <market_image>
                <url>https://ae01.alicdn.com/kf/HTB1C72NbcvrXXX.jpg</url>
                <image_type>1</image_type>
            </market_image>
        </market_images>
        <dp_bulk_discount>90</dp_bulk_discount>
        <dp_bulk_order>2</dp_bulk_order>
        <freight_template_id>1000</freight_template_id>
        <ext_param>{   &quot;custom_image&quot;: {     &quot;image&quot;: {       &quot;RU&quot;: &quot;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&quot;,       &quot;BR&quot;: &quot;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&quot;,       &quot;ES&quot;: &quot;&quot;     },     &quot;process_customized_image&quot;: true   },   &quot;vat_tags&quot;: [{     &quot;sku_id&quot;: &quot;200007763:201336100&quot;,     &quot;is_sku_vat_tag&quot;: true   }] }</ext_param>
        <mode_size_chart_list>
            <aeop_ae_mode_size_chart_dto>
                <mode_size></mode_size>
                <height></height>
                <bust></bust>
                <waist></waist>
                <hips></hips>
            </aeop_ae_mode_size_chart_dto>
        </mode_size_chart_list>
    </result>
</aliexpress_offer_product_query_response>

{
    "aliexpress_offer_product_query_response":{
        "result":{
            "add_unit":11,
            "add_weight":"11.11",
            "aeop_a_e_multimedia":{
                "aeop_a_e_videos":{
                    "aeop_ae_video":[
                        {
                            "media_id":12345678,
                            "media_type":"video",
                            "poster_url":"http:\/\/img01.taobaocdn.com\/bao\/uploaded\/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg"
                        }
                    ]
                }
            },
            "aeop_ae_product_propertys":{
                "aeop_ae_product_property":[
                    {
                        "attr_name":"size",
                        "attr_name_id":200000043,
                        "attr_value":"2 - 5 kg",
                        "attr_value_end":"0",
                        "attr_value_start":"0",
                        "attr_value_unit":"0",
                        "attr_value_id":493
                    }
                ]
            },
            "aeop_ae_product_s_k_us":{
                "aeop_ae_product_sku":[
                    {
                        "aeop_s_k_u_property_list":{
                            "aeop_sku_property":[
                                {
                                    "property_value_definition_name":"pink",
                                    "sku_image":"http:\/\/ae01.alicdn.com\/kf\/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg",
                                    "sku_property_id":14,
                                    "property_value_id":366,
                                    "image_url_list":{
                                        "string":[
                                            "[http:\/\/ae01.alicdn.com\/kf\/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg]"
                                        ]
                                    }
                                }
                            ]
                        },
                        "currency_code":"USD",
                        "id":"\"200000182:193;200007763:201336100\"",
                        "ipm_sku_stock":1234,
                        "sku_code":"cfas00978",
                        "sku_price":"200.07",
                        "sku_stock":true,
                        "barcode":"0",
                        "aeop_s_k_u_national_discount_price_list":{
                            "aeop_sku_national_discount_price":[
                                {
                                    "discount_price":"9.98",
                                    "shipto_country":"RU"
                                }
                            ]
                        },
                        "sku_discount_price":"10.01",
                        "gross_weight":"1",
                        "package_height":2,
                        "package_width":3,
                        "package_length":4,
                        "ext_param":"\"{\\\"isSkuVatPrice\\\":true}\"",
                        "ean_code":"12345678"
                    }
                ]
            },
            "base_unit":2,
            "bulk_discount":90,
            "bulk_order":10,
            "category_id":123456,
            "currency_code":"USD",
            "delivery_time":60,
            "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,
            "keyword":"0",
            "lot_num":1,
            "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,
            "ws_display":"expire_offline",
            "ws_offline_date":"2018-12-19 11:24:27",
            "ws_valid_num":30,
            "aeop_national_quote_configuration":{
                "configuration_data":"percentage:[{\"shiptoCountry\":\"US\",\"percentage\":\"5\"},{\"shiptoCountry\":\"RU\",\"percentage\":\"-2\"}] relative:[{\"shiptoCountry\":\"RU\",\"relative\":0.1},{\"shiptoCountry\":\"US\",\"relative\":-0.1}] absolute:[{\"absoluteQuoteMap\":{\"14:193\":84.99,\"14:771\":84.99},\"shiptoCountry\":\"FR\"},{\"absoluteQuoteMap\":{\"14:193\":89.99,\"14:771\":89.99},\"shiptoCountry\":\"ES\"}]",
                "configuration_type":"percentage, relative, absolute"
            },
            "package_type":true,
            "gmt_modified":"2018-12-18 17:11:08",
            "gmt_create":"2018-12-03 15:17:33",
            "subject_list":{
                "subject":[
                    {
                        "value":"item subject",
                        "locale":"en_US"
                    }
                ]
            },
            "locale":"en_US",
            "detail_source_list":{
                "detail_source":[
                    {
                        "locale":"en_US",
                        "web_detail":"product detail desc",
                        "mobile_detail":"product detail desc"
                    }
                ]
            },
            "market_images":{
                "market_image":[
                    {
                        "url":"https:\/\/ae01.alicdn.com\/kf\/HTB1C72NbcvrXXX.jpg",
                        "image_type":1
                    }
                ]
            },
            "dp_bulk_discount":90,
            "dp_bulk_order":2,
            "freight_template_id":1000,
            "ext_param":"{   \"custom_image\": {     \"image\": {       \"RU\": \"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\",       \"BR\": \"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\",       \"ES\": \"\"     },     \"process_customized_image\": true   },   \"vat_tags\": [{     \"sku_id\": \"200007763:201336100\",     \"is_sku_vat_tag\": true   }] }",
            "mode_size_chart_list":{
                "aeop_ae_mode_size_chart_dto":[
                    {
                        "mode_size":"",
                        "height":"",
                        "bust":"",
                        "waist":"",
                        "hips":""
                    }
                ]
            }
        }
    }
}

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-商品

aliexpress.offer.product.query (商品查询新接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ