淘宝开放平台

登录
文档中心 > API类目 > 司法拍卖

taobao.auction.gov.data.topn.get (根据不同维度，获取排行榜列表)

根据不同时间维度(周,月,年)，获取(成交额或发拍件数)排行榜列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
circle_type Number 必须 3 周期类型 （2：周，3：月，4：年）
circle Number 必须 201708 周期区间 周期（周填0、月份 yyyyMM、年份 yyyy)
busi_type Number 必须 1 业务类型 （1：成交额，2：发拍件数）
zone_type Number 必须 1 区域类型（1：全国，2：全省）
court_name String 必须 宁波北仑区法院 法院名称

响应参数

名称 类型 示例值 描述
ranks CourtsBidStatTopnDto [] 法院维度标的统计排行
  • └ rank
  • Number
  • 1
  • 排名
  • └ court_name
  • String
  • 宁波北仑区法院
  • 法院名称
  • └ hammer_price
  • Number
  • 0
  • 成交价（成交标的）
  • └ publish_count_dist
  • Number
  • 0
  • 发拍件数（去重）

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AuctionGovDataTopnGetRequest req = new AuctionGovDataTopnGetRequest();
req.setCircleType(3L);
req.setCircle(201708L);
req.setBusiType(1L);
req.setZoneType(1L);
req.setCourtName("宁波北仑区法院");
AuctionGovDataTopnGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
<auction_gov_data_topn_get_response>
    <ranks>
        <courts_bid_stat_topn_dto>
            <rank>1</rank>
            <court_name>宁波北仑区法院</court_name>
            <hammer_price>0</hammer_price>
            <publish_count_dist>0</publish_count_dist>
        </courts_bid_stat_topn_dto>
    </ranks>
</auction_gov_data_topn_get_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部