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

获取商品公开属性,只允许在商家应用环境中使用

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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工具

    如何获得此API

    FAQ

    返回
    顶部