赛事前瞻有深度
AI 分析更客观

4.5 核心接口精讲①:赛事、赛程与今日总览

精讲
🕒 预计阅读:15 分钟 📅 更新时间:2026年11月09日 👁️ 17 次阅读 ✍️ 来源:球小策量化实验室
💡
提示:您当前为未登录状态,代码示例使用通用占位符展示。点击登录并免费领取 500 点体验金 后,所有代码将自动替换为您本人的专属 Key。
想知道每项数据覆盖了哪些赛事? 88 项赛事的数据项覆盖情况一览:赛程比分、首发阵容、球员与球队统计、进阶指标、伤停、天气等,每日自动统计并如实公开。 查看数据覆盖说明 →

赛程域是绝大多数分析的起点:先知道有什么比赛,再决定挖哪一场。这一篇讲清四个接口,以及一个新手最常用的场景——用竞彩编号找比赛。

一、今天有什么比赛怎么查?

接口 /today/digest(5 点)是选题第一站。它返回当天所有竞彩与北单场次,按开球时间升序排列。

它在 /fixtures 之外多给的东西,才是真正有用的部分:

字段 用途
lottery_id 展示编号,如「周四001」——用编号定位场次的唯一入口
lottery_code / lottery_code_beidan 竞彩 / 北单编号
pack_ready 单场全景包是否已就绪(决定你调用它时会不会遇到「生成中」)
report_status 该场是否已有官方研报(published / generatable / unavailable)
status_zh 中文状态,如「未开始」
# 今日赛事总览(5 点)
curl -s 'https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/today/digest' 
  -H 'X-API-Key: YOUR_API_KEY_HERE'

日期口径要注意:这个接口按「销售日」算,北京时间 11 点是日界线——11 点之前查到的「今天」其实是前一天。需要精确到自然日时,改用下面的 /fixtures?date=。

二、怎么按条件精确查赛程?

接口 /fixtures(2 点)是最便宜的数据接口之一,适合按条件筛选。

参数 说明
date 单日查询,格式 YYYY-MM-DD
from + to 区间查询,最长 31 天
team 按球队筛(主客皆可)
league / season 按联赛、赛季筛
status NS 未开始 / FT 已完赛 / LIVE 进行中
last / next 最近 N 场完赛 / 未来 N 场
lottery_type zucai 竞彩 / beidan 北单 / all
# 查某一天的赛程(2 点),顺便只看竞彩场次
curl -s 'https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/fixtures?date=2026-09-16&lottery_type=zucai' 
  -H 'X-API-Key: YOUR_API_KEY_HERE'

返回里最重要的字段是 fixture_id——后面所有单场数据都要用它。

三、只拿到竞彩编号,怎么找到比赛?

你手上只有「周四001」这样的编号,怎么定位到比赛?当天场次用 /today/digest,历史场次用 /fixtures?date=。

场景 做法 点数
今天的「周四001」是哪场? 调 /today/digest,在返回的 matches[] 里匹配 lottery_id 5
上周某天的编号场次 调 /fixtures?date=那天,匹配 lottery_code 2

💬 给个编号,帮我定位到比赛(复制发送) 赛程
我要查【周四001】这场比赛(如果是历史日期,请用【2026-09-16】这天的数据)。 请按下面三步做: 1. 用球小策数据接口定位这场比赛,告诉我:对阵双方、联赛、开球时间(北京时间)、当前状态; 2. 把这个场次的关键编号都列出来:fixture_id、竞彩编号、北单编号(没有的写「无」); 3. 告诉我这一场的单场数据包是否已经就绪(如果接口能给出这个状态)。 约束: - 如果编号匹配不到任何比赛,直接说「没找到」,并把当天实际存在的编号列出来让我核对,不要自己猜一场; - 定位到之后先停在这里,不要顺手把数据包也取了,等我确认。

四、单场详情与交锋历史怎么查?

/fixtures/{id}(2 点)给的是这场比赛的骨架:球场、主裁判、四段比分(半场 / 全场 / 加时 / 点球)、双方队名与队徽。当你只需要「几点开球、在哪踢、谁执法」时,用它最划算。

其中一个字段值得单独说:referee(主裁判姓名)。它是查裁判数据的第一步——拿到姓名后用 /referees?q=姓名 解析成 ID,再调 /referees/{id} 看执法尺度。

/h2h(5 点)给两队历史交锋:总场次、胜平负、双方进球、场均总进球、两队都进球的场次占比、大球小球的场次分布,以及逐场明细。

