按日期获取足球赛程与赛果
查看 足球数据 API：赛程、比分与积分榜 的全部接口 →传入必填 date，格式为 YYYYMMDD，例如 20261008，读取当日比赛列表。已验证的 response.matches 含比赛 id、leagueId、主客队 id/name/longName/score，以及 statusId、tournamentStage、status.utcTime、started、finished、cancelled 和毫秒时间戳 timeTS；已结束样例还含 status.scoreStr 与 status.reason。一次日期查询曾返回分布在两个 UTC 日期的比赛，日历时区尚未明确。请转换 UTC 开赛时间后，按用户目标日期筛选。started=false 时的 0-0 不能当作最终平局。
API 功能
每日列表保留比赛主键 比赛与联赛 ID 可用于后续补充详情，也便于合并相邻日期时去重。
主客队身份与比分成对返回 已验证列表同时含双方球队标识、名称与 score，便于制作比赛卡片。
比分结合进程标志解读 同时检查 started、finished；存在 cancelled 或 reason 时保留其补充说明。
跨 UTC 午夜的日历处理 利用 status.utcTime 或毫秒 timeTS 转换本地时间，不把查询日期直接等同于 UTC 日期。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/football/get-matches-events-by-date API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/football/get-matches-events-by-date?key=<API_KEY>&date=20261008'
curl -X GET 'https://api.opendata-api.com/api/project/football/get-matches-events-by-date?key=<API_KEY>&date=20261008'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 用 Python 和 zoneinfo 建立每日赛程日历，保留比赛 ID 后再转换北京时间。
- 只挑选 finished 的比赛生成赛果摘要，避免将未开赛的零比分当作终场结果。
- 合并相邻查询日期时按比赛 ID 去重，整理用户所在时区的一天。
- 从每日赛程选中比赛查询详情，再利用联赛 ID 获取总积分榜。
常见问题
如何用 Python 按日期查询足球赛程？
将 date 设为 YYYYMMDD，例如 20261008，读取返回的比赛 ID、UTC 时间和状态。用 zoneinfo 转换目标时区后，再进行日期筛选与展示。
为何同一天的结果包含两个 UTC 日期？
已验证样例确实跨越两个 UTC 日期，但查询日历所采用的时区尚未明确。不要假设它等同于 UTC 或北京时间；应转换每场开赛时间，并按目标本地日期过滤。
如何区分未开始、进行中和已结束？
应结合 started、finished、cancelled 以及可用的状态说明判断。0-0 仅是比分值，started=false 时不能解释为已经踢完的平局。