AkShare-另外数据-电影票房

数据科学实战

发布于 2020-10-29 11:32:49

7000

发布于 2020-10-29 11:32:49

文章被收录于专栏：数据科学实战数据科学实战

作者寄语

新电影票房数据接口，替换之前的老接口，新接口的稳定性大大提高且提供更丰富的数据字段。

更新接口

"movie_boxoffice_realtime" # 实时票房
"movie_boxoffice_daily" # 单日票房
"movie_boxoffice_weekly" # 单周票房
"movie_boxoffice_monthly" # 单月票房
"movie_boxoffice_yearly" # 年度票房
"movie_boxoffice_yearly_first_week" # 年度票房-年度首周票房
"movie_boxoffice_cinema_daily" # 影院票房-日票房排行
"movie_boxoffice_cinema_weekly" # 影院票房-周票房排行

电影票房

实时票房

接口: movie_boxoffice_realtime

目标地址: https://www.endata.com.cn/BoxOffice/BO/RealTime/reTimeBO.html

描述: 获取当前时刻的实时电影票房数据, 每 5 分钟更新一次数据, 实时票房包含今天未开映场次已售出的票房

限量: 当前时刻的实时票房数据

输入参数

名称	类型	必选	描述
-	-	-	-

输出参数

名称	类型	默认显示	描述
排序	float	Y	票房排名
影片名称	float	Y	-
实时票房	float	Y	注意单位: 万
票房占比	float	Y	注意单位: %
上映天数	float	Y	-
累计票房	float	Y	注意单位: 万

接口示例

import akshare as ak
movie_boxoffice_realtime_df = ak.movie_boxoffice_realtime()
print(movie_boxoffice_realtime_df)

数据示例

    排序    影片名称     实时票房   票房占比  上映天数       累计票房
0    1  我和我的家乡  1538.52  43.15    20  249064.58
1    2      喜宝   495.20  13.89     5    6385.52
2    3   一点就到家   426.22  11.95    17   24281.57
3    4      夺冠   420.24  11.79    26   77728.87
4    5     姜子牙   281.73   7.90    20  153707.79
5    6     急先锋   166.58   4.67    21   27109.02
6    7  七号房的礼物    81.22   2.28     6    1368.64
7    8      八佰    59.04   1.66    61  308789.71
8    9   掬水月在手    32.99   0.93     5     232.62
9   10    秀美人生    18.02   0.51    69    2313.17
10  11      其它    45.53   1.00     0       0.00

单日票房

接口: movie_boxoffice_daily

目标地址: https://www.endata.com.cn/BoxOffice/BO/Day/index.html

描述: 获取指定日期的电影票房数据, 每日 10:30, 12:30更新日票房，16:30 同时补充前 7 日票房

限量: 只能指定最近的日期

输入参数

名称	类型	必选	描述
date	str	Y	date="20201019"; 只能选择最近的日期

输出参数

名称	类型	默认显示	描述
排序	float	Y	票房排名
影片名称	float	Y	-
单日票房	float	Y	注意单位: 万
环比变化	float	Y	注意单位: %
累计票房	float	Y	注意单位: 万
平均票价	float	Y	注意单位: 元
场均人次	float	Y	-
口碑指数	float	Y	-
上映天数	float	Y	-

接口示例

import akshare as ak
movie_boxoffice_daily_df = ak.movie_boxoffice_daily(date="20201019")
print(movie_boxoffice_daily_df)

数据示例

   排序    影片名称  单日票房  环比变化    累计票房  平均票价  场均人次  口碑指数  上映天数
0   1  我和我的家乡  5593 -62.0  247526    38    19  0.00     6
1   2      喜宝  1332 -39.0    5890    37     4  5.47     6
2   3   一点就到家  1610 -60.0   23855    38    16  7.27     5
3   4      夺冠  1358 -62.0   77309    37    25  7.39     4
4   5     姜子牙  1898 -78.0  153426    38    19  6.81     3
5   6     急先锋   511 -50.0   26942    38    20  6.47     4
6   7  七号房的礼物   276 -61.0    1287    34     5  7.63     3
7   8      八佰   242 -59.0  308731    39    60  7.70     6
8   9   82号古宅    59 -29.0     272    29     4  0.00     3
9  10   掬水月在手    61 -39.0     200    39     4  0.00     4

单周票房

接口: movie_boxoffice_weekly

