文档中心 > API类目 > 淘票票数据平台

taobao.tpp.gravity.boxoffice.index (淘票票数据平台 大盘票房接口)

淘票票数据平台 大盘票房接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
city_id Number 必须 -5 -5:全国
page_size Number 必须 20 需要查询的数据量;如果是当天,该参数无效,根据服务端系统设置
end_date String 必须 20170704 开始日期,格式yyyyMMdd
date_type Number 必须 0 日期类型:0-日,1-周, 2-月; 3-季;4-年;5-档期;6-自定义
begin_date String 必须 20170704 结束日期,格式yyyyMMdd
need_service_fee Number 必须 1 是否需要服务费 0 不需要 1需要

响应参数

名称 类型 示例值 描述
result PlainResult result
  • └ message
  • String
  • hello world
  • message
  • └ error_message
  • String
  • 系统异常
  • errorMessage
  • └ ts
  • Number
  • 140000000000
  • 服务器时间,单位ms
  • data
  • BoxOfficeIndexVO
  • data
  • └ schedule_cnt
  • String
  • 233053
  • 大盘场次
  • └ latest_data_report_ts
  • String
  • 1496893051044
  • 数据更新时间
  • └ box_office
  • String
  • 6337290983
  • 大盘票房
  • show_data_item_list
  • ShowDataItemVOs []
  • 影片列表
  • └ opened_days
  • String
  • 12
  • 上映天数,上映后有值
  • └ show_name
  • String
  • 变形金刚5:最后的骑士
  • 影片名称
  • box_office_data_item
  • BoxOfficeDataItemVO
  • boxOfficeDataItem
  • └ schedule_rate
  • String
  • 0.33003
  • 场次占比
  • └ total_seat_cnt
  • String
  • 11555640
  • 总排座数
  • └ schedule_cnt
  • String
  • 76326
  • 场次
  • └ box_office
  • String
  • 2369845188
  • 票房
  • └ attend_rate
  • String
  • 0.05799
  • 上座率
  • └ prime_schedule_rate
  • String
  • 0.32414
  • 黄金时段上座率
  • └ sold_seat_cnt
  • String
  • 670094
  • 人次
  • └ seat_rate
  • String
  • 0.40823
  • 排座占比
  • └ box_office_rate
  • String
  • 0.37667
  • 票房占比
  • └ avg_ticket_price
  • String
  • 3536
  • 平均票价
  • └ show_date
  • String
  • 20170704
  • 上映日期
  • └ avg_schedule_sold_seat_cnt
  • String
  • 9
  • 场均人次
  • └ show_id
  • String
  • 178713
  • 影片id
  • └ total_box_office
  • String
  • 138824640425
  • 累计票房
  • └ open_day
  • String
  • 20170623
  • 上映日期
  • └ sold_seat_cnt
  • String
  • 1862127
  • 大盘人次
  • └ has_service_fee
  • String
  • 1
  • 是否含服务费
  • └ avg_ticket_price
  • String
  • 3403
  • 大盘平均票价
  • └ success
  • Boolean
  • true
  • success

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TppGravityBoxofficeIndexRequest req = new TppGravityBoxofficeIndexRequest();
req.setCityId(-5L);
req.setPageSize(20L);
req.setEndDate("20170704");
req.setDateType(0L);
req.setBeginDate("20170704");
req.setNeedServiceFee(1L);
TppGravityBoxofficeIndexResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tpp_gravity_boxoffice_index_response>
    <result>
        <message>hello world</message>
        <error_message>系统异常</error_message>
        <ts>140000000000</ts>
        <data>
            <schedule_cnt>233053</schedule_cnt>
            <latest_data_report_ts>1496893051044</latest_data_report_ts>
            <box_office>6337290983</box_office>
            <show_data_item_list>
                <show_data_item_v_os>
                    <opened_days>12</opened_days>
                    <show_name>变形金刚5:最后的骑士</show_name>
                    <box_office_data_item>
                        <schedule_rate>0.33003</schedule_rate>
                        <total_seat_cnt>11555640</total_seat_cnt>
                        <schedule_cnt>76326</schedule_cnt>
                        <box_office>2369845188</box_office>
                        <attend_rate>0.05799</attend_rate>
                        <prime_schedule_rate>0.32414</prime_schedule_rate>
                        <sold_seat_cnt>670094</sold_seat_cnt>
                        <seat_rate>0.40823</seat_rate>
                        <box_office_rate>0.37667</box_office_rate>
                        <avg_ticket_price>3536</avg_ticket_price>
                        <show_date>20170704</show_date>
                        <avg_schedule_sold_seat_cnt>9</avg_schedule_sold_seat_cnt>
                    </box_office_data_item>
                    <show_id>178713</show_id>
                    <total_box_office>138824640425</total_box_office>
                    <open_day>20170623</open_day>
                </show_data_item_v_os>
            </show_data_item_list>
            <sold_seat_cnt>1862127</sold_seat_cnt>
            <has_service_fee>1</has_service_fee>
            <avg_ticket_price>3403</avg_ticket_price>
        </data>
        <success>true</success>
    </result>
</tpp_gravity_boxoffice_index_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

返回
顶部