Friends Data API独立数据服务

DECISION MODEL DATA · 娱乐与榜单

Box Office Mojo

北美票房汇总,以及独立提供方的影片周末票房。

API 调用说明

能回答的问题

  • 某周末北美总票房和冠军影片是什么?
  • 单部影片的周末票房与上映规模怎样?

状态与已知缺口

部分可用

仅覆盖本页列出的已取得数据;提供方的全部产品、历史期次及修订版本未全部覆盖。

  • 周末汇总与影片级票房不能混用
  • 其他地区及历史影片周末数据尚未全部覆盖,估算与修订口径可能不同

提供方

PRODUCT

Mojo 北美票房表

box_office_mojo_domestic_box_office

一条已取得票房表的原文记录;包含周末汇总及其他年度或影片表,先按表头和榜期识别口径再比较金额。

粒度
每行是一条提供方记录的观察版本;业务对象可跨快照重复
时间范围
未提供 ~ 未提供 · 原表标示年度或周末日期
采集时间
2026-10-04T07:55:25.949393Z ~ 2026-10-06T13:28:31.747269Z
记录数
5,823

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=box_office_mojo_domestic_box_office&limit=100

字段表 · 22 个字段

字段名中文说明
budget影片预算原文;缺失标记不转换为零
cells原表单元格及原文值;需结合表头解读
chart_title原文榜单标题,用于区分指标和榜种
column_headers提供方原表列标题,使用展示值时需与表头对应
dates周末日期段原文
display_text提供方原生字段;含义暂未补充。
genre影片类型原文
long_weekend是否为较长节假日周末
native_ordinal提供方原生字段;含义暂未补充。
native_period提供方原生字段;含义暂未补充。
native_product提供方原生字段;含义暂未补充。
native_row_attributes提供方原生字段;含义暂未补充。
native_row_html提供方原生字段;含义暂未补充。
number_one_release冠军影片标题
overall_change总票房变化展示值
overall_gross周末总票房展示金额
releases影片数量原文
running_time影片时长原文
top10_change前十合计票房变化展示值
top10_gross前十影片合计票房展示金额
week周次或榜单周日期,依原文格式
year_label原文年份及表格标题

PRODUCT

The Numbers 影片周末票房

box_office_mojo_numbers_weekend

一部影片在指定北美周末的票房记录,包含周末收入、累计收入、影院数和每院均值;与 Mojo 为不同提供方。

粒度
每行是一条提供方记录的观察版本;业务对象可跨快照重复
时间范围
2025-09-26 ~ 2025-09-26 · 原文周末日期标签
采集时间
2026-10-04T07:55:26.445363Z ~ 2026-10-04T07:55:26.445363Z
记录数
72

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=box_office_mojo_numbers_weekend&limit=100

字段表 · 10 个字段

字段名中文说明
days_release上映天数原文
gross当期票房展示金额
period_label提供方统计期原文
previous上期排名原文
rank原文名次;并列或非数值符号按原样保留
theater_average平均每院票房
theaters上映影院数量
title标题或名称
total_gross累计票房展示金额
weekly_change当期票房变化原文

数据观测时间 2026-10-06T17:38:47.854586Z