文档中心 > API类目 > 淘宝商品API

taobao.item.seller.get (获取单个商品详细信息)

公共参数

请求地址：

环境	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,price,approve_status,sku		需要返回的商品字段列表。可选值：Item商品结构体中所有字段均可返回，多个字段用“,”分隔。
num_iid	Number	必须	123456789		商品数字ID

响应参数

名称	类型	示例值	描述
item	Item		商品详细信息
└ after_sale_id Number 123 售后服务ID,该字段仅在taobao.item.get接口中返回 └ approve_status String onsale 商品上传后的状态。onsale出售中，instock库中 └ auction_point Number 15 商品的积分返点比例。如:5,表示:返点比例0.5% └ auto_fill String time_card 代充商品类型。在代充商品的类目下，不传表示不标记商品类型（交易搜索中就不能通过标记搜到相关的交易了）。可选类型： no_mark(不做类型标记) time_card(点卡软件代充) fee_card(话费软件代充) └ auto_repost Boolean true 自动重发,true/false └ barcode String 6903244981002 商品级别的条形码 └ cid Number 132443 商品所属的叶子类目 id └ cod_postage_id Number 53899 货到付款运费模板ID └ created Date 2000-01-01 00:00:00 Item的发布时间，目前仅供taobao.item.add和taobao.item.get可用 └ custom_made_type_id String 1 定制工具Id └ delist_time Date 2000-01-01 00:00:00 下架时间（格式：yyyy-MM-dd HH:mm:ss） └ desc String 这是一个好商品商品描述, 字数要大于5个字符，小于25000个字符 desc_module_info DescModuleInfo 宝贝描述规范化模块锚点信息 └ anchor_module_ids String 1,4,7 代表宝贝描述中规范化打标使用到的模块id列表，以逗号分隔。 └ type Number 1 类型代表规范化打标的类型：人工或自动化 └ detail_url String http://item.taobao.com/item.htm?id=4947813209 商品url └ ems_fee String 5.00 ems费用,格式：5.00；单位：元；精确到：分 └ express_fee String 5.00 快递费用,格式：5.00；单位：元；精确到：分 └ features String ;tags:3522,7234;source:sell;sp:2; 宝贝特征值，只有在Top支持的特征值才能保存到宝贝上 food_security FoodSecurity 食品安全信息，包括：生产许可证编号、产品标准号、厂名、厂址等 └ contact String 00800-021216 厂家联系方式 └ design_code String Q/DHL.001-2008 产品标准号 └ factory String 远东恒天然乳品有限公司厂名 └ factory_site String 台北市仁爱路4段85号厂址 └ food_additive String 磷脂、膨松剂食品添加剂 └ health_product_no String 卫食健字(1997)第167号健字号，保健品/膳食营养补充剂这个类目下特有的信息，此类目下无需填写生产许可证编号（QS），如果填写了生产许可证编号（QS）将被忽略不保存；保存宝贝时，标题前会自动加上健字号产品名称一起作为宝贝标题； └ mix String 有机乳糖、有机植物油配料表 └ period String 2年保质期 └ plan_storage String 常温储藏方法 └ prd_license_no String QS410006010388 生产许可证号 └ product_date_end String 2012-06-10 生产结束日期 └ product_date_start String 2012-06-01 生产开始日期 └ stock_date_end String 2012-06-30 进货结束日期，要在生产日期之后 └ stock_date_start String 2012-06-20 进货开始日期，要在生产日期之后 └ supplier String 深圳岸通商贸有限公司供货商 └ freight_payer String seller 运费承担方式,seller（卖家承担），buyer(买家承担） └ global_stock_country String 美国全球购商品采购地信息（地区/国家），代表全球购商品的产地信息。 └ global_stock_type String 1 全球购商品采购地信息（库存类型），有两种库存类型：现货和代购;参数值为1时代表现货，值为2时代表代购 └ has_discount Boolean true 支持会员打折,true/false └ has_invoice Boolean true 是否有发票,true/false └ has_showcase Boolean true 橱窗推荐,true/false └ has_warranty Boolean true 是否有保修,true/false └ increment String 0 加价幅度。如果为0，代表系统代理幅度。在竞拍中，为了超越上一个出价，会员需要在当前出价上增加金额，这个金额就是加价幅度。卖家在发布宝贝的时候可以自定义加价幅度，也可以让系统自动代理加价。系统自动代理加价的加价幅度随着当前出价金额的增加而增加，我们建议会员使用系统自动代理加价，并请买家在出价前看清楚加价幅度的具体金额。另外需要注意是，此功能只适用于拍卖的商品。以下是系统自动代理加价幅度表：当前价（加价幅度）1-40（ 1 ）、41-100（ 2 ）、101-200（5 ）、201-500 （10）、501-1001（15）、001-2000（25）、2001-5000（50）、5001-10000（100）10001以上 200 └ inner_shop_auction_template_id Number 2185480 用户内店宝贝装修模板id └ input_pids String 2432,5353,656425 用户自行输入的类目属性ID串。结构："pid1,pid2,pid3"，如："20000"（表示品牌）注：通常一个类目下用户可输入的关键属性不超过1个。 └ input_str String 耐克;耐克系列;科比系列;科比系列;2K5 用户自行输入的子属性名和属性值，结构:"父属性值;一级子属性名;一级子属性值;二级子属性名;自定义输入值,....",如：“耐克;耐克系列;科比系列;科比系列;2K5”，input_str需要与input_pids一一对应，注：通常一个类目下用户可输入的关键属性不超过1个。所有属性别名加起来不能超过 3999字节。 └ is_3D Boolean true 是否是3D淘宝的商品 └ is_ex Boolean true 是否在外部网店显示 └ is_fenxiao Number 0 普通商品:0;代销商品:1;经销商品:2;供销产品:3 └ is_lightning_consignment Boolean true 是否24小时闪电发货 └ is_prepay Boolean true 商品是否为先行赔付taobao.items.search和taobao.items.vip.search专用 └ is_taobao Boolean true 是否在淘宝显示 └ is_timing Boolean true 是否定时上架商品 └ is_virtual Boolean true 虚拟商品的状态字段 └ is_xinpin Boolean false 标示商品是否为新品。值含义：true-是，false-否。 item_imgs ItemImg [] 商品图片列表(包括主图)。fields中只设置item_img可以返回ItemImg结构体中所有字段，如果设置为item_img.id、item_img.url、item_img.position等形式就只会返回相应的字段 └ id Number 1645920 商品图片的id，和商品相对应（主图id默认为0） └ position Number 1 图片放在第几张（多图时可设置） └ url String http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg 图片链接地址 └ item_size String bulk:10 表示商品的体积，用于按体积计费的运费模板。该值的单位为立方米（m3）。该值支持两种格式的设置：格式1：bulk:3,单位为立方米(m3),表示直接设置为商品的体积。格式2：weight:10;breadth:10;height:10，单位为米（m） └ item_weight String 10 商品的重量，用于按重量计费的运费模板。注意：单位为kg └ list_time Date 2009-10-22 14:22:06 上架时间（格式：yyyy-MM-dd HH:mm:ss） locality_life LocalityLife {"packageid":"1234","obs":"1","network_id":"5645746","onsale_auto_refund_ratio":80,"refund_ratio":50,"verification":"1","merchant":"56879:码商X","choose_logis":"0","expirydate":"2012-08-06,2012-08-16","refundmafee":"b","eticket":";market:eticket;refundmafee:b;","version":"1"} 本地生活电子交易凭证业务，目前此字段只涉及到的信息为有效期:如果有效期为起止日期类型，此值为2012-08-06,2012-08-16如果有效期为【购买成功日至】类型则格式为2012-08-16如果有效期为天数类型则格式为3 └ choose_logis String 0 表示是否使用邮寄 0: 代表不使用邮寄； 1：代表使用邮寄；如果不设置这个值，代表不使用邮寄 └ eticket String ;market:eticket;refundmafee:b; 电子凭证业务属性 └ expirydate String 2012-08-06,2012-08-16 电子交易凭证有效期，有三种格式：如果有效期为起止日期类型，此值为2012-08-06,2012-08-16 如果有效期为【购买成功日至】类型则格式为2012-08-16如果有效期为天数类型则格式为15 └ merchant String 56879:码商X 格式为码商id:nick └ network_id String 5645746 网点ID,在参数empty_fields里设置locality_life.network_id可删除网点ID └ onsale_auto_refund_ratio Number 80 电子凭证售中自动退款比例 └ refund_ratio Number 50 退款比例，百分比%前的数字，1-100的正整数值；在参数empty_fields里设置locality_life.refund_ratio可删除退款比例 └ refundmafee String b 退款码费承担方。发布电子凭证宝贝的时候会增加“退款码费承担方”配置项，可选填：(1)s（卖家承担） (2)b(买家承担) └ verification String 1 核销打款:1代表核销打款,0代表非核销打款;在参数empty_fields里设置locality_life.verification可删除核销打款 location Location 商品所在地 └ city String 杭州所在城市（中文名称） └ state String 浙江所在省份（中文名称） └ modified Date 2000-01-01 00:00:00 商品修改时间（格式：yyyy-MM-dd HH:mm:ss） mpic_video MpicVideo 宝贝主图视频的数据信息，包括：视频ID，视频缩略图URL，视频时长，视频状态等信息。 └ num_iid Number 1497217011 主图视频记录所关联的商品的数字id └ video_duaration Number 9 主图视频的时长，单位：秒 └ video_id Number 9527 主图视频的在淘视频中的ID └ video_pic String http://img02.taobaocdn.com/bao/uploaded/T14rGfFqJfXXXXXXXX.jpg 主图视频的缩略图URL └ video_status Number 0 主图视频的状态 └ newprepay String 1 是否为新消保法中的7天无理由退货 └ nick String tbtest561 卖家昵称 └ num Number 8888 商品数量 └ num_iid Number 1489161932 商品数字id └ one_station Boolean true 是否淘1站商品 └ outer_id String 34143554352 商家外部编码(可与商家外部系统对接)。需要授权才能获取。 └ outer_shop_auction_template_id Number 2185481 用户外店装修模板id paimai_info PaimaiInfo {"interval":5,"deposit":20,"reserve":12,"valid_hour":20,"valid_minute":23,"mode":1} 用于保存拍卖有关的信息 └ deposit Number 20 用户自定义的固定保证金。如果用户未传则说明用户选择使用淘宝默认的保证金模式10%，此时deposit等于0. └ increment String 0 增价幅度或降价幅度 └ interval Number 5 降价拍中的降价间隔 └ mode Number 1 拍卖类型，目前包括增加拍，荷兰拍和降价拍。 └ reserve String 12.0 降价拍的保留价 └ valid_hour Number 20 对于拍卖来说可以设定有效期，这里是有效期的小时数。 └ valid_minute Number 23 对于拍卖来说可以设定有效期，这里是有效期的分钟数。 └ repeat Number 0 重复上拍总次数，如果不是重复上拍的，则为0 └ start Date 2000-01-01 00:00:00 拍品开始时间 └ end Date 2000-01-01 00:00:00 拍品结束时间 └ start_price Number 10 拍品起拍价 └ ceil_price Number 10 拍品封顶价（分） └ delay_in_minute Number 10 增加拍延迟周期（分钟） └ period Number 10 拍卖周期（秒钟），非重复上架为（开始时间-结束时间），当为重复上拍时为一次重复上架的时间 └ frequency Number 10 降价时间周期（分钟） └ period_sold_quantity Number 100 周期销售库存 └ pic_url String http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg 商品主图片地址 └ post_fee String 5.00 平邮费用,格式：5.00；单位：元；精确到：分 └ postage_id Number 32 宝贝所属的运费模板ID，如果没有返回则说明没有使用运费模板 └ price String 5.00 商品价格，格式：5.00；单位：元；精确到：分 └ product_id Number 85883030 宝贝所属产品的id(可能为空). 该字段可以通过taobao.products.search 得到 └ promoted_service String 2 消保类型，多个类型以,分割。可取以下值：2：假一赔三；4：7天无理由退换货；taobao.items.search和taobao.items.vip.search专用 prop_imgs PropImg [] 商品属性图片列表。fields中只设置prop_img可以返回PropImg结构体中所有字段，如果设置为prop_img.id、prop_img.url、prop_img.properties、prop_img.position等形式就只会返回相应的字段 └ id Number 1646146 属性图片的id，和商品相对应 └ position Number 1 图片放在第几张（多图时可设置） └ properties String 1627207:28326 图片所对应的属性组合的字符串 └ url String http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg 图片链接地址 └ property_alias String property 属性值别名,比如颜色的自定义名称 └ props String 135255:344454 商品属性格式：pid:vid;pid:vid └ 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#") └ score Number 2 商品所属卖家的信用等级数，1表示1心，2表示2心……，只有调用商品搜索:taobao.items.get和taobao.items.search的时候才能返回 └ second_kill String web_only 秒杀商品类型。打上秒杀标记的商品，用户只能下架并不能再上架，其他任何编辑或删除操作都不能进行。如果用户想取消秒杀标记，需要联系小二进行操作。如果秒杀结束需要自由编辑请联系活动负责人（小二）去掉秒杀标记。可选类型web_only(只能通过web网络秒杀)wap_only(只能通过wap网络秒杀)web_and_wap(既能通过web秒杀也能通过wap秒杀) └ sell_point String 2013新款时尚前卫商品卖点信息，天猫商家使用字段，最长150个字符。 └ sell_promise Boolean true 是否承诺退换货服务! └ seller_cids String 2234445,3344466,446434 商品所属的店铺内卖家自定义类目列表 skus Sku [] Sku列表。fields中只设置sku可以返回Sku结构体中所有字段，如果设置为sku.sku_id、sku.properties、sku.quantity等形式就只会返回相应的字段 └ barcode String 6903244981002 商品级别的条形码 └ created String 2009-11-04 15:24:43 sku创建日期时间格式：yyyy-MM-dd HH:mm:ss └ modified String 2009-11-04 15:24:43 sku最后修改日期时间格式：yyyy-MM-dd HH:mm:ss └ outer_id String 12345 商家设置的外部id。天猫和集市的卖家，需要登录才能获取到自己的商家编码，不能获取到他人的商家编码。 └ price String 200.07 属于这个sku的商品的价格取值范围:0-100000000;精确到2位小数;单位:元。如:200.07，表示:200元7分。 └ 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的商品的数量， └ sku_id Number 123 sku的id └ sold_quantity Number 8888 商品销量 └ stuff_status String new 商品新旧程度(全新:new，闲置:unused，二手：second) └ sub_stock Number 1 商品是否支持拍下减库存:1支持;2取消支持(付款减库存);0(默认)不更改集市卖家默认拍下减库存; 商城卖家默认付款减库存 └ template_id String 123456 页面模板id └ title String Google test item 商品标题,不能超过60字节 └ type String fixed 商品类型(fixed:一口价;auction:拍卖)注：取消团购 └ valid_thru Number 7 有效期,7或者14（默认是7天） └ video_id Number 9527 该字段废弃，请勿使用。 videos Video [] 商品视频列表(目前只支持单个视频关联)。fields中只设置video可以返回Video结构体中所有字段，如果设置为video.id、video.video_id、video.url等形式就只会返回相应的字段 └ created Date 2000-01-01 00:00:00 视频关联记录创建时间（格式：yyyy-MM-dd HH:mm:ss） └ id Number 123456 视频关联记录的id，和商品相对应 └ modified Date 2000-01-01 00:00:00 视频关联记录修改时间（格式：yyyy-MM-dd HH:mm:ss） └ url String http://js.tudouui.com/bin/taobaoisv/TaoBaoPlayer.swf…… video的url连接地址。淘秀里视频记录里面存储的url地址 └ video_id Number 123456 video的id，对应于视频在淘秀的存储记录 └ violation Boolean true 商品是否违规，违规：true , 不违规：false └ volume Number 22 对应搜索商品列表页的最近成交量,只有调用商品搜索:taobao.items.get和taobao.items.search的时候才能返回 └ wap_desc String Wap宝贝详情不带html标签的desc文本信息，该字段只在taobao.item.get接口中返回 └ wap_detail_url String http://auction1.wap.taobao.com/auction/item_detail-0db0-1234567.jhtml 适合wap应用的商品详情url ，该字段只在taobao.item.get接口中返回 └ wireless_desc String 无线宝贝描述，亲无线的宝贝描述 └ with_hold_quantity Number 12 预扣库存，即付款减库存的商品现在有多少处于未付款状态的订单 └ ww_status Boolean true 商品所属的商家的旺旺在线状况，taobao.items.search和taobao.items.vip.search专用 └ desc_modules String [{"module_id":123,"module_name":"模特图","type":"cat_mod","content":"模特要漂亮一点拜托"},{"module_id":null,"module_name":"店主最漂亮","type":"usr_mod","content":"老娘全网最美"}] 商品描述模块化，模块列表，由List转化成jsonArray存入，后端逻辑验证通过，拼装成模块内容+锚点导航后存入desc中。数据结构具体参见Item_Desc_Module cuntao_item_specific CuntaoItemSpecific 村淘特有商品级数据结构 └ kick_back_rate String 3.3即3.3% 村淘商品级佣金率 └ large_screen_image_url String i4/2054159008/TB2ixFaXXXXXXbrXXXXXXXXXXXX_!!2054159008.png 门店大屏图 └ is_area_sale Boolean true true:商品是区域限售商品；false:商品不是区域限售商品。 └ cpv_memo String 1627207:28320:绿叶繁花; 属性值的备注.格式:pid:vid:备注信息1;pid2:vid2:备注信息2; item_rectangle_imgs ItemImg [] 3:4主图 └ url String http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg 3:4主图url └ position Number 0 3:4主图的位置，范围 0-4 └ first_starts_time Date 2000-01-01 00:00:00 商品首次上架时间

