Spotrac Sports Financial Data API

Sports financial data — player contracts, salary caps, payroll, free-agent values, transactions and draft economics across 12 leagues (NFL, NBA, MLB, NHL, MLS, EPL and more).

原始信息汇总

以下是数据集详情页面的关键信息总结：

Spotrac Sports Financial Data API 数据集概述

基本信息

• 提供商：elis-lab-3
• 类别：Sports
• 价格方案：提供 BASIC（免费）、PRO（$19.99/月）、ULTRA（$49.99/月）、MEGA（$149.99/月）四档订阅
• 端点总数：15 个

数据覆盖范围

涵盖 12 个体育联盟 的财务数据：

• NFL（美式橄榄球）
• NBA（篮球）
• MLB（棒球）
• NHL（冰球）
• MLS（足球）
• EPL（英超）
• WNBA（女子篮球）
• NWSL（女子足球）
• PGA（高尔夫）
• LPGA（女子高尔夫）
• NASCAR（赛车）
• Formula 1（一级方程式）

核心数据内容

提供独家体育财务数据，包括：

• 球员合同：完整合同细节、薪金分解
• 工资帽：球队薪资上限、薪资空间、死钱
• 球队薪资：总薪资、合同列表、财务概览
• 自由球员估值：可用及已签约自由球员
• 交易记录：球员与球队的最近交易历史
• 选秀经济数据：选秀权合同价值、选秀轮次
• 薪资排名：联盟内薪资排行榜

端点列表

方法	路径	描述
GET	/api/v1/search	按姓名搜索球员
GET	/api/v1/player	球员合同与薪金详情
GET	/api/v1/player/transactions	球员交易历史
GET	/api/v1/teams	联盟球队目录
GET	/api/v1/team/cap	球队工资帽（活跃/死钱/豁免）
GET	/api/v1/team/contracts	球队名下所有合同
GET	/api/v1/team/overview	球队财务概览
GET	/api/v1/team/transactions	球队近期交易
GET	/api/v1/team/draft	球队选秀权及合同价值
GET	/api/v1/league/cap	联盟球队工资帽对比
GET	/api/v1/league/contracts	联盟最大合同
GET	/api/v1/league/free-agents	可用及已签约自由球员
GET	/api/v1/league/transactions	联盟交易动态
GET	/api/v1/league/draft	完整选秀及经济数据
GET	/api/v1/league/rankings	最高薪球员排行榜

主要参数

• query：球员搜索名称（用于 search 端点）
• id：Spotrac 数字球员 ID（来自搜索）
• league：联盟代码（如 nfl、nba 等）
• team：球队 slug（来自球队目录）
• year：赛季年份（默认当前赛季，约 2011-2030）
• type：合同类型筛选
• status：自由球员状态筛选
• metric：排名指标（如 cap-hit、cash）
• position：位置组筛选
• round：选秀轮次筛选
• limit：结果数量限制

数据特点

• 货币值：以整数形式返回（美元），如 23709530 代表 $23,709,530
• 百分比：以浮点数返回
• 缺失值：返回 null
• 表格式端点：返回 header-keyed 行结构，包含 columns 数组和行数据
• 数据新鲜度：服务端缓存约 30 分钟

错误码

状态码	含义
200	成功
404	资源未找到
422	参数无效或缺失
502	从 Spotrac 获取数据失败

注意事项

• 个人体育项目（Formula 1、NASCAR、PGA、LPGA）无球队级端点，仅可使用联盟级端点
• 典型工作流程：先通过 /teams?league=xxx 获取球队 slug，再通过 /search?query=xxx 获取球员 id，然后使用 slug 和 id 调用具体端点