关于赛事数据，你问得最多的几件事

球员入口是最直接的一条路。输入姓名或球员编号，返回的是这名球员在所选阶段里的全部出场记录，替补登场的那几段用琥珀橙标在时间线上，首发与打满全场用青灰区分。我们被问得最多的 AOA替补贡献查询球员 用法，答案就落在这条时间线上。

想再收窄一点，可以叠上时间段条件，比如只看下半场，或者只看最后十五分钟，返回结果就只剩落在区间内的那几段。

能。三个条件叠加之后，返回的是同时满足全部条件的记录。比较常见的一种组合是：球队锁定一支队，时间段切到下半场，结果就是这支球队在下半场完成的每次换人，以及换人之后出现的那几个进球和失球。

如果叠加之后结果为空，先去掉一个条件再试一次，多半是某个条件把范围卡得太死了。

换成球队入口就行。返回的是这支队伍在当前阶段内的替补登场总分钟、换人次数，以及替补上场后参与的进球与失球，按主客场和上下半场分开列出。

俱乐部与青训分析人员常用这个入口做纵向对照，看同一支队伍在不同阶段的换人节奏有没有变化。

最常见的是三种情况：赛事编号少了几位或者多了一个空格；时间段与项目对不上，比如选了不包含该赛事的项目；或者这场赛事本身尚未纳入档案。去掉多余条件重新提交一次，通常就能看到结果。

确实找不到的，把赛事编号发到客服邮箱，我们帮你定位。

以球队为单位来统计，每一支球队的进球与失球各自记录发生时的比赛分钟。在此基础上再分两路看：一路是主场与客场，一路是上半场与下半场，两路可以交叉叠加。

如果你关心的是某支队伍在特定阶段的攻防变化，可以只取下半场、只看客场，这样得到的就是一支队客场下半场的进球与失球对比。

以替补球员实际进入场地的那个时间戳为起点，而不是换人指令给出的时刻。两者之间通常差不了多少，但在补时阶段偶尔会拉开一小段，这也是不同来源数字对不上的常见原因。

比赛结束后十分钟内，这一场的替补登场分钟会完成入库，并由编辑再过一遍，确认时间戳与画面一致。

一次换人对应一条节点记录，包含换人发生的比赛分钟、被换下与换上的球员编号、当时的比分，以及这次换人之后到下一个节点之间发生的进球与失球。

把同一场比赛的所有节点按分钟排开，就得到这条队伍的换人节奏线，媒体的战报写作用它来交叉比对阵容变化。

履历库收录了三千余名教练的执教球队与任期序列，能看出一个人先后带过哪些队、每一段大约跨了多少个阶段。序列之外的个人信息不在收录范围内，也不会出现在检索结果里。

把履历和球队的换人节奏放在一起看，是分析人员比较常用的一种读法。

进球或换人发生后十五秒内，页面上的比分和换人标记就会跟着更新。看直播的同时开着检索页，两边基本是同步的。

如果超过半分钟还没有变化，多半是网络缓存，刷新一次即可。

比赛结束后十分钟内，这一场的替补登场分钟就完成入库，编辑随后再确认一遍时间戳与节点顺序。也就是说，终场十分钟之后回来查，看到的基本就是可以用于成稿的版本。

需要引用到文章里的，建议再等上几分钟，避开入库与确认之间的那一小段窗口。

我们每年发布两个大版本与四个季度小版本。大版本用来扩展数据维度与检索方式，小版本主要打磨既有字段的读法、筛选组合与导出体验。

新维度上线后，历史档案里的旧条目会逐步补齐对应字段，不会只对新赛事生效。

把赛事编号、你认为有出入的字段，以及你手头的参照信息一起发到客服邮箱。有了编号，我们能直接定位到那一条记录，不用再靠描述去猜是哪一场。

如果是批量的问题，把涉及的编号整理成一行一个发过来就可以。

两个工作日内会给你反馈。处理流程是先由编辑回看那一场的原始记录，确认时间戳与节点顺序，再决定是否需要改动。

高峰期可能稍慢一些，超过两个工作日没收到回复，可以直接打客服电话催一下。

改动范围跟着问题走。如果是时间戳偏差，就修那条替补登场记录；如果节点顺序有问题，同场的换人序列会一起重排；涉及分布的，对应的统计结果会同步重算。

改动完成后，我们会把修正说明连同赛事编号一起回给你，方便你更新已经成稿的内容。

支持 CSV 与 JSON 两种。CSV 适合直接丢进表格做二次整理，JSON 保留了字段之间的层级关系，接进程序更省事。两种格式导出的字段是一致的，选哪种看你下游怎么用。

导出范围跟着你当前的筛选条件走，先筛后导，避免拿回一大堆用不上的条目。

三样东西：你这边要用的赛事范围，需要的字段清单，以及大概的调用频率。有了这三样，我们就能给出对应的接入方案与调用说明。

接入前建议先拿一份样例数据跑一遍，确认字段能对上你的数据结构，再正式对接。

帮助中心累计整理了一百二十余篇检索与字段说明文档，覆盖各字段的定义、取值示例和常见读法。导出文件里的字段名与文档中的名称一一对应，拿到文件对着看就行。

文档里没写清楚的，把字段名发到客服邮箱，我们会补上说明。

不需要。直接在数据工具页检索就能看到结果，按球员、球队、赛事编号和时间段四个入口定位替补贡献记录，不需要额外步骤。

想留存自己的筛选组合、或者需要更大批量地取数，再考虑账号的事。

机构客户可以拿到接口接入、批量导出的支持，以及按自己常用的赛事范围做定制说明文档。我们的合作方里既有体育媒体编辑部，也有俱乐部分析团队、数据服务商和院校研究组，各自的用法差别不小，方案会跟着场景调整。

目前已经与二十余家机构建立了内容合作，覆盖多个项目与联赛。

如果数据要实时进入你自己的产品界面，接口接入更合适；如果只是按阶段做一次汇总分析，按筛选条件导出 JSON 就够了。两种方式可以同时用，前期先用导出验证字段，稳定之后再切成接口。

拿不准的，把你要做的事情说一遍，我们帮你判断该走哪条。