使用Tushare获取电影票房数据的完整指南

原创于 2025-06-03 09:02:12 发布 · 427 阅读

CC 4.0 BY-SA版权

使用Tushare获取电影票房数据的完整指南

tushare waditu/tushare: Tushare 是一个面向 Python 的金融数据接口库，提供了获取中国股市及其他金融市场数据的服务，支持股票、期货、基金、债券等多种金融产品的实时及历史数据下载。项目地址: https://gitcode.com/gh_mirrors/tu/tushare

Tushare是一个强大的金融数据接口库，除了股票、基金等金融数据外，它还提供了丰富的电影票房数据接口。本文将详细介绍如何使用Tushare获取各种维度的电影票房数据，帮助投资者和数据分析师了解电影市场动态。

一、Tushare电影票房数据概述

Tushare的电影票房数据来源于CBO中国票房，提供了多种维度的数据接口：

实时票房数据：30分钟更新一次，反映当前电影市场热度
每日票房数据：提供单日电影票房排行及详细指标
月度票房数据：按月统计的电影票房排行
影院日度票房：全国影院单日票房排行

这些数据对于电影行业分析、投资决策和市场研究具有重要价值。

二、实时票房数据获取与分析

实时票房数据是了解当前电影市场最直接的窗口，特别适合追踪热门影片的表现。

2.1 获取实时票房数据

import tushare as ts

# 获取实时票房数据
df = ts.realtime_boxoffice()
print(df)

2.2 数据字段说明

| 字段名 | 说明 | 示例值 | |--------|------|--------| | BoxOffice | 实时票房（万元） | 4181.05 | | Irank | 排名 | 1 | | MovieName | 影片名 | "寻龙诀" | | boxPer | 票房占比（%） | 33.51 | | movieDay | 上映天数 | 10 | | sumBoxOffice | 累计票房（万元） | 115703.45 | | time | 数据获取时间 | "2015-12-27 13:07:05" |

2.3 数据分析应用

实时票房数据可以用于：

追踪热门电影的市场表现
分析排片与票房的关系
预测电影最终票房潜力
评估电影营销效果

三、每日票房数据获取与分析

每日票房数据提供了更全面的单日电影市场表现指标。

3.1 获取每日票房数据

# 获取上一日数据
df = ts.day_boxoffice()

# 获取指定日期数据
df = ts.day_boxoffice('2023-01-01')

3.2 数据字段说明

| 字段名 | 说明 | 示例值 | |--------|------|--------| | AvgPrice | 平均票价 | 30 | | AvpPeoPle | 场均人次 | 66 | | BoxOffice | 单日票房（万元） | 12251 | | BoxOffice_Up | 环比变化（%） | -12 | | IRank | 排名 | 1 | | MovieDay | 上映天数 | 3 | | MovieName | 影片名 | "恶棍天使" | | SumBoxOffice | 累计票房（万元） | 41998 | | WomIndex | 口碑指数 | 5.98 |

3.3 数据分析应用

每日票房数据可以用于：

分析电影生命周期曲线
评估电影口碑与票房的关系
比较不同电影的观众吸引力（场均人次）
研究票价策略对票房的影响

四、月度票房数据获取与分析

月度票房数据提供了更宏观的电影市场视角。

4.1 获取月度票房数据

# 获取上一月数据
df = ts.month_boxoffice()

# 获取指定月份数据
df = ts.month_boxoffice('2023-01')

4.2 数据字段说明

| 字段名 | 说明 | 示例值 | |--------|------|--------| | Irank | 排名 | 1 | | MovieName | 电影名称 | "007：幽灵党" | | WomIndex | 口碑指数 | 6.94 | | avgboxoffice | 平均票价 | 32 | | avgshowcount | 场均人次 | 29 | | box_pro | 月度占比（%） | 20.1 | | boxoffice | 单月票房（万元） | 53517 | | days | 月内天数 | 18 | | releaseTime | 上映日期 | "2015-11-13" |

4.3 数据分析应用

月度票房数据可以用于：

分析月度电影市场格局
研究不同类型电影的市场表现
评估档期对电影票房的影响
比较国内外电影的竞争力

五、影院日度票房数据获取与分析

影院票房数据提供了微观层面的市场表现。

5.1 获取影院日度票房数据

# 获取上一日数据
df = ts.day_cinema()

# 获取指定日期数据
df = ts.day_cinema('2023-01-01')

5.2 数据字段说明

| 字段名 | 说明 | 示例值 | |--------|------|--------| | Attendance | 上座率（%） | 88.30 | | AvgPeople | 场均人次 | 196.04 | | CinemaName | 影院名称 | "北京星美国际影城（金源店）" | | RowNum | 排名 | 1 | | TodayAudienceCount | 当日观众人数 | 16271 | | TodayBox | 当日票房 | 861625.00 | | TodayShowCount | 当日场次 | 83 | | price | 场均票价（元） | 52.95 |