taobao.auction.zc.itemlist.pagequery (翻页查询标的物列表)

翻页查询机构对应标的物列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
proxy_nick String 必须 xxx机构 isv 授权的 机构名称
page Number 必须 1 页码
page_size Number 可选 40
  • 默认值:40
  • 单页条数,不填默认40,最大40
    mini_start_time_str String 可选 2020-09-23 10:00:00 拍品开拍时间区间开始 格式:yyyy-MM-dd HH:mm:ss
    max_start_time_str String 可选 2020-09-24 10:00:00 拍品开拍时间区间结束 格式:yyyy-MM-dd HH:mm:ss
    mini_end_time_str String 可选 2020-09-28 10:00:00 拍品结束时间区间开始 格式:yyyy-MM-dd HH:mm:ss
    max_end_time_str String 可选 2020-09-29 10:00:00 拍品结束时间区间结束 格式:yyyy-MM-dd HH:mm:ss
    location_code Number 可选 330101 区域code(国标6位)
    cat_id Number 可选 51231234 类目id
    query_child Boolean 可选 true
  • 默认值:false
  • 查询子机构数据

    响应参数

    名称 类型 示例值 描述
    result Result4Top 返回结果 返回结果(相同条件翻页数量上限5000条记录,超出的话无返回,请自行添加时间范围等限定条件后查询)
    • └ total_item
    • Number
    • 100
    • 总记录数
    • └ total_page
    • Number
    • 5
    • 总页数
    • └ error_code
    • String
    • isv.system-error
    • 错误码
    • └ page_size
    • Number
    • 40
    • 页大小
    • └ current_page
    • Number
    • 1
    • 当前页
    • item_list
    • T []
    • 标的物列表
    • 标的物列表
    • └ pc_detail_url
    • String
    • https://zc-item.taobao.com/auction/627348002456.htm
    • PC详情页面Url
    • └ auction_status
    • String
    • 0
    • 拍品状态(0:正在进行;1:即将开始;2:已结束;4: 中止 5:撤回)
    • └ auction_end
    • String
    • 2019.11.29 15:39:53
    • 结束时间
    • └ auction_start
    • String
    • 2019.11.28 15:39:53
    • 开拍时间
    • └ main_pic_url
    • String
    • ur地址
    • 主图地址
    • └ title
    • String
    • x市x路xxx房产
    • 标的物标题
    • └ item_id
    • Number
    • 625583140878
    • 标的物ID
    • └ start_price
    • Number
    • 23000000
    • 起拍价(单位:分)
    • └ location_code
    • Number
    • 330101
    • 区域code
    • └ cat_id
    • Number
    • 341414141
    • 类目id
    • └ full_address
    • String
    • 浙江省杭州市西湖区文一西路677号
    • 详细地址
    • └ apply_count
    • Number
    • 5
    • 报名人数
    • └ view_count
    • Number
    • 100
    • 围观次数
    • └ error_msg
    • String
    • 系统异常
    • 错误描述

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AuctionZcItemlistPagequeryRequest req = new AuctionZcItemlistPagequeryRequest();
    req.setProxyNick("xxx机构");
    req.setPage(1L);
    req.setPageSize(40L);
    req.setMiniStartTimeStr("2020-09-23 10:00:00");
    req.setMaxStartTimeStr("2020-09-24 10:00:00");
    req.setMiniEndTimeStr("2020-09-28 10:00:00");
    req.setMaxEndTimeStr("2020-09-29 10:00:00");
    req.setLocationCode(330101L);
    req.setCatId(51231234L);
    req.setQueryChild(true);
    AuctionZcItemlistPagequeryResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <auction_zc_itemlist_pagequery_response>
        <result>
            <total_item>100</total_item>
            <total_page>5</total_page>
            <error_code>isv.system-error</error_code>
            <page_size>40</page_size>
            <current_page>1</current_page>
            <item_list>
                <t>
                    <pc_detail_url>https://zc-item.taobao.com/auction/627348002456.htm</pc_detail_url>
                    <auction_status>0</auction_status>
                    <auction_end>2019.11.29 15:39:53</auction_end>
                    <auction_start>2019.11.28 15:39:53</auction_start>
                    <main_pic_url>ur地址</main_pic_url>
                    <title>x市x路xxx房产</title>
                    <item_id>625583140878</item_id>
                    <start_price>23000000</start_price>
                    <location_code>330101</location_code>
                    <cat_id>341414141</cat_id>
                    <full_address>浙江省杭州市西湖区文一西路677号</full_address>
                    <apply_count>5</apply_count>
                    <view_count>100</view_count>
                </t>
            </item_list>
            <error_msg>系统异常</error_msg>
        </result>
    </auction_zc_itemlist_pagequery_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

    返回
    顶部