淘宝开放平台 - 文档中心

请求地址：

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

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

名称	类型	示例值	描述
items	Item []		Item(商品)结构
└ iid String 569a64fce2e98bce187bcbbb4a4d262a 商品id(注意：iid近期即将废弃，请用num_iid参数) └ detail_url String http://item.taobao.com/auction/item_detail.htm?xid=0db2&item_num_id=46418&cm_cat=559372&pm2=1 商品url └ num_iid Number 1489161932 商品数字id └ title String Google test item 商品标题,不能超过60字节 └ nick String tbtest561 卖家昵称 └ type String fixed 商品类型(fixed:一口价;auction:拍卖)注：取消团购 └ cid Number 132443 商品所属的叶子类目 id └ seller_cids String 2234445,3344466,446434 商品所属的店铺内卖家自定义类目列表 └ props String 135255:344454 商品属性格式：pid:vid;pid:vid └ input_pids String 2432,5353,656425 用户自行输入的类目属性ID串。结构："pid1,pid2,pid3"，如："20000"（表示品牌）注：通常一个类目下用户可输入的关键属性不超过1个。 └ input_str String 耐克;耐克系列;科比系列;科比系列;2K5 用户自行输入的子属性名和属性值，结构:"父属性值;一级子属性名;一级子属性值;二级子属性名;自定义输入值,....",如：“耐克;耐克系列;科比系列;科比系列;2K5”，input_str需要与input_pids一一对应，注：通常一个类目下用户可输入的关键属性不超过1个。所有属性别名加起来不能超过 3999字节。 └ pic_url String http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg 商品主图片地址 └ stuff_status String new 商品新旧程度(全新:new，闲置:unused，二手：second) └ price Price 5.00 商品价格，格式：5.00；单位：元；精确到：分 └ approve_status String onsale 商品上传后的状态。onsale出售中，instock库中 └ product_id Number 85883030 宝贝所属产品的id(可能为空). 该字段可以通过taobao.products.search 得到 └ auction_point Number 15 返点比例 └ property_alias String property 属性值别名 item_imgs ItemImg [] 商品图片列表(包括主图)。fields中只设置item_img可以返回ItemImg结构体中所有字段，如果设置为item_img.id、item_img.url、item_img.position等形式就只会返回相应的字段 └ 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等形式就只会返回相应的字段 └ 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…… └ price String 200.07 属于这个sku的商品的价格取值范围:0-100000000;精确到2位小数;单位:元。如:200.07，表示:200元7分。 └ outer_id String 12345 商家设置的外部id。天猫和集市的卖家，需要登录才能获取到自己的商家编码，不能获取到他人的商家编码。 └ barcode String 6903244981002 商品级别的条形码 └ promoted_price String 128.99 商品SKU优惠价格 └ pic_url String http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg SKU图片 └ outer_id String 34143554352 商家外部编码(可与商家外部系统对接) └ is_virtual Boolean true 虚拟商品的状态字段 videos Video [] 商品视频列表(目前只支持单个视频关联)。fields中只设置video可以返回Video结构体中所有字段，如果设置为video.id、video.video_id、 video.url等形式就只会返回相应的字段 └ url String http://js.tudouui.com/bin/taobaoisv/TaoBaoPlayer.swf…… video的url连接地址。淘秀里视频记录里面存储的url地址 └ created Date 2000-01-01 00:00:00 视频关联记录创建时间（格式：yyyy-MM-dd HH:mm:ss） └ modified Date 2000-01-01 00:00:00 视频关联记录修改时间（格式：yyyy-MM-dd HH:mm:ss） └ second_kill String web_only 秒杀商品类型。打上秒杀标记的商品，用户只能下架并不能再上架，其他任何编辑或删除操作都不能进行。如果用户想取消秒杀标记，需要联系小二进行操作。如果秒杀结束需要自由编辑请联系活动负责人（小二）去掉秒杀标记。可选类型 web_only(只能通过web网络秒杀) wap_only(只能通过wap网络秒杀) web_and_wap(既能通过web秒杀也能通过wap秒杀) └ 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#") └ barcode String 6903244981002 商品级别的条形码 └ promoted_price String 128.99 商品优惠价格 └ main_pic34 String http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg 商品3:4比例主图 └ upright_image_url String http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg 商品竖图

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

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

XML示例
JSON示例

<miniapp_items_get_response>
    <items>
        <item>
        </item>
    </items>
</miniapp_items_get_response>

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>

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

商品API

taobao.miniapp.items.get (批量获取商品信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