淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
fields	String []	必须	num_iid,title,nick,pric	最大列表长度：1000	需要返回的商品对象字段。可选值：Item商品结构体中字段均可返回(其中item_weight,item_size,sold_quantity暂未返回)；多个字段用“,”分隔。如果想返回整个子对象，fields设置相应字段，如itemimg；如果想返回子对象里面的某个字段，那字段设为某个值，如itemimg.url。
num_iids	String []	可选	123456,223456	最大列表长度：1000	商品数字id列表，多个num_iid用逗号隔开，一次不超过20个。

名称	类型	示例值	描述
items	Item []		获取的商品具体字段根据权限和设定的fields决定
└ iid String 13232 商品iid └ detail_url String http://item.taobao.com/item.htm?id=4947813209 商品url └ num_iid Number 1489161932 商品数字id └ title String Google test item 商品标题,不能超过60字节 └ nick String tbtest561 卖家昵称 └ type String fixed 商品类型(fixed:一口价;auction:拍卖)注：取消团购 └ cid Number 132443 商品所属的叶子类目 id └ props String 135255:344454 商品属性格式：pid:vid;pid:vid └ desc String 这是一个好商品商品描述, 字数要大于5个字符，小于25000个字符 └ pic_url String http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg 商品主图片地址 └ num Number 8888 商品数量 └ list_time Date 2009-10-22 14:22:06 上架时间（格式：yyyy-MM-dd HH:mm:ss） └ delist_time Date 2000-01-01 00:00:00 下架时间（格式：yyyy-MM-dd HH:mm:ss） └ stuff_status String new 商品新旧程度(全新:new，闲置:unused，二手：second) location Location 商品所在地 └ state String 浙江所在省份（中文名称） └ city String 杭州所在城市（中文名称） └ price String 5.00 商品价格，格式：5.00；单位：元；精确到：分 └ post_fee String 5.00 平邮费用,格式：5.00；单位：元；精确到：分 └ express_fee String 5.00 快递费用,格式：5.00；单位：元；精确到：分 └ ems_fee String 5.00 ems费用,格式：5.00；单位：元；精确到：分 └ approve_status String onsale 商品上传后的状态。onsale出售中，instock库中 └ postage_id Number 32 宝贝所属的运费模板ID，如果没有返回则说明没有使用运费模板 └ product_id Number 85883030 宝贝所属产品的id(可能为空). 该字段可以通过taobao.products.search 得到 └ auction_point Number 15 商品的积分返点比例。如:5,表示:返点比例0.5% item_imgs ItemImg [] 商品图片列表(包括主图)。fields中只设置item_img可以返回ItemImg结构体中所有字段，如果设置为item_img.id、item_img.url、item_img.position等形式就只会返回相应的字段 └ id Number 1645920 商品图片的id，和商品相对应（主图id默认为0） └ url String http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg 图片链接地址 └ position Number 1 图片放在第几张（多图时可设置） prop_imgs PropImg [] 商品属性图片列表。fields中只设置prop_img可以返回PropImg结构体中所有字段，如果设置为prop_img.id、prop_img.url、prop_img.properties、prop_img.position等形式就只会返回相应的字段 └ id Number 1646146 属性图片的id，和商品相对应 └ url String http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg 图片链接地址 └ properties String 1627207:28326 图片所对应的属性组合的字符串 └ position Number 1 图片放在第几张（多图时可设置） skus Sku [] Sku列表。fields中只设置sku可以返回Sku结构体中所有字段，如果设置为sku.sku_id、sku.properties、sku.quantity等形式就只会返回相应的字段 └ sku_id Number 123 sku的id └ properties String 1243:1215;5626:5125 sku的销售属性组合字符串（颜色，大小，等等，可通过类目API获取某类目下的销售属性）,格式是p1:v1;p2:v2 └ properties_name String 20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性1:属性值1 sku所对应的销售属性的中文名字串，格式如：pid1:vid1:pid_name1:vid_name1;pid2:vid2:pid_name2:vid_name2…… └ quantity Number 3 属于这个sku的商品的数量， └ price String 200.07 属于这个sku的商品的价格取值范围:0-100000000;精确到2位小数;单位:元。如:200.07，表示:200元7分。 └ outer_id String 12345 商家设置的外部id。天猫和集市的卖家，需要登录才能获取到自己的商家编码，不能获取到他人的商家编码。 └ barcode String 6903244981002 商品级别的条形码 └ with_hold_quantity Number 100 商品在付款减库存的状态下，该sku上未付款的订单数量 └ outer_id String 34143554352 商家外部编码(可与商家外部系统对接)。需要授权才能获取。 └ is_virtual Boolean true 虚拟商品的状态字段 └ is_taobao Boolean true 是否在淘宝显示 └ is_timing Boolean true 是否定时上架商品 └ props_name String 20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;30606:112030:上市时间:2008年商品属性名称。标识着props内容里面的pid和vid所对应的名称。格式为：pid1:vid1:pid_name1:vid_name1;pid2:vid2:pid_name2:vid_name2……(注：属性名称中的冒号":"被转换为："#cln#"; 分号";"被转换为："#scln#") └ is_fenxiao Number 0 非分销商品：0，代销：1，经销：2 └ template_id String 123456 页面模板id └ global_stock_type String 1 全球购商品采购地信息（库存类型），有两种库存类型：现货和代购;参数值为1时代表现货，值为2时代表代购 └ global_stock_country String 美国全球购商品采购地信息（地区/国家），代表全球购商品的产地信息。 └ global_stock_delivery_place String 1 全球购商品发货地，发货地现在有两种类型：“国内”和“海外及港澳台”，参数值为1时代表“国内”，值为2时代表“海外及港澳台” └ global_stock_tax_free_promise Boolean false 全球购商品卖家包税承诺，当值为true时，代表卖家承诺包税。 └ barcode String 6903244981002 商品级别的条形码 └ sub_stock Number 1 商品是否支持拍下减库存:1支持;2取消支持(付款减库存);0(默认)不更改集市卖家默认拍下减库存; 商城卖家默认付款减库存 └ with_hold_quantity Number 12 预扣库存，即付款减库存的商品现在有多少处于未付款状态的订单 └ sell_point String 2013新款时尚前卫商品卖点信息，天猫商家使用字段，最长150个字符。 └ support_charge_free Boolean false 是否支持分期免息 └ white_bg_image String /i3/T1HXdXXgPSt0JxZ2.8_070458.jpg 白底图URL └ charge_free_list String 3,6,12 支持3期、6期、12期免息 videos Video [] 商品视频列表(目前只支持单个视频关联)。fields中只设置video可以返回Video结构体中所有字段，如果设置为video.id、video.video_id、video.url等形式就只会返回相应的字段 └ id Number 123456 视频关联记录的id，和商品相对应 └ video_id Number 123456 video的id，对应于视频在淘秀的存储记录 └ url String http://js.tudouui.com/bin/taobaoisv/TaoBaoPlayer.swf…… video的url连接地址。淘秀里视频记录里面存储的url地址 mpic_video MpicVideo 宝贝主图视频数据结构 └ num_iid Number 1497217011 主图视频记录所关联的商品的数字id └ video_id Number 9527 主图视频的在淘视频中的ID └ video_pic String http://img02.taobaocdn.com/bao/uploaded/T14rGfFqJfXXXXXXXX.jpg 主图视频的缩略图URL └ video_status Number 0 主图视频的状态 └ video_duaration Number 9 主图视频的时长，单位：秒 item_wireless_imgs ItemImg [] ItemImg结构 └ url String http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg 图片链接地址 └ position Number 1 图片放在第几张（多图时可设置） └ id Number 1645920 商品图片的id，和商品相对应（主图id默认为0） vertical_imgs ItemImg [] ItemImg结构 └ url String http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg 图片链接地址 └ position Number 1 图片放在第几张（多图时可设置） └ id Number 1645920 商品图片的id，和商品相对应（主图id默认为0） item_rectangle_imgs ItemImg [] ItemImg结构 └ url String http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg 图片链接地址 └ position Number 1 图片放在第几张（多图时可设置）

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ItemsInsideListGetRequest req = new ItemsInsideListGetRequest();
req.setFields("num_iid,title,nick,pric");
req.setNumIids("123456,223456");
ItemsInsideListGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
ItemsInsideListGetRequest req = new ItemsInsideListGetRequest();
req.Fields = "num_iid,title,nick,pric";
req.NumIids = "123456,223456";
ItemsInsideListGetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new ItemsInsideListGetRequest;
$req->setFields("num_iid,title,nick,pric");
$req->setNumIids("123456,223456");
$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.items.inside.list.get' \
-d 'partner_id=apidoc' \
-d 'sign=7A226D90FC1AA2253AA5035324FCB841' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+07%3A04%3A40' \
-d 'v=2.0' \
-d 'fields=num_iid%2Ctitle%2Cnick%2Cpric' \
-d 'num_iids=123456%2C223456'

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

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

