SuperAPI AI 工具集

espn-api

通用与其它

查看项目

更新于 10-16 07:41

技能介绍

ESPN Public API Skill 是一个用于访问 ESPN 非官方公开 JSON API 的技能,旨在帮助用户获取体育数据。这些 API 为 espn.com 和 ESPN 移动应用提供数据支持,无需身份验证即可返回 JSON 格式响应。

用途方面,该技能适用于查询实时比分、排名、阵容、球员数据、赔率、逐回合记录、伤病信息、交易和新闻等体育数据,覆盖 17 种运动和 139 个联赛。

主要能力上,ESPN API 分为六个域,分别满足不同的数据需求。Site API(基础 URL 为 https://site.api.espn.com/apis/site/v2/sports/{sport}/{league}/)用于比分、球队、阵容、新闻、伤病和比赛摘要;Site API v2(https://site.api.espn.com/apis/v2/sports/{sport}/{league}/)仅用于排名,注意 /apis/site/v2/ 路径返回的是存根;Core API v2(https://sports.core.api.espn.com/v2/sports/{sport}/leagues/{league}/)用于运动员、详细数据、赔率、逐回合记录、场馆和教练;Core API v3(https://sports.core.api.espn.com/v3/sports/{sport}/{league}/)用于增强的运动员数据和领先者;Web API v3(https://site.web.api.espn.com/apis/common/v3/sports/{sport}/{league}/)用于球员赛季数据、比赛日志、拆分数据和排行榜;CDN(https://cdn.espn.com/core/{league-abbrev}/)用于完整比赛包,包含记分牌、逐回合记录和胜率,需要 ?xhr=1 参数;Now API(https://now.core.api.espn.com/v1/sports/news)用于实时新闻流。

使用方式上,首先识别用户需求,确定所需的运动和联赛,从端点参考中选择合适的 API 域和端点,构造 URL 并获取数据,再解析 JSON 响应。常用查询参数包括 dates(日期过滤,格式为 YYYYMMDD 或范围)、season(赛季年份)、seasontype(1=季前赛,2=常规赛,3=季后赛,4=休赛期)、week(周数)、limit(每页结果数)、page(页码)、groups(大学体育的会议 ID)、xhr(CDN 端点必需)、active(过滤活跃运动员)。提供快速入门示例,例如获取今日 NBA 比分可请求 https://site.api.espn.com/apis/site/v2/sports/basketball/nba/scoreboard,获取排名可请求 https://site.api.espn.com/apis/v2/sports/basketball/nba/standings,获取球队阵容需先从球队端点查找球队 ID 再请求 https://site.api.espn.com/apis/site/v2/sports/basketball/nba/teams/13/roster,获取完整比赛摘要可请求 https://site.api.espn.com/apis/site/v2/sports/basketball/nba/summary?event=401765432,获取球员赛季数据可请求 https://site.web.api.espn.com/apis/common/v3/sports/basketball/nba/athletes/3136776/stats,获取球员比赛日志可请求 https://site.web.api.espn.com/apis/common/v3/sports/basketball/nba/athletes/3136776/gamelog,获取比赛赔率可请求 https://sports.core.api.espn.com/v2/sports/basketball/leagues/nba/events/{eventId}/competitions/{eventId}/odds,获取联赛伤病报告可请求 https://site.api.espn.com/apis/site/v2/sports/football/nfl/injuries,获取实时新闻可请求 https://now.core.api.espn.com/v1/sports/news?sport=basketball&league=nba&limit=20,通过 CDN 获取完整比赛包可请求 https://cdn.espn.com/core/nba/game?xhr=1&gameId=401765432。

编写代码时,推荐使用 Python 的 requests 或 httpx 库,以及 JavaScript/TypeScript 的 fetch API,并设置 30 秒超时。最佳实践包括:对不常变化的数据(如球队、排名、阵容)实施缓存;优雅处理 404 错误(无效 ID、休赛期端点);通过指数退避处理 429 速率限制;由于 API 未文档化,访问嵌套字段前始终验证响应结构;使用 User-Agent 头标识应用。

适用场景包括体育数据查询、比分跟踪、球员数据分析、赔率查询和体育新闻获取等。

限制方面,这些是非官方、未文档化的 API,可能随时更改,需尊重请求量。赔率提供商 ID 包括 Caesars(38)、FanDuel(37)、DraftKings(41)、BetMGM(58)、ESPN BET(68)、Bet365(2000)。更深入的参考包括完整端点目录、所有运动和联赛 slug、JSON 响应模式示例、常见陷阱以及 Python 和 Bash 获取辅助脚本。