按球队 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 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
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'
curl -X GET 'https://api.opendata-api.com/api/project/football/get-team-detail-by-team-id?key=<API_KEY>&teamid=8633'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 根据已验证身份和主要联赛字段搭建皇家马德里俱乐部首页。
- 直接利用结构化 location 制作主场资料卡,不从问答文本猜测坐标。
- 球迷通讯引用下场比赛问答前,先与选定赛程核对日期。
- 保存收藏球队前,核对搜索结果与资料页的球队 ID 和国家是否一致。
常见问题
如何通过名称查询皇家马德里资料?
先搜索 Real Madrid 并确认球队类型,再把球队 ID 传入 teamid。已验证示例 8633 对应皇家马德里,仍应以实际响应核对身份。
球队详情包含完整球员名单吗?
不能这样假设。已验证样例的 athlete 为空;要制作名单页,应调用球队球员列表并核查其实际范围。
问答里的下一场比赛可以当作实时赛程吗?
不可以。faqJSONLD 中的答案是带日期的快照,展示前需与赛程核对,不能保证它始终指向当前下一场比赛。