新电影票房数据接口,替换之前的老接口,新接口的稳定性大大提高且提供更丰富的数据字段。
接口: 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