按名称搜索足球比赛
查看 足球数据 API：赛程、比分与积分榜 的全部接口 →用必填 search 查找候选比赛，为详情、比分和技术统计查询准备比赛 ID。选择候选时应核对实际参赛球队和开赛背景；球队名称并不能唯一确定一场比赛。本比赛专用搜索尚无已验证样例，不保证与综合搜索使用相同结构。
API 功能
无需预先知道比赛编号 先用搜索词发现比赛候选，再确定要查询的 eventid。
战报对象先核对再绑定 检查候选赛事背景后，再将比赛关联到编辑稿件。
多次交锋通过日期消歧 同一对球队可能多次相遇，应使用已核实的时间信息区分。
确认赛事后进入数据补充 把选定的真实比赛 ID 交给详情与统计接口，而非直接复用名称。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/football/get-search-matches API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/football/get-search-matches?key=<API_KEY>&search=Real+Madrid'
curl -X GET 'https://api.opendata-api.com/api/project/football/get-search-matches?key=<API_KEY>&search=Real+Madrid'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 为编辑查找稿件涉及的具体对阵提供赛事搜索工具。
- 在打开比赛中心前向用户展示待确认的比赛候选。
- 将德比名称解析为多个赛事，并要求核对日期后选定一场。
- 整理已确认的 eventid 研究队列，供后续检查半场技术统计。
常见问题
怎样先获得比赛 ID 再查询详情？
传入 search 搜索候选，核对双方及开赛背景后保留真实比赛 ID，再用于 eventid。不要只凭俱乐部名称认定某场对阵。
比赛搜索返回哪些固定字段？
本专用搜索的响应尚未验证，需检查实际字段；综合搜索中的日期和状态字段不自动适用于这里。
相同两队的比赛怎样避免选错？
结合可用日期、赛事和球队信息区分多次交锋。若响应不能充分消歧，应让用户确认，而不是自动选择第一项。