req.fields="num_iid,title,nick,pric"
req.num_iids="123456,223456"
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.items.inside.list.get");
add_param(pRequest,"fields","num_iid,title,nick,pric");
add_param(pRequest,"num_iids","123456,223456");
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.items.inside.list.get', {
	'fields':'num_iid,title,nick,pric',
	'num_iids':'123456,223456'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<items_inside_list_get_response>
    <items>
        <item>
            <iid>13232</iid>
            <detail_url>http://item.taobao.com/item.htm?id=4947813209</detail_url>
            <num_iid>1489161932</num_iid>
            <title>Google test item</title>
            <nick>tbtest561</nick>
            <type>fixed</type>
            <cid>132443</cid>
            <props>135255:344454</props>
            <desc>这是一个好商品</desc>
            <pic_url>http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg</pic_url>
            <num>8888</num>
            <list_time>2009-10-22 14:22:06</list_time>
            <delist_time>2000-01-01 00:00:00</delist_time>
            <stuff_status>new</stuff_status>
            <location>
                <state>浙江</state>
                <city>杭州</city>
            </location>
            <price>5.00</price>
            <post_fee>5.00</post_fee>
            <express_fee>5.00</express_fee>
            <ems_fee>5.00</ems_fee>
            <approve_status>onsale</approve_status>
            <postage_id>32</postage_id>
            <product_id>85883030</product_id>
            <auction_point>15</auction_point>
            <item_imgs>
                <item_img>
                    <id>1645920</id>
                    <url>http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg</url>
                    <position>1</position>
                </item_img>
            </item_imgs>
            <prop_imgs>
                <prop_img>
                    <id>1646146</id>
                    <url>http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg</url>
                    <properties>1627207:28326</properties>
                    <position>1</position>
                </prop_img>
            </prop_imgs>
            <skus>
                <sku>
                    <sku_id>123</sku_id>
                    <properties>1243:1215;5626:5125</properties>
                    <properties_name>20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性1:属性值1</properties_name>
                    <quantity>3</quantity>
                    <price>200.07</price>
                    <outer_id>12345</outer_id>
                    <barcode>6903244981002</barcode>
                    <with_hold_quantity>100</with_hold_quantity>
                </sku>
            </skus>
            <outer_id>34143554352</outer_id>
            <is_virtual>true</is_virtual>
            <is_taobao>true</is_taobao>
            <is_timing>true</is_timing>
            <props_name>20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;30606:112030:上市时间:2008年</props_name>
            <is_fenxiao>0</is_fenxiao>
            <template_id>123456</template_id>
            <global_stock_type>1</global_stock_type>
            <global_stock_country>美国</global_stock_country>
            <global_stock_delivery_place>1</global_stock_delivery_place>
            <global_stock_tax_free_promise>false</global_stock_tax_free_promise>
            <barcode>6903244981002</barcode>
            <sub_stock>1</sub_stock>
            <with_hold_quantity>12</with_hold_quantity>
            <sell_point>2013新款 时尚 前卫</sell_point>
            <support_charge_free>false</support_charge_free>
            <white_bg_image>/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg</white_bg_image>
            <charge_free_list>3,6,12</charge_free_list>
            <videos>
                <video>
                    <id>123456</id>
                    <video_id>123456</video_id>
                    <url>http://js.tudouui.com/bin/taobaoisv/TaoBaoPlayer.swf……</url>
                </video>
            </videos>
            <mpic_video>
                <num_iid>1497217011</num_iid>
                <video_id>9527</video_id>
                <video_pic>http://img02.taobaocdn.com/bao/uploaded/T14rGfFqJfXXXXXXXX.jpg</video_pic>
                <video_status>0</video_status>
                <video_duaration>9</video_duaration>
            </mpic_video>
            <item_wireless_imgs>
                <item_img>
                    <url>http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg</url>
                    <position>1</position>
                    <id>1645920</id>
                </item_img>
            </item_wireless_imgs>
            <vertical_imgs>
                <item_img>
                    <url>http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg</url>
                    <position>1</position>
                    <id>1645920</id>
                </item_img>
            </vertical_imgs>
            <item_rectangle_imgs>
                <item_img>
                    <url>http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg</url>
                    <position>1</position>
                </item_img>
            </item_rectangle_imgs>
        </item>
    </items>
