taobao.items.onsale.get.tmall (获取当前会话天猫用户出售中的商品列表)

获取当前用户作为卖家的出售中的商品列表,并能根据传入的搜索条件对出售中的商品列表进行过滤 只能获得商品的部分信息,商品的详细信息请通过taobao.item.get获取

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String 必须 num_iid,title,price 需返回的字段列表。可选值:Item商品结构体中的以下字段: approve_status,num_iid,title,nick,type,cid,pic_url,num,props,valid_thru,list_time,price,has_discount,has_invoice,has_warranty,has_showcase,modified,delist_time,postage_id,seller_cids,outer_id,sold_quantity ;字段之间用“,”分隔。不支持其他字段,如果需要获取其他字段数据,调用taobao.item.seller.get 获取。
q String 可选 N97 搜索字段。搜索商品的title。
cid Number 可选 1512 商品类目ID。ItemCat中的cid字段。可以通过taobao.itemcats.get取到
seller_cids String 可选 11 卖家店铺内自定义类目ID。多个之间用“,”分隔。可以根据taobao.sellercats.list.get获得.(注:目前最多支持32个ID号传入)
page_no Number 可选 10
  • 默认值:1
  • 页码。取值范围:大于零的整数。默认值为1,即默认返回第一页数据。用此接口获取数据时,当翻页获取的条数(page_no*page_size)超过10万,为了保护后台搜索引擎,接口将报错。所以请大家尽可能的细化自己的搜索条件,例如根据修改时间分段获取商品
    page_size Number 可选 100
  • 默认值:40
  • 每页条数。取值范围:大于零的整数;最大值:200;默认值:40。用此接口获取数据时,当翻页获取的条数(page_no*page_size)超过2万,为了保护后台搜索引擎,接口将报错。所以请大家尽可能的细化自己的搜索条件,例如根据修改时间分段获取商品
    order_by String 可选 list_time:desc
  • 默认值:list_time:desc
  • 排序方式。格式为column:asc/desc ,column可选值:list_time(上架时间),delist_time(下架时间),num(商品数量),modified(最近修改时间),sold_quantity(商品销量),;默认上架时间降序(即最新上架排在前面)。如按照上架时间降序排序方式为list_time:desc
    has_discount Boolean 可选 true 是否参与会员折扣。可选值:true,false。默认不过滤该条件
    has_showcase Boolean 可选 true 是否橱窗推荐。 可选值:true,false。默认不过滤该条件
    is_taobao Boolean 可选 true 商品是否在淘宝显示
    is_ex Boolean 可选 true 商品是否在外部网店显示
    start_modified Date 可选 2000-01-01 00:00:00 起始的修改时间
    end_modified Date 可选 2000-01-01 00:00:00 结束的修改时间
    is_cspu Boolean 可选 true 是否挂接了达尔文标准产品体系
    is_combine Boolean 可选 true 组合商品
    auction_type String 可选 a 商品类型:a-拍卖,b-一口价

    响应参数

    名称 类型 示例值 描述
    total_results Number 150 搜索到符合条件的结果总数
    items Item [] 搜索到的商品列表,具体字段根据设定的fields决定,不包括desc字段
    • └ approve_status
    • String
    • onsale
    • 商品上传后的状态。onsale出售中,instock库中
    • └ iid
    • String
    • 13232
    • 商品iid
    • └ 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
    • 商品所属的店铺内卖家自定义类目列表
    • └ pic_url
    • String
    • http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg
    • 商品主图片地址
    • └ num
    • Number
    • 8888
    • 商品数量
    • └ props
    • String
    • 135255:344454
    • 商品属性 格式:pid:vid;pid:vid
    • └ valid_thru
    • Number
    • 7
    • 有效期,7或者14(默认是7天)
    • └ list_time
    • Date
    • 2009-10-22 14:22:06
    • 上架时间(格式:yyyy-MM-dd HH:mm:ss)
    • └ price
    • String
    • 5.00
    • 商品价格,格式:5.00;单位:元;精确到:分
    • └ has_discount
    • Boolean
    • true
    • 支持会员打折,true/false
    • └ has_invoice
    • Boolean
    • true
    • 是否有发票,true/false
    • └ has_warranty
    • Boolean
    • true
    • 是否有保修,true/false
    • └ has_showcase
    • Boolean
    • true
    • 橱窗推荐,true/false
    • └ modified
    • Date
    • 2000-01-01 00:00:00
    • 商品修改时间(格式:yyyy-MM-dd HH:mm:ss)
    • └ delist_time
    • Date
    • 2000-01-01 00:00:00
    • 下架时间(格式:yyyy-MM-dd HH:mm:ss)
    • └ postage_id
    • Number
    • 32
    • 宝贝所属的运费模板ID,如果没有返回则说明没有使用运费模板
    • └ outer_id
    • String
    • 34143554352
    • 商家外部编码(可与商家外部系统对接)。需要授权才能获取。
    • └ is_ex
    • Boolean
    • true
    • 是否在外部网店显示
    • └ is_virtual
    • Boolean
    • true
    • 虚拟商品的状态字段
    • └ is_taobao
    • Boolean
    • true
    • 是否在淘宝显示
    • └ sold_quantity
    • Number
    • 8888
    • 商品销量
    • └ is_cspu
    • Boolean
    • true
    • 是否为达尔文挂接成功了的商品
    • └ 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);
    ItemsOnsaleGetTmallRequest req = new ItemsOnsaleGetTmallRequest();
    req.setFields("num_iid,title,price");
    req.setQ("N97");
    req.setCid(1512L);
    req.setSellerCids("11");
    req.setPageNo(10L);
    req.setPageSize(100L);
    req.setOrderBy("list_time:desc");
    req.setHasDiscount(true);
    req.setHasShowcase(true);
    req.setIsTaobao(true);
    req.setIsEx(true);
    req.setStartModified(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setEndModified(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setIsCspu(true);
    req.setIsCombine(true);
    req.setAuctionType("a");
    ItemsOnsaleGetTmallResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <items_onsale_get_tmall_response>
        <total_results>150</total_results>
        <items>
            <item>
                <approve_status>onsale</approve_status>
                <iid>13232</iid>
                <num_iid>1489161932</num_iid>
                <title>Google test item</title>
                <nick>tbtest561</nick>
                <type>fixed</type>
                <cid>132443</cid>
                <seller_cids>2234445,3344466,446434</seller_cids>
                <pic_url>http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg</pic_url>
                <num>8888</num>
                <props>135255:344454</props>
                <valid_thru>7</valid_thru>
                <list_time>2009-10-22 14:22:06</list_time>
                <price>5.00</price>
                <has_discount>true</has_discount>
                <has_invoice>true</has_invoice>
                <has_warranty>true</has_warranty>
                <has_showcase>true</has_showcase>
                <modified>2000-01-01 00:00:00</modified>
                <delist_time>2000-01-01 00:00:00</delist_time>
                <postage_id>32</postage_id>
                <outer_id>34143554352</outer_id>
                <is_ex>true</is_ex>
                <is_virtual>true</is_virtual>
                <is_taobao>true</is_taobao>
                <sold_quantity>8888</sold_quantity>
                <is_cspu>true</is_cspu>
                <first_starts_time>2000-01-01 00:00:00</first_starts_time>
            </item>
        </items>
    </items_onsale_get_tmall_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>

    错误码解释

    错误码 错误描述 解决方案
    isp.item-instant-search-service-unavailable 翻页获取的条数(page_no*page_size)超过2万,为了保护后台搜索引擎,接口报错 细化搜索条件,例如根据修改时间分段获取商品
    isv.invalid-parameter 缺少必要的传入参数 确定入参的正确性
    isv.user-not-exist:invalid-nick user 不存在 传入的nick找不到对应的用户记录,尽量通过接口获取nick来查询,并且定期更新自己的nick数据
    isv.invalid-parameter:gain-number-too-large-tmall 数字超过大小范围 确定数字格式正确性
    isp.service-unavailable-tmall 服务不可用 重试
    isp.top-remote-connection-timeout-tmall 接口响应超时 重试
    isv.user-not-exist:invalid-nick-tmall 用户信息不存在 确定用户的正确性

    API工具

    如何获得此API

    FAQ

    返回
    顶部