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

tmall.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 └ 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 增价幅度或降价幅度增价幅度或降价幅度 └ interval Number 5 降价拍中的降价间隔 └ mode Number 1 拍卖类型，目前包括增加拍，荷兰拍和降价拍。 └ reserve String 12.0 降价拍的保留价 └ valid_hour Number 20 对于拍卖来说可以设定有效期，这里是有效期的小时数。 └ valid_minute Number 23 对于拍卖来说可以设定有效期，这里是有效期的分钟数。 └ repeat Number 22 重复上拍总次数，如果不是重复上拍的，则为0 └ start Date 2022-11-11 拍品开始时间 └ end Date 2021-10-11 拍品结束时间 └ start_price Number 22 拍品起拍价 └ ceil_price Number 22 拍品封顶价（分） └ delay_in_minute Number 22 增加拍延迟周期（分钟） └ period Number 22 拍卖周期（秒钟），非重复上架为（开始时间-结束时间），当为重复上拍时为一次重复上架的时间 └ frequency Number 22 降价时间周期（分钟） └ 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 └ status String normal sku状态。 normal:正常；delete:删除；down_shelf:下架 sku_feature SkuFeature skuFeature └ color_hot_new String 热卖 colorHotNew └ color_material_img String 链接地址 colorMaterialImg └ color_value String FF1493 colorValue └ color_material String 哑光 colorMaterial └ color_series String 正红色 colorSeries └ 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:商品不是区域限售商品。 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 delivery_time DeliveryTime 发货时间信息 skus_delivery_time_list SkusDeliveryTime [] sku发货时间列表 └ sku_delivery_time String 10 sku发货时间 └ sku_id Number 12345 商品skuId └ delivery_time String 2013-11-11 商品级别设置的发货时间。设置了商品级别的发货时间，相对发货时间，则填写相对发货时间的天数（大于3）；绝对发货时间，则填写yyyy-mm-dd格式，如2013-11-11 └ deliver_time_type String absolute 发货时间类别，absolute：绝对时间(设置发货日期)，relative：相对时间(设置多少天后发货) └ need_delivery_time String none/item/sku 设置是否使用发货时间，商品级别，sku级别 └ cpv_memo String 1627207:28320:绿叶繁花; 属性备注 └ first_starts_time Date 2000-01-01 00:00:00 商品首次上架时间 └ spu_ids String 123456,67890 多SPU上对应的SPU ID auction_videos AuctionVideo [] 新商品主图视频 └ id Number 123 商品和视频的关联id └ video_id Number 123 视频id └ video_type String 宝贝讲解视频类型 └ audit_result String 审核通过审核结果 └ audit_reason String 无审核结果明细

请求示例

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

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

ITopClient client = new DefaultTopClient(url, appkey, secret);
TmallItemSellerGetRequest req = new TmallItemSellerGetRequest();
req.Fields = "num_iid,title,nick,price,approve_status,sku";
req.NumIid = 123456789L;
TmallItemSellerGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TmallItemSellerGetRequest;
$req->setFields("num_iid,title,nick,price,approve_status,sku");
$req->setNumIid("123456789");
$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=tmall.item.seller.get' \
-d 'partner_id=apidoc' \
-d 'session=9c618196-f6d9-4a43-9711-978062b27da5' \
-d 'sign=A2A3E1644A6D702106BF8DD871CD44CA' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-11-01+22%3A57%3A57' \
-d 'v=2.0' \
-d 'fields=num_iid%2Ctitle%2Cnick%2Cprice%2Capprove_status%2Csku' \
-d 'num_iid=123456789'

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

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