请求示例

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ItemSellerGetRequest req = new ItemSellerGetRequest();
req.setFields("num_iid,title,nick,price,approve_status,sku");
req.setNumIid(123456789L);
ItemSellerGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

XML示例
JSON示例

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

<item_seller_get_response>
    <item>
        <after_sale_id>123</after_sale_id>
        <approve_status>onsale</approve_status>
        <auction_point>15</auction_point>
        <auto_fill>time_card</auto_fill>
        <auto_repost>true</auto_repost>
        <barcode>6903244981002</barcode>
        <cid>132443</cid>
        <cod_postage_id>53899</cod_postage_id>
        <created>2000-01-01 00:00:00</created>
        <custom_made_type_id>1</custom_made_type_id>
        <delist_time>2000-01-01 00:00:00</delist_time>
        <desc>这是一个好商品</desc>
        <desc_module_info>
            <anchor_module_ids>1,4,7</anchor_module_ids>
            <type>1</type>
        </desc_module_info>
        <detail_url>http://item.taobao.com/item.htm?id=4947813209</detail_url>
        <ems_fee>5.00</ems_fee>
        <express_fee>5.00</express_fee>
        <features>;tags:3522,7234;source:sell;sp:2;</features>
        <food_security>
            <contact>00800-021216</contact>
            <design_code>Q/DHL.001-2008</design_code>
            <factory>远东恒天然乳品有限公司</factory>
            <factory_site>台北市仁爱路4段85号</factory_site>
            <food_additive>磷脂 、膨松剂</food_additive>
            <health_product_no>卫食健字(1997)第167号</health_product_no>
            <mix>有机乳糖、有机植物油</mix>
            <period>2年</period>
            <plan_storage>常温</plan_storage>
            <prd_license_no>QS410006010388</prd_license_no>
            <product_date_end>2012-06-10</product_date_end>
            <product_date_start>2012-06-01</product_date_start>
            <stock_date_end>2012-06-30</stock_date_end>
            <stock_date_start>2012-06-20</stock_date_start>
            <supplier>深圳岸通商贸有限公司</supplier>
        </food_security>
        <freight_payer>seller</freight_payer>
        <global_stock_country>美国</global_stock_country>
        <global_stock_type>1</global_stock_type>
        <has_discount>true</has_discount>
        <has_invoice>true</has_invoice>
        <has_showcase>true</has_showcase>
        <has_warranty>true</has_warranty>
        <increment>0</increment>
        <inner_shop_auction_template_id>2185480</inner_shop_auction_template_id>
        <input_pids>2432,5353,656425</input_pids>
        <input_str>耐克;耐克系列;科比系列;科比系列;2K5</input_str>
        <is_3D>true</is_3D>
        <is_ex>true</is_ex>
        <is_fenxiao>0</is_fenxiao>
        <is_lightning_consignment>true</is_lightning_consignment>
        <is_prepay>true</is_prepay>
        <is_taobao>true</is_taobao>
        <is_timing>true</is_timing>
        <is_virtual>true</is_virtual>
        <is_xinpin>false</is_xinpin>
        <item_imgs>
            <item_img>
                <id>1645920</id>
                <position>1</position>
                <url>http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg</url>
            </item_img>
        </item_imgs>
        <item_size>bulk:10</item_size>
        <item_weight>10</item_weight>
        <list_time>2009-10-22 14:22:06</list_time>
        <locality_life>
            <choose_logis>0</choose_logis>
            <eticket>;market:eticket;refundmafee:b;</eticket>
            <expirydate>2012-08-06,2012-08-16</expirydate>
            <merchant>56879:码商X</merchant>
            <network_id>5645746</network_id>
            <onsale_auto_refund_ratio>80</onsale_auto_refund_ratio>
            <refund_ratio>50</refund_ratio>
            <refundmafee>b</refundmafee>
            <verification>1</verification>
        </locality_life>
        <location>
            <city>杭州</city>
            <state>浙江</state>
        </location>
        <modified>2000-01-01 00:00:00</modified>
        <mpic_video>
            <num_iid>1497217011</num_iid>
            <video_duaration>9</video_duaration>
            <video_id>9527</video_id>
            <video_pic>http://img02.taobaocdn.com/bao/uploaded/T14rGfFqJfXXXXXXXX.jpg</video_pic>
            <video_status>0</video_status>
        </mpic_video>
        <newprepay>1</newprepay>
        <nick>tbtest561</nick>
        <num>8888</num>
        <num_iid>1489161932</num_iid>
        <one_station>true</one_station>
        <outer_id>34143554352</outer_id>
        <outer_shop_auction_template_id>2185481</outer_shop_auction_template_id>
        <paimai_info>
            <deposit>20</deposit>
            <increment>0</increment>
            <interval>5</interval>
            <mode>1</mode>
            <reserve>12.0</reserve>
            <valid_hour>20</valid_hour>
            <valid_minute>23</valid_minute>
            <repeat>0</repeat>
            <start>2000-01-01 00:00:00</start>
            <end>2000-01-01 00:00:00</end>
            <start_price>10</start_price>
            <ceil_price>10</ceil_price>
            <delay_in_minute>10</delay_in_minute>
            <period>10</period>
            <frequency>10</frequency>
        </paimai_info>
        <period_sold_quantity>100</period_sold_quantity>
        <pic_url>http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg</pic_url>
        <post_fee>5.00</post_fee>
        <postage_id>32</postage_id>
        <price>5.00</price>
        <product_id>85883030</product_id>
        <promoted_service>2</promoted_service>
        <prop_imgs>
            <prop_img>
                <id>1646146</id>
                <position>1</position>
                <properties>1627207:28326</properties>
                <url>http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg</url>
            </prop_img>
        </prop_imgs>
        <property_alias>property</property_alias>
        <props>135255:344454</props>
        <props_name>20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;30606:112030:上市时间:2008年</props_name>
        <score>2</score>
        <second_kill>web_only</second_kill>
        <sell_point>2013新款 时尚 前卫</sell_point>
        <sell_promise>true</sell_promise>
        <seller_cids>2234445,3344466,446434</seller_cids>
        <skus>
            <sku>
                <barcode>6903244981002</barcode>
                <created>2009-11-04 15:24:43</created>
                <modified>2009-11-04 15:24:43</modified>
                <outer_id>12345</outer_id>
                <price>200.07</price>
                <properties>1243:1215;5626:5125</properties>
                <properties_name>20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性1:属性值1</properties_name>
                <quantity>3</quantity>
                <sku_id>123</sku_id>
            </sku>
        </skus>
        <sold_quantity>8888</sold_quantity>
        <stuff_status>new</stuff_status>
        <sub_stock>1</sub_stock>
        <template_id>123456</template_id>
        <title>Google test item</title>
        <type>fixed</type>
        <valid_thru>7</valid_thru>
        <video_id>9527</video_id>
        <videos>
            <video>
                <created>2000-01-01 00:00:00</created>
                <id>123456</id>
                <modified>2000-01-01 00:00:00</modified>
                <url>http://js.tudouui.com/bin/taobaoisv/TaoBaoPlayer.swf……</url>
                <video_id>123456</video_id>
            </video>
        </videos>
        <violation>true</violation>
        <volume>22</volume>
        <wap_desc>Wap宝贝详情</wap_desc>
        <wap_detail_url>http://auction1.wap.taobao.com/auction/item_detail-0db0-1234567.jhtml</wap_detail_url>
        <wireless_desc>无线宝贝描述，亲</wireless_desc>
        <with_hold_quantity>12</with_hold_quantity>
        <ww_status>true</ww_status>
        <desc_modules>[{&quot;module_id&quot;:123,&quot;module_name&quot;:&quot;模特图&quot;,&quot;type&quot;:&quot;cat_mod&quot;,&quot;content&quot;:&quot;模特要漂亮一点拜托&quot;},{&quot;module_id&quot;:null,&quot;module_name&quot;:&quot;店主最漂亮&quot;,&quot;type&quot;:&quot;usr_mod&quot;,&quot;content&quot;:&quot;老娘全网最美&quot;}]</desc_modules>
        <cuntao_item_specific>
            <kick_back_rate>3.3即3.3%</kick_back_rate>
        </cuntao_item_specific>
        <large_screen_image_url>i4/2054159008/TB2ixFaXXXXXXbrXXXXXXXXXXXX_!!2054159008.png</large_screen_image_url>
        <is_area_sale>true</is_area_sale>
        <cpv_memo>1627207:28320:绿叶繁花;</cpv_memo>
        <item_rectangle_imgs>
            <item_img>
                <url>http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg</url>
                <position>0</position>
            </item_img>
        </item_rectangle_imgs>
        <first_starts_time>2000-01-01 00:00:00</first_starts_time>
    </item>
