ESPN API

Comprehensive ESPN sports data API covering 11+ sports — live scores, standings, rosters, player profiles, game summaries, odds, and more across NFL, NBA, MLB, NHL, college sports, soccer, F1, UFC, golf, and tennis.

原始信息汇总

ESPN API 数据集概述

数据集基本信息

• 数据集名称: ESPN API
• 提供平台: RapidAPI
• 提供商: elis-lab
• 类别: Sports
• API版本: v1 (current)
• 订阅者数量: 4

数据集评分与性能

• 受欢迎度: 9.3 Popularity
• 服务等级: 100% Service Level
• 延迟: 353ms Latency

定价方案

• BASIC: $0.00 / mo
• PRO: $10.00 / mo
• ULTRA: $40.00 / mo
• MEGA: $100.00 / mo

数据集描述

• 最全面的ESPN体育数据API，提供超过20个端点，覆盖超过11项体育赛事，包含丰富的比赛细节。
• 官方ESPN数据源，非第三方聚合数据。
• 付费计划提供宽松的速率限制，突发流量不会导致服务中断。
• 提供慷慨的免费层级以测试所有端点。

覆盖的体育项目与联赛

• Football: NFL, NCAA Football
• Basketball: NBA, NCAA Mens Basketball, WNBA
• Baseball: MLB
• Hockey: NHL
• Soccer: Premier League, MLS, La Liga, Bundesliga, Serie A, Ligue 1, Champions League
• Golf: PGA Tour
• Tennis: ATP Tennis
• Racing: Formula 1
• MMA: UFC

主要端点 (共20个)

方法	路径	描述
GET	/api/v1/search	跨体育项目搜索
GET	/api/v1/news	新闻文章
GET	/api/v1/scoreboard	按日期获取比分
GET	/api/v1/scoreboard/live	所有体育项目的实时比赛
GET	/api/v1/standings	联赛排名
GET	/api/v1/teams	列出所有队伍
GET	/api/v1/teams/{teamId}	队伍详情
GET	/api/v1/teams/{teamId}/roster	队伍阵容
GET	/api/v1/teams/{teamId}/schedule	队伍赛程
GET	/api/v1/teams/{teamId}/statistics	队伍统计数据
GET	/api/v1/events/{eventId}/summary	完整比赛摘要
GET	/api/v1/athletes/{athleteId}	运动员资料
GET	/api/v1/athletes/{athleteId}/statistics	运动员统计数据
GET	/api/v1/sports	列出所有体育项目
GET	/api/v1/leagues	列出所有联赛
GET	/api/v1/feed	体育内容订阅源
GET	/api/v1/injuries	伤病报告
GET	/api/v1/odds	比赛赔率与投注线
GET	/api/v1/leaders	统计数据领先者
GET	/api/v1/calendar	赛季日历

关键端点功能

• 实时比分与记分牌: 实时比分、比赛状态、场地信息、赔率。
• 排名: 完整的联赛排名，包含每支队伍的胜负记录和统计数据。
• 队伍数据: 阵容、赛程、统计数据、徽标和完整的队伍详情。
• 运动员资料: 球员简介、职业生涯数据、头像、所属队伍。
• 比赛摘要: 市场上最丰富的端点：比赛数据、逐场播放、领先者、伤病、赔率、获胜概率、得分情况。
• 新闻与文章: 按体育项目和联赛筛选的最新体育新闻。
• 伤病与赔率: 最新的伤病报告和投注线。
• 搜索: 跨体育项目搜索球员、队伍和内容。

使用案例

• 体育博彩应用
• 梦幻体育联盟
• 体育新闻网站
• 数据统计仪表板
• 队伍网站
• 移动体育应用
• 数据分析平台

快速开始示例

bash curl -X GET "https://espn-api2.p.rapidapi.com/api/v1/scoreboard?sport=basketball&league=nba" -H "x-rapidapi-host: espn-api2.p.rapidapi.com" -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY"

通用参数

大多数端点需要 sport 和 league 参数：

参数	类型	必需	描述	示例
sport	string	是	体育项目标识	basketball
league	string	是	联赛标识	nba

响应字段示例

赛事对象

• id — 赛事ID
• date — ISO日期字符串
• name — 完整赛事名称
• shortName — 简称
• status.description — 状态描述
• status.state — 状态：pre, in, post
• competitors[] — 包含比分、记录、徽标的队伍

队伍对象

• id — 队伍ID
• abbreviation — 缩写代码
• displayName — 全名
• logo — 队伍徽标URL
• color / alternateColor — 十六进制颜色代码

运动员对象

• id — 运动员ID
• displayName — 全名
• jersey — 球衣号码
• position — 位置缩写
• height / weight — 身体属性
• headshot — 照片URL
• team — 当前队伍信息

分页

• 使用 limit 参数控制结果数量。
• 记分牌支持 date 参数用于查询历史或未来比赛。
• 搜索支持 type 参数以缩小结果范围。

错误代码

代码	描述
200	成功
404	资源未找到
422	验证错误 — 检查 errors 数组
502	上游ESPN API错误