正在做影视类应用，想直观展示今天哪部电影最卖座？大盘总票房突破了多少？这个接口能帮你实时获取院线大盘和影片票房排名。
调用此接口，无需任何参数，即可获取当前实时的电影市场大盘数据（包含总票房、总场次、总人次），以及每一部上映影片的具体表现（包括票房明细、排片占比、上座率、场均人次和累计票房等）。
查询成功！返回实时大盘汇总及影片排行榜列表。
{
// 数据更新时间的格式化字符串
"update_time": "2026-05-06 13:39:12",
// 数据更新时间戳（毫秒）
"updated_at": 1778045952699,
// 上游数据刷新间隔（秒）
"update_gap_seconds": 5,
// 实时大盘汇总数据
"market": {
// 实时总票房，带单位
"box_office": "1232.7万",
// 实时分账票房，带单位
"split_box_office": "1232.7万",
// 实时总场次
"show_count": "37.0万",
// 实时总人次
"view_count": "35.0万"
},
// 影片排名列表
"list": [
{
// 排名，从 1 开始
"rank": 1,
// 影片 ID
"movie_id": 1528954,
// 影片名称
"movie_name": "消失的人",
// 上游上映信息原文
"release_info": "上映6天",
// 结构化上映状态，可取 released、preview、re_release 或 other
"release_status": "released",
// 已上映天数。仅当 release_info 可解析为“上映N天”时返回
"release_days": 6,
// 实时综合票房，带单位
"box_office": "444.67万",
// 实时综合票房占比
"box_office_rate": "36.0%",
// 实时分账票房，带单位
"split_box_office": "387.67万",
// 实时分账票房占比
"split_box_office_rate": "35.6%",
// 排片场次
"show_count": 106532,
// 排片占比
"show_count_rate": "28.8%",
// 场均人次
"avg_show_view": "1.2",
// 上座率
"avg_seat_view": "0.8%",
// 累计综合票房
"sum_box_office": "2.69亿",
// 累计分账票房
"sum_split_box_office": "2.35亿",
// 电影详情页 URL
"detail_url": "https://piaofang.maoyan.com/movie/1528954"
}
],
// 返回的影片数量
"total_items": 70
}上游实时票房数据不可用或发生拥堵。
{
"code": 503,
"message": "实时票房服务暂不可用，请稍后重试"
}选择你的语言查看调用示例
curl 'https://uapis.cn/api/v1/misc/movie-box-office'综合票房是观众买票时支付的总金额（包含了售票平台的网络售票服务费）；而分账票房是扣除服务费后，影院、院线和制片方等各方实际用于分成的净票房金额。
接口公共缓存时间为 10 秒。
可以。响应列表中的每部影片都附带 `detail_url` 字段，它是该影片在猫眼平台的详细资料链接，你可以在应用内提供点击跳转功能。