目标地址: https://www.endata.com.cn/BoxOffice/BO/Week/oneWeek.html

描述: 获取指定日期所在完整周的票房数据, 影片周票房数据初始更新周期为每周二，下周二补充数据

限量: 指定日期所在完整周的票房数据

输入参数

名称	类型	必选	描述
date	str	Y	date="20201018"; 指定日期所在周必须已经完整

输出参数

名称	类型	默认显示	描述
排序	float	Y	票房排名
影片名称	float	Y	-
排名变化	float	Y	-
单周票房	float	Y	注意单位: 万
环比变化	float	Y	注意单位: %
累计票房	float	Y	注意单位: 万
平均票价	float	Y	-
场均人次	float	Y	-
口碑指数	float	Y	-
上映天数	float	Y	-

接口示例

import akshare as ak
movie_boxoffice_weekly_df = ak.movie_boxoffice_weekly(date="20201018")
print(movie_boxoffice_weekly_df)

数据示例

   排序      影片名称  排名变化   单周票房 环比变化    累计票房  平均票价  场均人次  口碑指数  上映天数
0   1    我和我的家乡  9999  30706  -71  245412    38    11   NaN    18
1   2     一点就到家     2   8022  -35   23215    38     8  7.36    15
2   3       姜子牙    -1   7731  -82  153010    38     6  6.79    18
3   4        夺冠    -1   7430  -65   76799    38     7  7.39    24
4   5        喜宝     0   5074    0    5075    37    10  5.90     3
5   6       急先锋    -1   2756  -56   26685    38     5  6.49    19
6   7       天道王     0   2233    0    2233    31    29   NaN     4
7   8    七号房的礼物     0   1097    0    1178    34     6  7.63     4
8   9        八佰    -3   1075  -48  308630    38     7  7.70    59
9  10  2019阅兵盛典    -3    542  -56    2713    35    12   NaN    18

单月票房

接口: movie_boxoffice_monthly

目标地址: https://www.endata.com.cn/BoxOffice/BO/Month/oneMonth.html

描述: 获取指定日期所在月份的票房数据, 每月5号更新上月票房，并补充之前两个月票房

限量: 指定日期所在月份的票房数据, 只能获取最近月份的数据

输入参数

名称	类型	必选	描述
date	str	Y	date="20201019"; 输入具体的日期即可

输出参数

名称	类型	默认显示	描述
排序	float	Y	票房排名
影片名称	float	Y	-
单月票房	float	Y	注意单位: 万
月度占比	float	Y	注意单位: %
平均票价	float	Y	-
场均人次	float	Y	-
上映日期	float	Y	-
口碑指数	float	Y	-
月内天数	float	Y	-

接口示例

import akshare as ak
movie_boxoffice_monthly_df = ak.movie_boxoffice_monthly(date="20201019")
print(movie_boxoffice_monthly_df)

数据示例

     排序      影片名称    单月票房  月度占比  平均票价  场均人次        上映日期  口碑指数  月内天数
0     1    我和我的家乡  247491  47.7    39    27  2020-10-01   NaN  31.0
1     2       姜子牙  153396  29.6    40    24  2020-10-01  6.76  31.0
2     3        夺冠   49212   9.5    39    15  2020-09-25  7.39  31.0
3     4     一点就到家   23806   4.6    38    10  2020-10-04  7.39  28.0
4     5       急先锋   21172   4.1    38    11  2020-09-30  6.56  31.0
5     6        喜宝    5890   1.1    37     9  2020-10-16  5.69  16.0
6     7        八佰    4839   0.9    38    11  2020-08-21  7.70  31.0
7     8  2019阅兵盛典    2706   0.5    38    13  2020-10-01   NaN  31.0
8     9       天道王    2245   0.4    31    27  2020-10-15   NaN  17.0
9    10    七号房的礼物    1287   0.2    34     5  2020-10-15  7.63  17.0
10  999        其他    6612   1.3    38     9        None   NaN   NaN

年度票房

接口: movie_boxoffice_yearly

目标地址: https://www.endata.com.cn/BoxOffice/BO/Year/index.html

描述: 获取指定日期所在年度的票房数据

限量: 指定日期所在年度的票房数据, 只能获取最近年度的数据

输入参数

名称	类型	必选	描述
date	str	Y	date="20201019"; 输入具体的日期即可

输出参数