</items_inside_list_get_response>

{
    "items_inside_list_get_response":{
        "items":{
            "item":[
                {
                    "iid":"13232",
                    "detail_url":"http:\/\/item.taobao.com\/item.htm?id=4947813209",
                    "num_iid":1489161932,
                    "title":"Google test item",
                    "nick":"tbtest561",
                    "type":"fixed",
                    "cid":132443,
                    "props":"135255:344454",
                    "desc":"这是一个好商品",
                    "pic_url":"http:\/\/img03.taobao.net\/bao\/uploaded\/i3\/T1HXdXXgPSt0JxZ2.8_070458.jpg",
                    "num":8888,
                    "list_time":"2009-10-22 14:22:06",
                    "delist_time":"2000-01-01 00:00:00",
                    "stuff_status":"new",
                    "location":{
                        "state":"浙江",
                        "city":"杭州"
                    },
                    "price":"5.00",
                    "post_fee":"5.00",
                    "express_fee":"5.00",
                    "ems_fee":"5.00",
                    "approve_status":"onsale",
                    "postage_id":32,
                    "product_id":85883030,
                    "auction_point":15,
                    "item_imgs":{
                        "item_img":[
                            {
                                "id":1645920,
                                "url":"http:\/\/img03.taobao.net\/bao\/uploaded\/i3\/T1HXdXXgPSt0JxZ2.8_070458.jpg",
                                "position":1
                            }
                        ]
                    },
                    "prop_imgs":{
                        "prop_img":[
                            {
                                "id":1646146,
                                "url":"http:\/\/img03.taobao.net\/bao\/uploaded\/i3\/T1HXdXXgPSt0JxZ2.8_070458.jpg",
                                "properties":"1627207:28326",
                                "position":1
                            }
                        ]
                    },
                    "skus":{
                        "sku":[
                            {
                                "sku_id":123,
                                "properties":"1243:1215;5626:5125",
                                "properties_name":"20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性1:属性值1",
                                "quantity":3,
                                "price":"200.07",
                                "outer_id":"12345",
                                "barcode":"6903244981002",
                                "with_hold_quantity":100
                            }
                        ]
                    },
                    "outer_id":"34143554352",
                    "is_virtual":true,
                    "is_taobao":true,
                    "is_timing":true,
                    "props_name":"20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;30606:112030:上市时间:2008年",
                    "is_fenxiao":0,
                    "template_id":"123456",
                    "global_stock_type":"1",
                    "global_stock_country":"美国",
                    "global_stock_delivery_place":"1",
                    "global_stock_tax_free_promise":false,
                    "barcode":"6903244981002",
                    "sub_stock":1,
                    "with_hold_quantity":12,
                    "sell_point":"2013新款 时尚 前卫",
                    "support_charge_free":false,
                    "white_bg_image":"\/i3\/T1HXdXXgPSt0JxZ2.8_070458.jpg",
                    "charge_free_list":"3,6,12",
                    "videos":{
                        "video":[
                            {
                                "id":123456,
                                "video_id":123456,
                                "url":"http:\/\/js.tudouui.com\/bin\/taobaoisv\/TaoBaoPlayer.swf……"
                            }
                        ]
                    },
                    "mpic_video":{
                        "num_iid":1497217011,
                        "video_id":9527,
                        "video_pic":"http:\/\/img02.taobaocdn.com\/bao\/uploaded\/T14rGfFqJfXXXXXXXX.jpg",
                        "video_status":0,
                        "video_duaration":9
                    },
                    "item_wireless_imgs":{
                        "item_img":[
                            {
                                "url":"http:\/\/img03.taobao.net\/bao\/uploaded\/i3\/T1HXdXXgPSt0JxZ2.8_070458.jpg",
                                "position":1,
                                "id":1645920
                            }
                        ]
                    },
                    "vertical_imgs":{
                        "item_img":[
                            {
                                "url":"http:\/\/img03.taobao.net\/bao\/uploaded\/i3\/T1HXdXXgPSt0JxZ2.8_070458.jpg",
                                "position":1,
                                "id":1645920
                            }
                        ]
                    },
                    "item_rectangle_imgs":{
                        "item_img":[
                            {
                                "url":"http:\/\/img03.taobao.net\/bao\/uploaded\/i3\/T1HXdXXgPSt0JxZ2.8_070458.jpg",
                                "position":1
                            }
                        ]
                    }
                }
            ]
        }
    }
}

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

开放平台

商品API

taobao.items.inside.list.get (批量获取商品信息，集团内部APPKEY使用)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