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

4.4 接口地图:46 个接口的分组导航与选型建议

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

这一篇是接口导航。不需要背,用的时候回来查就行。

一、按场景选接口:我该用哪个?

先用这张表定位,再跳到下面看参数。

我想做的事 用哪个接口 点数
今天有哪些比赛?有竞彩编号吗? /today/digest 5
某一天 / 某个联赛 / 某支球队的赛程 /fixtures 2
看一场比赛的全部维度 /match-pack/{id} 50
看已完赛的技术统计 / 事件 / 阵容 / 球员评分 /fixtures/{id}/stats|events|lineups|players 各 5
两队历史交锋 /h2h 5
一支球队的实力画像 /teams/{id}/advanced 10
一支球队的核心球员 /teams/{id}/players-advanced 10
伤停名单 /teams/{id}/injuries 5
某名球员的高阶指标 /players/{id}/advanced 3
积分榜 / 射手榜 / 助攻榜 /standings | /leagues/{id}/topscorers|topassists 3 / 5
市场参考值现在多少、有没有变化 /fixtures/{id}/quotes | /quotes/history | /market 各 5
转会记录 / 教练履历 / 裁判风格 /transfers | /coaches/{id} | /referees/{id} 5 / 3 / 3
预测准不准(复盘与命中率) /stats/overall | /stats/team | /review 5 / 5 / 10
官方研报全文 /posts/{id}(历史 25 / 当天 100);批量用 /posts 25 / 1000

还有一件重要的事:任何数据接口之前,几乎都要先拿一个数字 ID。球队用 /teams?q=队名,球员用 /players?q=姓名,联赛用 /leagues?q=名称,比赛用 /fixtures?date= 或 /today/digest。

二、46 个接口分别是什么?

按功能分成 8 组。点数已标注,方便你估算成本。

账户组有哪些接口?

接口 用途 点数
/quota 余额自查(含有效期与限流配置) 0

赛事与赛程组有哪些接口?

接口 用途 点数
/today/digest 今日赛事总览(含竞彩/北单编号) 5
/fixtures 比赛日程(按日期 / 联赛 / 球队筛选) 2
/fixtures/{id} 单场比赛详情(含球场、裁判、比分分段) 2
/fixtures/{id}/stats 单场技术统计 5
/fixtures/{id}/events 单场事件流(进球、换人、牌) 5
/fixtures/{id}/lineups 单场官方阵容与阵型 5
/fixtures/{id}/players 单场球员逐场统计与评分 5
/h2h 两队历史交锋 5

单场全景组有哪些接口?

接口 用途 点数
/match-pack/{id} 单场全景数据包(一次覆盖全部维度,内置市场波动) 50
/tasks/{id} 完整包生成进度查询 0

市场参考值组有哪些接口?

接口 用途 点数
/fixtures/{id}/quotes 市场参考值当前快照(含官方公开参考值) 5
/fixtures/{id}/quotes/history 市场参考值时间序列(含开盘与临场标记) 5
/fixtures/{id}/market 已识别的市场异动事件流 5

球队组有哪些接口?

接口 用途 点数
/teams?q= 球队搜索(拿 team_id) 2
/teams/{id} 球队详情(三字码、国家、球场、容量) 2
/teams/{id}/form 近期战绩(近 N 场逐场) 5
/teams/{id}/fixtures 逐场赛程历史(可按赛季 / 状态筛) 3
/teams/{id}/statistics 赛季统计(进失球、零封、最长连败等) 5
/teams/{id}/advanced 高阶画像(预期进球、攻防、控球、纪律) 10
/teams/{id}/injuries 伤停名单 5
/teams/{id}/squad 阵容大名单 3
/teams/{id}/coach 现任教练 3
/teams/{id}/players-advanced 队内球员高阶 TOP(最多 20 人,一次取全) 10

球员、教练与裁判组有哪些接口?

接口 用途 点数
/players?q= 球员搜索(拿 player_id) 2
/players/{id} 球员详情(含现属球队、身价) 2
/players/{id}/stats 球员赛季统计 3
/players/{id}/advanced 球员高阶指标(只用于查一个人) 3
/coaches/{id} 教练详情与执教履历 3
/referees?q= 裁判搜索 2
/referees/{id} 裁判详情与执法数据 3

联赛与转会组有哪些接口?