用交锋数据时有两个坑:① 交锋样本往往跨越很多年,阵容早已不同,只适合做背景铺垫,不适合作为判断依据;② 它返回的是历史结果,不包含任何对未来比赛的推断。写文章时要把「历史交锋如何」和「本场会怎样」明确分开。

五、赛事域的实战流程怎么走?

  1. 选题:/today/digest(5 点)看当天全部场次,挑出感兴趣的一场;
  2. 确认:/fixtures/{id}(2 点)核对开球时间、场地、裁判;
  3. 深挖:/match-pack/{id}(50 点)拿这一场的全维度数据(见 4.6);
  4. 补充:需要背景时再加 /h2h(5 点)。

一套完整流程 62 点,约 0.62 元。其中全景包占了 80%。

六、赛事域有什么成本优化技巧?

调全景包之前,先看 /today/digest 返回的 pack_ready 字段:

  • pack_ready 为真 → 直接调 /match-pack/{id},一次拿到完整数据;
  • pack_ready 为假 → 接口仍会返回一个基础快照,并告诉你完整包约 1 分钟后就绪,这一次不计费。你可以先做别的,稍后用 /tasks/{id}(0 点)确认就绪,再正式取包。

这样做的意义是:把「等数据」和「花点数」分开,避免在生成期间反复调用同一个接口。

下一步该看什么

常见问题

今天有什么比赛怎么查?
接口 /today/digest(5 点)是选题第一站。它返回当天所有竞彩与北单场次,按开球时间升序排列。 它在 /fixtures 之外多给的东西,才是真正有用的部分: 字段 用途 lottery_id 展示编号,如「周四001」——用编号定位场次的唯一入口 lottery_code / lottery_code_beidan 竞彩 / 北单编号 pack_ready 单场全…
怎么按条件精确查赛程?
接口 /fixtures(2 点)是最便宜的数据接口之一,适合按条件筛选。 参数 说明 date 单日查询,格式 YYYY-MM-DD from + to 区间查询,最长 31 天 team 按球队筛(主客皆可) league / season 按联赛、赛季筛 status NS 未开始 / FT 已完赛 / LIVE 进行中 last / next 最近 N 场完赛 / 未来…
只拿到竞彩编号,怎么找到比赛?
你手上只有「周四001」这样的编号,怎么定位到比赛?当天场次用 /today/digest,历史场次用 /fixtures?date=。 场景 做法 点数 今天的「周四001」是哪场? 调 /today/digest,在返回的 matches[] 里匹配 lottery_id 5 上周某天的编号场次 调 /fixtures?date=那天,匹配 lottery_code 2 💬…
单场详情与交锋历史怎么查?
/fixtures/{id}(2 点)给的是这场比赛的骨架:球场、主裁判、四段比分(半场 / 全场 / 加时 / 点球)、双方队名与队徽。当你只需要「几点开球、在哪踢、谁执法」时,用它最划算。 其中一个字段值得单独说:referee(主裁判姓名)。它是查裁判数据的第一步——拿到姓名后用 /referees?q=姓名 解析成 ID,再调 /referees/{id} 看执法尺度。…
赛事域的实战流程怎么走?
选题:/today/digest(5 点)看当天全部场次,挑出感兴趣的一场; 确认:/fixtures/{id}(2 点)核对开球时间、场地、裁判; 深挖:/match-pack/{id}(50 点)拿这一场的全维度数据(见 4.6); 补充:需要背景时再加 /h2h(5 点)。 一套完整流程 62 点,约 0.62 元。其中全景包占了 80%。
赛事域有什么成本优化技巧?
调全景包之前,先看 /today/digest 返回的 pack_ready 字段: pack_ready 为真 → 直接调 /match-pack/{id},一次拿到完整数据; pack_ready 为假 → 接口仍会返回一个基础快照,并告诉你完整包约 1 分钟后就绪,这一次不计费。你可以先做别的,稍后用 /tasks/{id}(0 点)确认就绪,再正式取包。 这样做的意义是…
免责声明

本栏目内容为足球数据分析方法的教学与科普,全部指标、模型与推演过程仅用于体育数据科学研究与信息展示,不构成任何形式的预测承诺,亦不涉及任何交易行为。文中「市场参考值」「参考值」等表述,均指公开可得的市场公开信息,仅用于说明数据比对方法。请读者遵守所在地区法律法规,理性认识竞技体育的偶然性。

🏠
赛事
📊
数据
🧩
功能
👤
我的

觉得文章有用就打赏一下文章作者

非常感谢你的打赏,我们将继续提供更多优质内容,让我们一起创建更加美好的网络世界!

微信扫一扫打赏

微信打赏二维码

登录

打开微信扫一扫,确认后自动完成登录