req.fields="num_iid,title,nick,price,approve_status,sku"
req.num_iid=123456789
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,"tmall.item.seller.get");
add_param(pRequest,"fields","num_iid,title,nick,price,approve_status,sku");
add_param(pRequest,"num_iid","123456789");
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('tmall.item.seller.get', {
	'fields':'num_iid,title,nick,price,approve_status,sku',
	'num_iid':'123456789'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

XML示例
JSON示例

<tmall_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>增价幅度或降价幅度</increment>
            <interval>5</interval>
            <mode>1</mode>
            <reserve>12.0</reserve>
            <valid_hour>20</valid_hour>
            <valid_minute>23</valid_minute>
            <repeat>22</repeat>
            <start>2022-11-11</start>
            <end>2021-10-11</end>
            <start_price>22</start_price>
            <ceil_price>22</ceil_price>
            <delay_in_minute>22</delay_in_minute>
            <period>22</period>
            <frequency>22</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>
                <status>normal</status>
                <sku_feature>
                    <color_hot_new>热卖</color_hot_new>
                    <color_material_img>链接地址</color_material_img>
                    <color_value>FF1493</color_value>
                    <color_material>哑光</color_material>
                    <color_series>正红色</color_series>
                </sku_feature>
            </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>
        <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>
        <delivery_time>
            <skus_delivery_time_list>
                <skus_delivery_time>
                    <sku_delivery_time>10</sku_delivery_time>
                    <sku_id>12345</sku_id>
                </skus_delivery_time>
            </skus_delivery_time_list>
            <delivery_time>2013-11-11</delivery_time>
            <deliver_time_type>absolute</deliver_time_type>
            <need_delivery_time>none/item/sku</need_delivery_time>
        </delivery_time>
        <cpv_memo>1627207:28320:绿叶繁花;</cpv_memo>
        <first_starts_time>2000-01-01 00:00:00</first_starts_time>
        <spu_ids>123456,67890</spu_ids>
        <auction_videos>
            <auction_video>
                <id>123</id>
                <video_id>123</video_id>
                <video_type>宝贝讲解</video_type>
                <audit_result>审核通过</audit_result>
                <audit_reason>无</audit_reason>
            </auction_video>
        </auction_videos>
    </item>
</tmall_item_seller_get_response>

{
    "tmall_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":"增价幅度或降价幅度",
                "interval":5,
                "mode":1,
                "reserve":"12.0",
                "valid_hour":20,
                "valid_minute":23,
                "repeat":22,
                "start":"2022-11-11",
                "end":"2021-10-11",
                "start_price":22,
                "ceil_price":22,
                "delay_in_minute":22,
                "period":22,
                "frequency":22
            },
            "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,
                        "status":"normal",
                        "sku_feature":{
                            "color_hot_new":"热卖",
                            "color_material_img":"链接地址",
                            "color_value":"FF1493",
                            "color_material":"哑光",
                            "color_series":"正红色"
                        }
                    }
                ]
            },
            "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,
            "item_rectangle_imgs":{
                "item_img":[
                    {
                        "url":"http:\/\/img03.taobao.net\/bao\/uploaded\/i3\/T1HXdXXgPSt0JxZ2.8_070458.jpg",
                        "position":0
                    }
                ]
            },
            "delivery_time":{
                "skus_delivery_time_list":{
                    "skus_delivery_time":[
                        {
                            "sku_delivery_time":"10",
                            "sku_id":12345
                        }
                    ]
                },
                "delivery_time":"2013-11-11",
                "deliver_time_type":"absolute",
                "need_delivery_time":"none\/item\/sku"
            },
            "cpv_memo":"1627207:28320:绿叶繁花;",
            "first_starts_time":"2000-01-01 00:00:00",
            "spu_ids":"123456,67890",
            "auction_videos":{
                "auction_video":[
                    {
                        "id":123,
                        "video_id":123,
                        "video_type":"宝贝讲解",
                        "audit_result":"审核通过",
                        "audit_reason":"无"
                    }
                ]
            }
        }
    }
}

异常示例

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"
	}
}

错误码解释

错误码	错误描述	解决方案
isv.item-is-delete:invalid-numIid-or-iid	商品已经被删除	传入一个存在的商品ID
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?&id=101663）功能，实时监控商品被删除的消息，及时把已删除商品从本地数据库中移除，保持数据同步。
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	系统错误，获取用户数据失败	系统错误，获取用户数据失败

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

淘宝开放平台

商品API

tmall.item.seller.get (获取一个天猫商品信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