名称	类型	默认显示	描述
排序	float	Y	票房排名
影片名称	float	Y	-
类型	float	Y	-
总票房	float	Y	注意单位: 万
平均票价	float	Y	-
场均人次	float	Y	-
国家及地区	float	Y	-
上映日期	float	Y	-

接口示例

import akshare as ak
movie_boxoffice_yearly_df = ak.movie_boxoffice_yearly(date="20201019")
print(movie_boxoffice_yearly_df)

数据示例

    排序                 影片名称     类型     总票房  平均票价  场均人次    国家及地区        上映日期
0    1                   八佰     战争  308786    38  20.0       中国  2020-08-21
1    2               我和我的家乡     喜剧  248961    39  26.0       中国  2020-10-01
2    3                  姜子牙     动画  153689    40  22.0       中国  2020-10-01
3    4                   夺冠     剧情   77714    39  12.0       中国  2020-09-25
4    5                   宠爱     剧情   51060    35   7.0       中国  2019-12-31
5    6                   误杀     剧情   50225    32   8.0       中国  2019-12-13
6    7             我在时间尽头等你     爱情   50155    35  16.0       中国  2020-08-25
7    8                   信条     科幻   45348    39  10.0    美国/英国  2020-09-04
8    9              叶问4：完结篇     动作   41914    36   7.0  中国/中国香港  2019-12-20
9   10                  花木兰     剧情   27725    36   7.0    中国/美国  2020-09-11
10  11                  急先锋     动作   27095    38  10.0       中国  2020-09-30
11  12                一点就到家     剧情   24246    38   9.0       中国  2020-10-04
12  13            哈利·波特与魔法石  魔幻/动作   19155    35   9.0       英国  2002-01-31
13  14             多力特的奇幻冒险     喜剧   13597    32   7.0       美国  2020-07-24
14  15                 星际穿越     科幻   12148    30   8.0    美国/英国  2014-11-12
15  16                我为你牺牲     剧情   10673    75  32.0       中国  2019-12-05
16  17                 变身特工     动画   10352    35   6.0       美国  2020-01-03
17  18               1/2的魔法     动画    7043    32   8.0       美国  2020-08-19
18  19                 1917     战争    6896    32   5.0       美国  2020-08-07
19  20                   喜宝     剧情    6346    36   8.0       中国  2020-10-16
20  21                 美丽人生     剧情    5990    33   6.0      意大利  2020-01-03
21  22                 天使陷落     动作    5513    33   6.0       美国  2019-12-31
22  23                 荞麦疯长     剧情    5178    36  10.0       中国  2020-08-25
23  24  紫罗兰永恒花园外传：永远与自动手记人偶     剧情    4855    31   4.0       日本  2020-01-10
24  25                 鲨海逃生     灾难    4761    30   4.0    美国/英国  2020-01-10

年度首周票房

接口: movie_boxoffice_yearly_first_week

目标地址: https://www.endata.com.cn/BoxOffice/BO/Year/firstWeek.html

描述: 获取指定日期所在年度的年度首周票房数据

限量: 指定日期所在年度的年度首周票房数据, 只能获取最近年度的数据

输入参数

名称	类型	必选	描述
date	str	Y	date="20201019"; 输入具体的日期即可

输出参数

名称	类型	默认显示	描述
排序	float	Y	票房排名
影片名称	float	Y	-
类型	float	Y	-
首周票房	float	Y	注意单位: 万
占总票房比重	float	Y	注意单位: %
场均人次	float	Y	-
国家及地区	float	Y	-
上映日期	float	Y	-
首周天数	float	Y	-

接口示例

import akshare as ak
movie_boxoffice_yearly_first_week_df = ak.movie_boxoffice_yearly_first_week(date="20201019")
print(movie_boxoffice_yearly_first_week_df)

数据示例

   排序                 影片名称  类型  首周票房  占总票房比重  场均人次  国家及地区        上映日期  首周天数
0   1                 鲨海逃生  灾难  2473      52     5  美国/英国  2020-01-10     3
1   2  紫罗兰永恒花园外传：永远与自动手记人偶  剧情  2342      48     6     日本  2020-01-10     3
2   3                动物特工局  动画  1489      33     6  中国/法国  2020-01-11     2
3   4                 为家而战  动作  1364      79     3  美国/英国  2020-01-10     3
4   5                   灭绝  科幻   997      62    10     美国  2020-01-18     2
5   6                 别告诉她  剧情   205      50     5  美国/中国  2020-01-10     3
6   7                 致敬英雄  剧情   199      54     6     中国  2020-01-10     3
7   8                格萨尔藏戏  剧情     0       0     1     中国  2020-08-21  -186

