按名称搜索足球联赛与赛事
查看 足球数据 API：赛程、比分与积分榜 的全部接口 →用必填 search 发现赛事候选，确认联赛 ID 后查询详情、比赛列表或积分榜。接入前需检查本接口实际返回的身份与区分信息；字段及无结果行为尚未验证。能搜索到一个赛事，不代表它在统计、积分榜等所有接口中都具备数据。
API 功能
从赛事名称进入联赛查询 以 search 开始，无需提前填写 leagueid。
选中赛事后再核验详情 通过联赛详情核实候选身份，再给相关数据添加赛事名称。
保存经过确认的赛事引用 将有效赛事 ID 留作后续赛程与积分榜查询。
联赛可发现不等于统计齐全 赛事搜索与技术统计覆盖是两件需要分别验证的事。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/football/get-search-leagues API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/football/get-search-leagues?key=<API_KEY>&search=Premier+League'
curl -X GET 'https://api.opendata-api.com/api/project/football/get-search-leagues?key=<API_KEY>&search=Premier+League'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 为积分榜表单提供能够输出已确认 leagueid 的赛事自动补全。
- 在多个相似赛事名称之间帮助用户收藏正确的联赛。
- 检查目标国内赛事能否通过搜索发现，不依赖可能不完整的目录。
- 新建赛事专题页之前，让引导流程先确认联赛身份。
常见问题
如何查英超的联赛 ID？
可用 Premier League 作为 search 搜索词，检查候选身份后确认 ID，再用于 leagueid。总积分榜已验证的公开英超示例为 47。
搜索接口是否保证固定联赛字段？
尚未验证其响应结构，需检查实际返回的字段与无结果格式，不能直接套用其他搜索接口。
找到联赛后可以承诺全部赛事功能吗？
不可以。积分榜、阵容、赔率和统计的数据可用性仍需按目标联赛与比赛逐项检查。