REST API · 足球数据
足球数据 API为 AI 分析准备的数据接口
赛程、球队、球员、赛前指数、技术统计与中文名称，结构统一、语义清晰；AI 助手和分析 Agent 可以直接读取、检索和组合。
阿森纳ARS
切尔西CHE足球比赛页示例
以足球为例，比分、事件、阵容、统计和指数可以组合成完整的比赛页。其他运动沿用同一套响应结构，真实字段以 API 文档为准。
数据结构，先让 AI 看懂
接口返回结构化 JSON，字段命名一致，名称、状态和时间有明确含义。AI 助手、分析 Agent 和数据产品可以直接消费，不用先做一轮清洗。
结构统一
JSON 响应和字段组织保持一致，AI 不需要为每个端点重新适配。
语义明确
联赛、球队、球员提供中英文名称，状态和时间字段含义清晰。
按任务取数
赛程、阵容、统计和指数可以按任务组合，适合问答和分析流程。
面向 Agent
可以接入 AI 助手、自动化分析流程和数据产品，省掉中间层。
足球数据模块，按需接入
以下为足球已上线的数据模块：赛程、球队球员、赛前指数、积分榜和技术统计，按需组合；其他运动按同一响应结构接入。
赛程与赛果
按联赛、日期和状态查询比赛，获取开球时间、比分和比赛状态。
球队与球员
球队、球员、教练、场馆、阵容、转会和伤病资料，按赛事组织。
萨卡右边锋阿森纳
帕尔默前腰切尔西
哈弗茨中锋阿森纳赛前指数
多家数据源的赛前指数，统一市场标识，便于组合和展示。
积分榜
联赛积分、排名、胜平负、净胜球和近期状态，按赛季查询。
阿森纳ARS胜胜胜平胜
曼城MCI胜平胜胜负
利物浦LIV平胜胜平胜技术统计
控球、射门、xG、传球、角球和犯规，按球队和球员拆分。
足球赛事覆盖
足球已覆盖欧洲、亚洲、南美等主要赛事体系；其他运动按同一数据标准接入，具体范围以商务确认为准。
覆盖范围
具体可接入联赛和赛事范围，以商务确认和合同约定为准。
开发者接入
提供 REST API、鉴权、错误码和中文文档；返回结构化 JSON，适合开发者和 AI Agent 读取。
- REST API，JSON 响应
- API Key 鉴权
- 中文文档与调用示例
- 结构化 JSON，AI 可读
从开通到上线，有人对接
提供中文数据、中文文档和人工接入协助。遇到字段、时区或接入问题，直接找商务和技术支持。
人工开通
提交申请后由商务开通 API Key
工作日支持
重要赛事日延长服务时间
分级响应
标准、优先和专属支持
中文 + 人工
中文数据、中文文档和接入协助
常见问题
运动与赛事范围、更新频率、语言、时区和接入方式。还有其他问题，扫码联系商务。
需要具体报价？
把使用场景、联赛范围和预估调用量发给我们，我们会尽快给出合作套餐建议。
企业微信扫码添加商务支持哪些运动？
足球数据已上线；篮球、网球、电竞、赛车、棒球、排球、冰球按统一接口陆续接入。具体开放范围和时间以商务确认为准。
数据多久更新一次？
比分和比赛事件按赛事节奏更新，赛前指数按赛前节奏更新；具体时效以 API 文档和服务确认为准。
覆盖哪些赛事？
足球覆盖全球主流联赛与杯赛；其他运动按接入进度开放，具体范围以商务确认为准。套餐可按运动与联赛范围选择，合同期内支持调整。
中文数据怎么返回？
默认中文，联赛、球队、球员提供中文名称；需要英文时可切换。
时区怎么处理？
默认使用北京时间，所有时间字段带时区偏移；也可以按请求切换时区。
怎么开始接入？
提交试用申请，商务确认范围和调用方式后开通 API Key；试用时长与范围以开通确认为准。
指数覆盖哪些类型？
覆盖常见的赛前指数类型，具体以 API 文档和开通范围为准。
数据适合 AI 分析吗？
适合。接口返回结构化 JSON，字段命名和语义一致，提供中英文名称、明确状态和时间字段，AI 助手和分析 Agent 可以直接读取、检索和组合。