接口 用途 点数
/leagues 联赛列表 / 搜索 2
/leagues/{id} 联赛详情(可附带积分榜) 3
/leagues/{id}/teams 参赛球队 2
/leagues/{id}/seasons 赛季列表(不确定赛季口径时先查) 1
/leagues/{id}/fixtures 赛季逐场赛果 5
/leagues/{id}/topscorers 射手榜 5
/leagues/{id}/topassists 助攻榜 5
/standings 积分榜 3
/transfers 转会记录(按球队或球员) 5

报告与复盘组有哪些接口?

接口 用途 点数
/posts/today 当天全部官方研报(批发) 1000
/posts 指定日期全部研报(批发) 1000
/posts/{id} 研报全文 + 结构化预测 25 / 当天 100
/review 近 N 天预测复盘聚合 10
/stats/overall 整体命中率快照 5
/stats/team 某支球队的历史研报命中情况 5

小计:1 + 8 + 2 + 3 + 10 + 7 + 9 + 6 = 46 个接口。其中 2 个是免费接口(余额自查、生成进度),最贵的是研报批发(1000 点)与单场全景包(50 点)。

三、最常用的三个接口是哪几个?

如果只记三个,记这三个——它们覆盖了八成日常场景:

接口 为什么常用 点数
/today/digest 一眼看今天全部比赛,还带竞彩/北单编号,是选题的起点 5
/match-pack/{id} 一场比赛的全部维度,写单场内容的唯一主力 50
/teams/{id}/players-advanced 一次拿一队最多 20 人的高阶指标,球员内容的性价比之王 10

四、选型有哪三条原则?

原则一:能用批量就不用循环。同一类数据、多个对象,先找批量入口:一场比赛用全景包、一队球员用 players-advanced、当天赛事用 digest。

原则二:先用最便宜的接口确认 ID,再调贵的。搜索(2 点)→ 确认 → 详情/高阶(10~50 点)。顺序反了,就用最贵的接口在试错。

原则三:研报类先看官网。/posts 系列单次 25~1000 点,只是想读一读的话没必要花:历史复盘与命中统计 | 今日赛事前瞻。

💬 不知道该用哪个接口?问它(复制发送) 地图
我想做一件事:【用一句话说清你要做什么,例如「分析明天拜仁那场比赛」】。 请按下面的顺序回答,不要直接开始调用: 1. 完成这件事需要哪几个接口?按调用顺序列出,每个都标注点数和用途; 2. 每一步需要什么参数?我手上还没有的信息,告诉我该怎么拿到(例如球队 ID 要先搜索); 3. 总点数是多少?有没有更省的做法(能合并的合并、能用批量的别循环); 4. 其中有没有哪些内容其实不需要调接口、官网直接看就行?如果有,给我链接。 约束:接口名必须来自球小策创作者 API 的真实接口,不要编造;不确定的点数标注「需确认」。

下一步该看什么

常见问题

按场景选接口:我该用哪个?
先用这张表定位,再跳到下面看参数。 我想做的事 用哪个接口 点数 今天有哪些比赛?有竞彩编号吗? /today/digest 5 某一天 / 某个联赛 / 某支球队的赛程 /fixtures 2 看一场比赛的全部维度 /match-pack/{id} 50 看已完赛的技术统计 / 事件 / 阵容 / 球员评分 /fixtures/{id}/stats|events|lineup…
46 个接口分别是什么?
按功能分成 8 组。点数已标注,方便你估算成本。
账户组有哪些接口?
接口 用途 点数 /quota 余额自查(含有效期与限流配置) 0
赛事与赛程组有哪些接口?
接口 用途 点数 /today/digest 今日赛事总览(含竞彩/北单编号) 5 /fixtures 比赛日程(按日期 / 联赛 / 球队筛选) 2 /fixtures/{id} 单场比赛详情(含球场、裁判、比分分段) 2 /fixtures/{id}/stats 单场技术统计 5 /fixtures/{id}/events 单场事件流(进球、换人、牌) 5 /fixture…
单场全景组有哪些接口?
接口 用途 点数 /match-pack/{id} 单场全景数据包(一次覆盖全部维度,内置市场波动) 50 /tasks/{id} 完整包生成进度查询 0
市场参考值组有哪些接口?
接口 用途 点数 /fixtures/{id}/quotes 市场参考值当前快照(含官方公开参考值) 5 /fixtures/{id}/quotes/history 市场参考值时间序列(含开盘与临场标记) 5 /fixtures/{id}/market 已识别的市场异动事件流 5
免责声明

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

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

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

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

微信扫一扫打赏

微信打赏二维码

登录

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