按球队 ID 获取俱乐部资料

查看 足球数据 API:赛程、比分与积分榜 的全部接口 →

传入必填 teamid,将球队 ID 解析为身份、国家、最近赛季、主要联赛与结构化球场资料。已验证的 8633 对应皇家马德里,response.details 含 id、type、name、shortName、country、gender、latestSeason、primaryLeagueId、primaryLeagueName 和 teamColor。样例 sportsTeamJSONLD.location 含球场名称、地址与坐标;faqJSONLD 里的下场比赛和球场问答是带日期的快照,不是保证实时更新的赛程流。athlete 数组为空,球员名单应另查球队阵容接口。

API 功能

皇家马德里身份样例已核实 样例球队 ID 返回 Real Madrid、type='team' 和 country='ESP'。
主要联赛可继续关联 primaryLeagueId 与 primaryLeagueName 为球队页连接赛事查询提供依据。
结构化主场位置资料 已观察到的 location 包含球场、城市、国家和地理坐标。
赛季与问答按快照使用 复用 latestSeason 及带日期的问答前,应与赛程数据核对时效。

在线 API 演示

GET /api/project/football/get-team-detail-by-team-id

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/football/get-team-detail-by-team-id?key=<API_KEY>&teamid=8633'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

如何通过名称查询皇家马德里资料?

先搜索 Real Madrid 并确认球队类型,再把球队 ID 传入 teamid。已验证示例 8633 对应皇家马德里,仍应以实际响应核对身份。

球队详情包含完整球员名单吗?

不能这样假设。已验证样例的 athlete 为空;要制作名单页,应调用球队球员列表并核查其实际范围。

问答里的下一场比赛可以当作实时赛程吗?

不可以。faqJSONLD 中的答案是带日期的快照,展示前需与赛程核对,不能保证它始终指向当前下一场比赛。

相关接口

相关指南

查看订阅方案 →