查询足球比赛双方历史交锋
查看 足球数据 API：赛程、比分与积分榜 的全部接口 →以必填 eventid 选择比赛双方，查询历史交锋信息；不是分别传入主客队 ID。响应尚未验证，应检查实际返回的交锋记录、日期跨度和比赛标识后再总结。返回记录不能证明涵盖完整历史，也不能预测下一场结果。
API 功能
对阵由选定赛事决定 用 eventid 确定要查询交锋背景的两支参赛球队。
交锋汇总限定返回记录 检查实际响应后，仅汇总它提供的历史相遇。
往绩与预测概率分开 将旧赛果作为背景，不解释成下一场胜率。
德比历史保留记录依据 整理交锋时保留核实后的比赛 ID 与日期。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/football/get-head-to-head-by-event-id API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/football/get-head-to-head-by-event-id?key=<API_KEY>&eventid=5868072'
curl -X GET 'https://api.opendata-api.com/api/project/football/get-head-to-head-by-event-id?key=<API_KEY>&eventid=5868072'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 为所选比赛的赛前预览增加双方过往交锋章节。
- 编写日期覆盖与返回记录一致的德比背景简报。
- 检查历史交锋集合与既有赛程归档的重叠记录。
- 让球迷对比页区分交锋数据不可用和确实没有返回交锋。
常见问题
历史交锋要传两个球队 ID 吗？
不需要，本接口声明的是必填 eventid，由一场比赛确定双方，不接受单独的主客队参数。
返回的交锋范围有多长？
尚无已验证样例，应检查实际日期跨度和交锋记录，不能预先宣称覆盖全部历史。
能根据交锋数据直接给出胜率吗？
不能。历史赛果是对阵背景，不是经过校准的预测概率，也不保证下一场比赛结果。