</item_seller_get_response>

{
    "item_seller_get_response":{
        "item":{
            "after_sale_id":123,
            "approve_status":"onsale",
            "auction_point":15,
            "auto_fill":"time_card",
            "auto_repost":true,
            "barcode":"6903244981002",
            "cid":132443,
            "cod_postage_id":53899,
            "created":"2000-01-01 00:00:00",
            "custom_made_type_id":"1",
            "delist_time":"2000-01-01 00:00:00",
            "desc":"这是一个好商品",
            "desc_module_info":{
                "anchor_module_ids":"1,4,7",
                "type":1
            },
            "detail_url":"http:\/\/item.taobao.com\/item.htm?id=4947813209",
            "ems_fee":"5.00",
            "express_fee":"5.00",
            "features":";tags:3522,7234;source:sell;sp:2;",
            "food_security":{
                "contact":"00800-021216",
                "design_code":"Q\/DHL.001-2008",
                "factory":"远东恒天然乳品有限公司",
                "factory_site":"台北市仁爱路4段85号",
                "food_additive":"磷脂 、膨松剂",
                "health_product_no":"卫食健字(1997)第167号",
                "mix":"有机乳糖、有机植物油",
                "period":"2年",
                "plan_storage":"常温",
                "prd_license_no":"QS410006010388",
                "product_date_end":"2012-06-10",
                "product_date_start":"2012-06-01",
                "stock_date_end":"2012-06-30",
                "stock_date_start":"2012-06-20",
                "supplier":"深圳岸通商贸有限公司"
            },
            "freight_payer":"seller",
            "global_stock_country":"美国",
            "global_stock_type":"1",
            "has_discount":true,
            "has_invoice":true,
            "has_showcase":true,
            "has_warranty":true,
            "increment":"0",
            "inner_shop_auction_template_id":2185480,
            "input_pids":"2432,5353,656425",
            "input_str":"耐克;耐克系列;科比系列;科比系列;2K5",
            "is_3D":true,
            "is_ex":true,
            "is_fenxiao":0,
            "is_lightning_consignment":true,
            "is_prepay":true,
            "is_taobao":true,
            "is_timing":true,
            "is_virtual":true,
            "is_xinpin":false,
            "item_imgs":{
                "item_img":[
                    {
                        "id":1645920,
                        "position":1,
                        "url":"http:\/\/img03.taobao.net\/bao\/uploaded\/i3\/T1HXdXXgPSt0JxZ2.8_070458.jpg"
                    }
                ]
            },
            "item_size":"bulk:10",
            "item_weight":"10",
            "list_time":"2009-10-22 14:22:06",
            "locality_life":{
                "choose_logis":"0",
                "eticket":";market:eticket;refundmafee:b;",
                "expirydate":"2012-08-06,2012-08-16",
                "merchant":"56879:码商X",
                "network_id":"5645746",
                "onsale_auto_refund_ratio":80,
                "refund_ratio":50,
                "refundmafee":"b",
                "verification":"1"
            },
            "location":{
                "city":"杭州",
                "state":"浙江"
            },
            "modified":"2000-01-01 00:00:00",
            "mpic_video":{
                "num_iid":1497217011,
                "video_duaration":9,
                "video_id":9527,
                "video_pic":"http:\/\/img02.taobaocdn.com\/bao\/uploaded\/T14rGfFqJfXXXXXXXX.jpg",
                "video_status":0
            },
            "newprepay":"1",
            "nick":"tbtest561",
            "num":8888,
            "num_iid":1489161932,
            "one_station":true,
            "outer_id":"34143554352",
            "outer_shop_auction_template_id":2185481,
            "paimai_info":{
                "deposit":20,
                "increment":"0",
                "interval":5,
                "mode":1,
                "reserve":"12.0",
                "valid_hour":20,
                "valid_minute":23,
                "repeat":0,
                "start":"2000-01-01 00:00:00",
                "end":"2000-01-01 00:00:00",
                "start_price":10,
                "ceil_price":10,
                "delay_in_minute":10,
                "period":10,
                "frequency":10
            },
            "period_sold_quantity":100,
            "pic_url":"http:\/\/img03.taobao.net\/bao\/uploaded\/i3\/T1HXdXXgPSt0JxZ2.8_070458.jpg",
            "post_fee":"5.00",
            "postage_id":32,
            "price":"5.00",
            "product_id":85883030,
            "promoted_service":"2",
            "prop_imgs":{
                "prop_img":[
                    {
                        "id":1646146,
                        "position":1,
                        "properties":"1627207:28326",
                        "url":"http:\/\/img03.taobao.net\/bao\/uploaded\/i3\/T1HXdXXgPSt0JxZ2.8_070458.jpg"
                    }
                ]
            },
            "property_alias":"property",
            "props":"135255:344454",
            "props_name":"20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;30606:112030:上市时间:2008年",
            "score":2,
            "second_kill":"web_only",
            "sell_point":"2013新款 时尚 前卫",
            "sell_promise":true,
            "seller_cids":"2234445,3344466,446434",
            "skus":{
                "sku":[
                    {
                        "barcode":"6903244981002",
                        "created":"2009-11-04 15:24:43",
                        "modified":"2009-11-04 15:24:43",
                        "outer_id":"12345",
                        "price":"200.07",
                        "properties":"1243:1215;5626:5125",
                        "properties_name":"20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性1:属性值1",
                        "quantity":3,
                        "sku_id":123
                    }
                ]
            },
            "sold_quantity":8888,
            "stuff_status":"new",
            "sub_stock":1,
            "template_id":"123456",
            "title":"Google test item",
            "type":"fixed",
            "valid_thru":7,
            "video_id":9527,
            "videos":{
                "video":[
                    {
                        "created":"2000-01-01 00:00:00",
                        "id":123456,
                        "modified":"2000-01-01 00:00:00",
                        "url":"http:\/\/js.tudouui.com\/bin\/taobaoisv\/TaoBaoPlayer.swf……",
                        "video_id":123456
                    }
                ]
            },
            "violation":true,
            "volume":22,
            "wap_desc":"Wap宝贝详情",
            "wap_detail_url":"http:\/\/auction1.wap.taobao.com\/auction\/item_detail-0db0-1234567.jhtml",
            "wireless_desc":"无线宝贝描述，亲",
            "with_hold_quantity":12,
            "ww_status":true,
            "desc_modules":"[{\"module_id\":123,\"module_name\":\"模特图\",\"type\":\"cat_mod\",\"content\":\"模特要漂亮一点拜托\"},{\"module_id\":null,\"module_name\":\"店主最漂亮\",\"type\":\"usr_mod\",\"content\":\"老娘全网最美\"}]",
            "cuntao_item_specific":{
                "kick_back_rate":"3.3即3.3%"
            },
            "large_screen_image_url":"i4\/2054159008\/TB2ixFaXXXXXXbrXXXXXXXXXXXX_!!2054159008.png",
            "is_area_sale":true,
            "cpv_memo":"1627207:28320:绿叶繁花;",
            "item_rectangle_imgs":{
                "item_img":[
                    {
                        "url":"http:\/\/img03.taobao.net\/bao\/uploaded\/i3\/T1HXdXXgPSt0JxZ2.8_070458.jpg",
                        "position":0
                    }
                ]
            },
            "first_starts_time":"2000-01-01 00:00:00"
        }
    }
}

