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

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

地图
🕒 预计阅读：11 分钟 📅 更新时间：2026年09月14日 👁️ 0 次阅读 ✍️ 来源：球小策量化实验室
💡
提示：您当前为未登录状态，代码示例使用通用占位符展示。点击登录并免费领取 500 点体验金 后，所有代码将自动替换为您本人的专属 Key。

46 个接口，不要试图全部记住。按「你要做什么」来选，而不是按接口名字找。

一、按场景选接口（最实用）

我要做的事 建议接口 点数
找今天有哪些比赛 /today/digest 5
按日期/联赛查赛程 /fixtures 2
做单场深度分析 /match-pack/{id} 50
只要单场技术统计 /fixtures/{id}/stats 5
看伤停情况 /teams/{id}/injuries 5
评估球队真实实力 /teams/{id}/advanced 10
评估球员水平 /players/{id}/advanced 10
查积分榜 /standings 或 /standings/{league} 3
查历史交锋 /h2h —
看市场数据数值变动 /fixtures/{id}/quotes/history 5
看系统历史命中率 /stats/overall / /stats/team 5
查自己的余额 /quota 0

二、全部接口按功能分组

A 组｜基础与账户

接口 用途 点数
/quota（别名 /me、/balance） 余额自查 0
/tasks/{id} 生成任务进度 0

B 组｜赛事与赛程

接口 用途 点数
/fixtures 比赛日程 2
/fixtures/{id} 单场比赛详情 2
/today/digest 今日赛事总览 5
/h2h 两队交锋历史 —

C 组｜单场明细

接口 用途 点数
/fixtures/{id}/stats 单场技术统计 5
/fixtures/{id}/events 单场事件流 5
/fixtures/{id}/lineups 单场阵容 5
/fixtures/{id}/players 单场球员统计 5
/fixtures/{id}/market 市场异动流 5
/fixtures/{id}/quotes 市场参考值快照 5
/fixtures/{id}/quotes/history 市场参考值历史 5
/match-pack/{id} 单场全景数据包（旗舰） 50

D 组｜球队

接口 用途 点数
/teams 球队搜索 2
/teams/{id} 球队详情 2
/teams/{id}/form 球队近期战绩 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 10

E 组｜球员 / 教练 / 裁判

接口 用途 点数
/players 球员搜索 2
/players/{id} 球员详情 2
/players/{id}/stats 球员赛季统计 3
/players/{id}/advanced 球员高阶指标 10
/coaches/{id} 教练详情 + 执教履历 3
/referees 裁判搜索 2
/referees/{id} 裁判详情 + 执法数据 3
/transfers 转会记录 5

F 组｜联赛

接口 用途 点数
/leagues 联赛列表 2
/leagues/{id} 联赛详情 + 积分榜 3
/leagues/{id}/seasons 联赛赛季列表 1
/leagues/{id}/teams 联赛参赛球队 2
/leagues/{id}/fixtures 联赛赛季逐场赛果 5
/leagues/{id}/topscorers 联赛射手榜 5
/leagues/{id}/topassists 联赛助攻榜 5
/standings / /standings/{league} 积分榜 3

G 组｜报告与复盘

接口 用途 点数
/posts 指定日期全部报告 1000
/posts/today 当天全部报告 1000
/posts/{id} 报告全文 + AI 预测 25 / 100
/review 预测复盘聚合 10
/stats/overall 整体命中率 5
/stats/team 球队命中率 5

H 组｜技能包

接口 用途
/skill/version 技能包版本与文件清单
/skill/download 技能包下载

三、最常用的三个接口（背下来）

  1. /today/digest —— 每日选题必用；
  2. /match-pack/{id} —— 深度分析必用；
  3. /teams/{id}/injuries —— 阵容折损判断必用。

四、选型三原则

  • 先用搜索拿 ID，再查详情，不要靠猜；
  • 只要一两个维度就分开调，需要全景才用 match-pack；
  • 历史数据一律本地缓存，不要反复拉取。

下一步该看什么

← 上一篇 4.3 跑通第一个请求：curl / Python / JS 三语言示例 下一篇 → 4.5 核心接口精讲①：赛事、赛程与今日总览

常见问题

关于「按场景选接口（最实用）」，应该怎么理解？
我要做的事 建议接口 点数 找今天有哪些比赛 /today/digest 5 按日期/联赛查赛程 /fixtures 2 做单场深度分析 /match-pack/{id} 50 只要单场技术统计 /fixtures/{id}/stats 5 看伤停情况 /teams/{id}/injuries 5 评估球队真实实力 /teams/{id}/advanced 10 评估球员水平 …
关于「A 组｜基础与账户」，应该怎么理解？
接口 用途 点数 /quota（别名 /me、/balance） 余额自查 0 /tasks/{id} 生成任务进度 0
关于「B 组｜赛事与赛程」，应该怎么理解？
接口 用途 点数 /fixtures 比赛日程 2 /fixtures/{id} 单场比赛详情 2 /today/digest 今日赛事总览 5 /h2h 两队交锋历史 —
关于「C 组｜单场明细」，应该怎么理解？
接口 用途 点数 /fixtures/{id}/stats 单场技术统计 5 /fixtures/{id}/events 单场事件流 5 /fixtures/{id}/lineups 单场阵容 5 /fixtures/{id}/players 单场球员统计 5 /fixtures/{id}/market 市场异动流 5 /fixtures/{id}/quotes 市场参考值快照…
关于「D 组｜球队」，应该怎么理解？
接口 用途 点数 /teams 球队搜索 2 /teams/{id} 球队详情 2 /teams/{id}/form 球队近期战绩 5 /teams/{id}/fixtures 球队逐场赛程历史 3 /teams/{id}/statistics 球队赛季统计 5 /teams/{id}/advanced 球队高阶画像 10 /teams/{id}/injuries 球队伤停名单…
关于「E 组｜球员 / 教练 / 裁判」，应该怎么理解？
接口 用途 点数 /players 球员搜索 2 /players/{id} 球员详情 2 /players/{id}/stats 球员赛季统计 3 /players/{id}/advanced 球员高阶指标 10 /coaches/{id} 教练详情 + 执教履历 3 /referees 裁判搜索 2 /referees/{id} 裁判详情 + 执法数据 3 /transfe…
免责声明

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

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

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

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

微信扫一扫打赏

微信打赏二维码

登录

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