用途:通过 ESPN 未公开的公开 JSON API 获取体育数据,这些接口为 espn.com 与 ESPN 移动应用提供数据,无需鉴权,返回 JSON。
主要能力:覆盖比分、排名、球队与阵容、球员赛季数据与比赛日志、赔率、逐回合、伤病、交易、新闻等。涉及六个域:Site API(比分、球队、阵容、新闻、伤病、比赛摘要)、Site API v2(仅排名)、Core API v2(球员、详细数据、赔率、逐回合、场馆、教练)、Core API v3(增强球员数据、领先榜)、Web API v3(球员赛季数据、比赛日志、拆分、排行榜)、CDN(完整比赛包,需 ?xhr=1)、Now API(实时新闻)。
使用方式:先确定运动与联赛 slug,再选域与端点,构造 URL 并解析 JSON。示例:今日 NBA 比分 curl "https://site.api.espn.com/apis/site/v2/sports/basketball/nba/scoreboard";排名须用 /apis/v2/ 而非 /apis/site/v2/;球队阵容 curl "https://site.api.espn.com/apis/site/v2/sports/basketball/nba/teams/13/roster";比赛摘要 curl "https://site.api.espn.com/apis/site/v2/sports/basketball/nba/summary?event=401765432";球员赛季数据 curl "https://site.web.api.espn.com/apis/common/v3/sports/basketball/nba/athletes/3136776/stats";赔率 curl "https://sports.core.api.espn.com/v2/sports/basketball/leagues/nba/events/{eventId}/competitions/{eventId}/odds";实时新闻 curl "https://now.core.api.espn.com/v1/sports/news?sport=basketball&league=nba&limit=20"。常用参数包括 dates、season、seasontype、week、limit、page、groups、xhr、active。
适用场景:构建体育数据看板、比分查询、球员数据统计、赔率展示等。
限制:接口非官方且未公开,可能随时变更;应控制请求频率、实现缓存并优雅处理错误;建议设置 30 秒超时,处理 404 与 429(指数退避),使用 User-Agent 标识应用,并在访问嵌套字段前校验响应结构。