异常示例

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>

错误码解释

错误码	错误描述	解决方案
isv.missing-parameter:iid-or-numIid	参数：iid或numIid一个都没有传入	在前端对是否传入num_iid做好校验，必须传入num_iid
isv.invalid-permission:nick-and-item	商品ID与卖家昵称不匹配	输入num_iid就完全可以取得商品信息，nick只是可选，不确定的情况下请不要输入
isv.item-get-service-error:ITEM_NOT_FOUND	没有找到宝贝	1. 确认num_iid是否正确（建议通过taobao.items.onsale.get和taobao.items.inventory.get 获取num_iid）, 如果num_iid无误，则对应的宝贝可能已违规或进入历史库，在本地增加逻辑：发现报“ITEM_NOT_FOUND”错误就将本地的商品记录删除掉，防止卖家或者系统自动重试再次发生这个问题。2. 解决该问题，可以使用消息服务（http://open.taobao.com/doc/detail.htm?spm=0.0.0.0.ky0yHF&id=101663）功能，实时监控商品被删除的消息，及时把已删除商品从本地数据库中移除，保持数据同步。
isv.item-is-delete:invalid-numIid	商品id对应的商品已经被删除	程序做好控制，报错后禁止重试，并做相应提示。另可以使用消息服务（http://open.taobao.com/doc/detail.htm?spm=0.0.0.0.ky0yHF&id=101663）功能，实时监控商品被删除的消息，及时把已删除商品从本地数据库中移除，保持数据同步。
isv.invalid-permission:get-item	非商品所属的卖家无权查看仓库中的商品	不要查询别人的商品
isv.item-is-delete:invalid-numIid-or-iid	商品已经被删除	传入一个存在的商品ID
isv.invalid-permission	没有权限查看别人的商品	请确保传入的授权用户和商品所属用户一致
isv.item-get-service-error:IC_INTERFACE_QPS_LIMIT	系统繁忙,请稍后重试	系统繁忙,请稍后重试
isv.item-get-service-error:ITEM_QUERY_ERROR	系统异常	系统异常
isv.item-get-service-error:QUERY_USER_INFO_ERROR	系统错误，获取用户数据失败	系统错误，获取用户数据失败
isv.invalid-permission-tmall	参数错误	请检查传入参数
isv.item-get-service-error:ITEM_NOT_FOUND-tmall	商品找不到	请检查商品
isv.item-is-delete:invalid-numIid-or-iid-tmall	该商品已被删除	请检查商品是否正确，或者是否允许使用接口
isv.item-get-service-error:IC_INTERFACE_QPS_LIMIT-tmall	频率限制	控制请求频率
isp.top-remote-connection-timeout-tmall	请求超时	重试
isp.top-mapping-parse-error-tmall	传入的数字太长	确认参数的长度
isv.item-get-service-error:QUERY_USER_INFO_ERROR-tmall	系统错误，获取用户数据失败	系统错误，获取用户数据失败
isp.item-get-service-error-tmall	查询商品失败	请稍后重试
isv.item-not-exist:invalid-numIid-or-iid-tmall	商品不存在	请检查商品是否正确
isv.item-get-service-error:SYSTEM_ERROR	查询商品失败	请稍后重试
isp.service-unavailable-tmall	系统异常	请稍后重试
isv.item-not-exist:invalid-numIid-or-iid	商品不存在	请检查商品是否正确
isv.user-not-exist:invalid-nick-tmall	商品所属的用户不存在	请检查卖家账号情况
isv.item-get-service-error:GENERIC_FAILURE	系统异常	请稍后重试
isv.item-service-error:ITEM_NOT_FOUND-tmall	商品找不到	商品找不到
isv.item-service-error:ITEM_NOT_FOUND	商品找不到	商品找不到

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部