Tushare Pro 新版發布,數據更穩定質量更好,歡迎注冊使用。

通過網絡獲取國内當前實時票房和近期曆史電影票房數據,了解當下電影熱度和排片情況,尤其是上市公司投資出品的電影,可作為短期投資參考。目前主要包括以下類别:

  • 實時票房數據
  • 每日票房數據
  • 月度票房數據
  • 影院日度票房

數據來源:CBO中國票房

實時票房

獲取實時電影票房數據,30分鐘更新一次票房數據,可随時調用。

返回值說明:

  • BoxOffice 實時票房(萬)
  • Irank 排名
  • MovieName 影片名
  • boxPer 票房占比 (%)
  • movieDay 上映天數
  • sumBoxOffice 累計票房(萬)
  • time 數據獲取時間

調用方法:

import tushare as ts
df = ts.realtime_boxoffice()
print(df)

結果顯示:

    BoxOffice Irank MovieName boxPer  movieDay sumBoxOffice                 time
0    4181.05     1       尋龍訣  33.51       10    115703.45  2015-12-27 13:07:05
1    3494.63     2      惡棍天使  28.01        4     45492.15  2015-12-27 13:07:05
2    3294.41     3       老炮兒  26.41        4     21624.89  2015-12-27 13:07:05
3     816.58     4     唐人街探案   6.55       -3      2161.66  2015-12-27 13:07:05
4     162.08     5     萬萬沒想到   1.30       10     31496.95  2015-12-27 13:07:05
5      78.34     6      海綿寶寶   0.63       27      5582.76  2015-12-27 13:07:05
6      68.79     7   分手再說我愛你   0.55        4       472.51  2015-12-27 13:07:05
7      55.75     8   咕噜咕噜美人魚   0.45       16       842.81  2015-12-27 13:07:05
8      19.08     9     聖誕大赢家   0.15       16       499.34  2015-12-27 13:07:05
9      19.06    10      北京時間   0.15       17      2780.83  2015-12-27 13:07:05
10    286.41    11        其它   1.00        0         0.00  2015-12-27 13:07:05

每日票房

獲取單日電影票房數據,默認為上一日的電影票房,可輸入參數獲取指定日期的票房。

參數說明:

  • date: 日期(YYYY-MM-DD),默認為上一日

返回值說明:

  • AvgPrice 平均票價
  • AvpPeoPle 場均人次
  • BoxOffice 單日票房(萬)
  • BoxOffice_Up 環比變化 (%)
  • IRank 排名
  • MovieDay 上映天數
  • MovieName 影片名
  • SumBoxOffice 累計票房(萬)
  • WomIndex 口碑指數

調用方法:

import tushare as ts
df = ts.day_boxoffice() #取上一日的數據
#df = ts.day_boxoffice('2015-12-24')  #取指定日期的數據

結果顯示:

  AvgPrice AvpPeoPle BoxOffice BoxOffice_Up IRank MovieDay  MovieName  \
0       30        66     12251          -12     1        3       惡棍天使
1       38        71     10448           21     2        9        尋龍訣
2       31        63      6711           18     3        3        老炮兒
3       31        51      1284            0     4       -4      唐人街探案
4       32        21       500                  5       -5        小門神
5       30        17       285          -16     6        9      萬萬沒想到
6       31        28       135           -8     7        3    分手再說我愛你
7       40       125       101            2     8       16       北京時間
8       40       150        73           -3     9      338  老人,孩子和外國人
9       40       145        73            1    10     2186     這樣一位将軍
  SumBoxOffice WomIndex
0        41998     5.98
1       111522     8.74
2        18330     8.76
3         1345     8.38
4          574     8.40
5        31335     6.98
6          404     7.08
7         2762     7.48
8          285
9          288

月度票房

獲取單月電影票房數據,默認為上一月,可輸入月份參數獲取指定月度的數據。

參數說明:

  • date:年月(YYYY-MM),默認為上一月

返回值說明:

  • Irank 排名
  • MovieName 電影名稱
  • WomIndex 口碑指數
  • avgboxoffice 平均票價
  • avgshowcount 場均人次
  • box_pro 月度占比
  • boxoffice 單月票房(萬)
  • days 月内天數
  • releaseTime 上映日期

調用方法:

import tushare as ts
df = ts.month_boxoffice() #取上一月票房數據
#df = ts.month_boxoffice('2015-10') #取2015年10月的數據

結果顯示:

   Irank     MovieName      WomIndex avgboxoffice avgshowcount box_pro boxoffice  \
0      1       007:幽靈黨     6.94           32           29    20.1     53517
1      2          火星救援     8.47           36           32    12.6     33525
2      3        我的少女時代     8.05           28           30    10.1     26962
3      4     前任2:備胎反擊戰     7.08           30           19     9.4     25099
4      5         移動迷宮2     6.69           34           15     7.4     19674
5      6  饑餓遊戲3:嘲笑鳥(下)     6.84           34           17     5.2     13875
6      7          我是證人     7.95           32           13     4.9     13121
7      8     玩命速遞:重啟之戰     6.78           33           16     4.5     11997
8      9          絕命海拔     7.39           38           13     3.8     10215
9     10    陪安東尼度過漫長歲月     7.14           31           12     2.3      6234
10   999            其他                    32           11    19.4     51668
   days releaseTime
0    18  2015-11-13
1     6  2015-11-25
2    12  2015-11-19
3    25  2015-11-06
4    27  2015-11-04
5    11  2015-11-20
6    30  2015-10-30
7    11  2015-11-20
8    28  2015-11-03
9    18  2015-11-13
10

影院日度票房

獲取全國影院單日票房排行數據,默認為上一日,可輸入日期參數獲取指定日期的數據。

參數說明:

  • date:日期(YYYY-MM-DD),默認為上一日

返回值說明:

  • Attendance 上座率
  • AvgPeople 場均人次
  • CinemaName 影院名稱
  • RowNum 排名
  • TodayAudienceCount 當日觀衆人數
  • TodayBox 當日票房
  • TodayShowCount 當日場次
  • price 場均票價(元)

調用方法:

import tushare as ts
df = ts.day_cinema() #取上一日全國影院票房排行數據
#df = ts.day_cinema('2015-12-24') #取指定日期的數據
df.head(10)

結果顯示:

   Attendance AvgPeople         CinemaName          RowNum TodayAudienceCount  \
0   88.304569    196.04      北京星美國際影城(金源店)      1              16271
1   83.772203    184.69    Jackie Chan北京耀萊      2              18654
2   76.457680    133.04           上海星美正大影城      3              14634
3   75.949819    119.49           深圳橙天嘉禾影城      4              10635
4   91.889245    122.87            首都華融電影院      5              10321
5   75.675948    132.21       北京UME國際影城雙井店      6               8990
6   73.138902    164.40         北京萬達影城天通苑店      7               9864
7   71.210612    114.59          北京萬達影城通州店      8               8938
8   74.209964    145.82         上海萬達影城五角場店      9               9041
9   72.702934    147.59        北京UME華星國際影城     10               6789
 TodayBox TodayShowCount  price
0   861625.00             83  52.95
1   805823.00            101  43.20
2   667272.05            110  45.60
3   644203.00             89  60.57
4   598478.00             84  57.99
5   577094.73             68  64.19
6   560577.00             60  56.83
7   544697.00             78  60.94
8   542259.00             62  59.98
9   510590.44             46  75.21