影院票房-日票房排行

接口: movie_boxoffice_cinema_daily

目标地址: https://www.endata.com.cn/BoxOffice/BO/Cinema/day.html

描述: 获取指定日期的每日各影院的票房数据

限量: 指定日期各影院的票房数据, 注意当前日期的数据需要第二日才可以获取

输入参数

名称	类型	必选	描述
date	str	Y	date="20201019"; 输入具体的日期即可

输出参数

名称	类型	默认显示	描述
排序	float	Y	票房排名
影院名称	float	Y	-
单日票房	float	Y	注意单位: 元
单日场次	float	Y	-
场均人次	float	Y	-
场均票价	float	Y	-
上座率	float	Y	注意单位: %

接口示例

import akshare as ak
movie_boxoffice_cinema_daily_df = ak.movie_boxoffice_cinema_daily(date="20201018")
print(movie_boxoffice_cinema_daily_df)

数据示例

     排序          影院名称      单日票房  单日场次   场均人次   场均票价    上座率
0     1        上海沪北影院  67469.00    29  65.76  35.38  38.07
1     2  UME影城（北京华星店）  58378.88    43  24.00  56.57  12.65
2     3      北京寰映合生汇店  57332.69    55  16.22  64.27  12.19
3     4     南京新街口国际影城  55752.99    94  16.63  35.67  16.36
4     5      首都电影院西单店  52529.50    69  12.86  59.22   8.93
..  ...           ...       ...   ...    ...    ...    ...
95   96  UME影城（重庆渝中店）  28611.92    67  10.79  39.57   9.24
96   97    上海五角场万达广场店  28316.52    62   9.32  48.99   6.44
97   98        广州天河影城  28252.46    53  11.60  45.94   8.24
98   99    西安大明宫万达广场店  28237.09    47  14.72  40.81  11.44
99  100   金逸北京荟聚IMAX店  28207.52    57  10.16  48.72   5.37

影院票房-周票房排行

接口: movie_boxoffice_cinema_weekly

目标地址: https://www.endata.com.cn/BoxOffice/BO/Cinema/week.html

描述: 获取指定日期的完整周各影院的票房数据

限量: 指定日期的完整周各影院的票房数据, 注意当前日期的数据只能返回上周的数据

输入参数

名称	类型	必选	描述
date	str	Y	date="20201018"; 输入具体的日期即可

输出参数

名称	类型	默认显示	描述
排序	float	Y	票房排名
影院名称	float	Y	-
当周票房	float	Y	注意单位: 万
单银幕票房	float	Y	注意单位: 元
场均人次	float	Y	-
单日单厅票房	float	Y	-
单日单厅场次	float	Y	-

接口示例

import akshare as ak
movie_boxoffice_cinema_weekly_df = ak.movie_boxoffice_cinema_weekly(date="20201018")
print(movie_boxoffice_cinema_weekly_df)

数据示例

     排序            影院名称       当周票房    单银幕票房   场均人次    单日单厅票房  单日单厅场次
0     1        首都电影院西单店  793923.85  1640.34  26.73   8101.26    4.94
1     2        北京寰映合生汇店  659703.84  1731.51  26.83  10471.49    6.05
2     3        首都电影院昌平店  643233.44  1925.85  37.13   9189.05    4.77
3     4    广州飞扬影城（正佳分店）  600512.86  1547.71  27.45   9531.95    6.16
4     5    金逸北京大悦城IMAX店  597332.33  1866.66  26.62  10666.65    5.71
..  ...             ...        ...      ...    ...       ...     ...
95   96     华谊兄弟影城沈阳铁西店  354704.19   891.22  23.36   4222.67    4.74
96   97       郑州惠济万达广场店  354242.29   881.20  21.50   4217.17    4.79
97   98  海上明珠国际影城上海环球港店  352857.08  1326.53  25.32   6301.02    4.75
98   99        成都太平洋电影城  352743.53   803.52  22.03   2964.23    3.69
99  100       东莞东城万达广场店  350981.36   875.27  19.20   5014.02    5.73

本文参与腾讯云自媒体分享计划，分享自微信公众号。

原始发表：2020-10-21，如有侵权请联系 cloudcommunity@tencent.com 删除

https