搜索足球球队与比赛
查看 足球数据 API：赛程、比分与积分榜 的全部接口 →按足球相关名称搜索，获取带类型的候选项及可用于后续查询的球队或比赛 ID。必填 search，例如 Real Madrid。已验证响应包含 status='success' 和 response.suggestions。球队候选含 type、id、name、leagueId、leagueName；比赛候选含 id、matchDate、status.utcTime、started/finished/cancelled 状态及主客队 ID 和名称。不同类型的字段并不相同，score 是搜索排序分值，不是比赛比分。无匹配的测试请求成功返回 suggestions=[]。
API 功能
按候选类型分流 读取 type 后选择球队资料或比赛详情，避免将不同实体的 ID 混用。
搜索结果附联赛背景 已验证的球队候选同时提供 leagueId 和 leagueName，便于确认所属赛事。
从名称找到具体对阵 比赛候选提供参赛双方、开赛时间和状态，可据此选择目标比赛。
识别成功但零命中 无匹配样例仍返回成功状态和空 suggestions，不应生成虚构的实体记录。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/football/get-search-all API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/football/get-search-all?key=<API_KEY>&search=Real+Madrid'
curl -X GET 'https://api.opendata-api.com/api/project/football/get-search-all?key=<API_KEY>&search=Real+Madrid'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 让同一个搜索框将皇家马德里球队结果导向俱乐部页，将德比赛事结果导向比赛中心。
- 在接入演示中分别展示有候选项和正常无结果的界面。
- 帮助编辑从俱乐部名称找到候选对阵，再选定战报对象。
- 收藏时同时保存实体类型与 ID，避免混淆球队和比赛标识。
常见问题
怎样通过球队名称找到球队 ID？
将名称填入必填的 search，检查 suggestions 中的 type 和球队背景，再保存匹配球队的 id。Real Madrid 是公开名称示例，不代表每次查询都保证有结果。
搜索结果中的 score 是比分吗？
不是。这里的 score 用于候选项排序；比赛比分应查看赛程或经过验证的单场比分响应。不同类型的候选项也不能共用一套字段假设。
suggestions 为空是否表示请求失败？
不一定。已验证的无匹配请求返回 status='success' 和 suggestions=[]。应结合 HTTP 状态与响应业务状态判断，再显示无匹配结果。