Esports Earnings Data API

Esports prize money rankings, player earnings, tournament data, and team statistics from esportsearnings.com

原始信息汇总

Esports Earnings Data API 数据集概述

数据集基本信息

• 数据集名称: Esports Earnings Data API
• 数据来源: esportsearnings.com
• API版本: v1 (current)
• 基础URL: https://esportsearnings-api.vercel.app/api/v1
• 数据格式: 结构化JSON

数据覆盖范围

该API提供全面的电子竞技赛事奖金数据，涵盖以下主要类别：

• 游戏: 按总奖金排名的顶级电子竞技游戏
• 玩家: 包含职业生涯收入、赛事历史和传记数据的玩家排名
• 赛事: 按奖金池排序的最大规模赛事及其详细结果
• 战队: 按总奖金排名的顶级电子竞技组织
• 国家/地区: 按电子竞技收入排名的国家/地区
• 历史记录: 按年份（1998-2026年）统计的历史最高收入者
• 搜索: 跨玩家、赛事、活动、联赛和战队的搜索功能

端点详情

API共包含11个端点：

游戏相关

• GET /games: 列出所有按总奖金排名的游戏
• GET /games/{gameId}: 获取游戏详情，包括顶级玩家、赛事和国家/地区

玩家相关

• GET /players: 按排名类型获取顶级玩家
• GET /players/{playerId}: 获取玩家详情，包括收入细分

赛事相关

• GET /tournaments: 获取按奖金池排序的最大规模赛事
• GET /tournaments/{tournamentId}: 获取赛事详情，包括奖金分配

战队相关

• GET /teams: 获取按总奖金排名的顶级战队
• GET /teams/{teamId}: 获取战队详情，包括阵容和顶级玩家

国家/地区相关

• GET /countries: 获取按电子竞技收入排名的国家/地区

历史记录相关

• GET /history/{year}: 获取指定年份的最高收入玩家

搜索功能

• GET /search: 搜索玩家、赛事、活动、联赛或战队

参数说明

路径参数

参数	类型	端点	描述
gameId	integer	/games/{gameId}	数字游戏ID（例如：245代表CS:GO）
playerId	integer	/players/{playerId}	数字玩家ID（例如：3304代表N0tail）
tournamentId	integer	/tournaments/{tournamentId}	数字赛事ID（例如：37294）
teamId	integer	/teams/{teamId}	数字战队ID（例如：419代表OG）
year	integer	/history/{year}	年份，范围1998至2030

查询参数

参数	类型	端点	必需	默认值	描述
ranking	string	/players	否	overall	排名类型（见下方可选值）
q	string	/search	是	--	搜索查询（至少1个字符）
type	string	/search	否	player	要搜索的实体类型

排名类型可选值: overall, single-game, most-tournaments, last-30-days, last-90-days, last-365-days, female, console, offline, online

搜索类型可选值: player, tournament, event, league, team

响应格式

所有成功响应均遵循相同的信封格式： json { "status": "OK", "message": "Success", "data": [ ... ] }

data字段包含数组（列表端点）或对象（详情端点）。

数据字段描述

游戏列表 (/games)

字段	类型	描述
rank	integer	在奖金排名中的位置
gameId	integer	唯一游戏标识符
slug	string	URL友好的游戏名称
name	string	游戏显示名称
totalPrizeMoney	number	以美元计的总奖金
playerCount	integer	获得奖金的玩家数量
tournamentCount	integer	举办的赛事数量

玩家列表 (/players)

字段	类型	描述
rank	integer	在选定排名中的位置
playerId	integer	唯一玩家标识符
handle	string	玩家游戏内名称/标签
name	string	玩家真实姓名
countryCode	string	ISO国家/地区代码（小写）
totalEarnings	number	以美元计的总职业生涯收入
topGame	string	收入最高的游戏
topGameEarnings	number	来自顶级游戏的收入（美元）
percentOfTotal	number	来自顶级游戏的收入占总收入的百分比

赛事列表 (/tournaments)

字段	类型	描述
rank	integer	按奖金池大小的排名位置
tournamentId	integer	唯一赛事标识符
name	string	赛事名称
totalPrize	number	以美元计的总奖金池
game	string	关联的游戏名称
gameId	integer	关联的游戏标识符
teamCount	integer	战队数量
playerCount	integer	玩家数量

战队列表 (/teams)

字段	类型	描述
rank	integer	按奖金收入的排名位置
teamId	integer	唯一战队标识符
name	string	战队名称
totalPrizeMoney	number	以美元计的总奖金收入
tournamentCount	integer	参与的赛事数量

国家/地区列表 (/countries)

字段	类型	描述
rank	integer	按总收入的排名位置
countryCode	string	ISO国家/地区代码（小写）
countryName	string	国家/地区显示名称
totalEarnings	number	以美元计的电子竞技总收入
playerCount	integer	来自该国家/地区的玩家数量
topGame	string	该国家/地区收入最高的游戏
topGameId	integer	顶级游戏的标识符
topGameEarnings	number	来自顶级游戏的收入（美元）
percentOfTotal	number	来自顶级游戏的收入占总收入的百分比

历史记录 (/history/{year})

字段	类型	描述
rank	integer	按年度收入的排名位置
playerId	integer	唯一玩家标识符
handle	string	玩家游戏内名称/标签
name	string	玩家真实姓名
yearEarnings	number	查询年份的收入（美元）
totalEarnings	number	职业生涯总收入（美元）
percentOfTotal	number	查询年份收入占职业生涯总收入的百分比

搜索 (/search)

字段	类型	描述
type	string	实体类型（player, tournament, event, league, team）
id	integer	匹配实体的唯一标识符
name	string	匹配实体的显示名称
slug	string	URL友好的名称slug
earnings	number	总收入（美元），如不适用则为0
href	string	原始源路径

错误代码

状态码	含义	描述
200	OK	请求成功
404	Not Found	端点不存在
422	Unprocessable Entity	验证失败——检查errors数组
502	Bad Gateway	上游数据源不可用或返回错误

错误响应格式

json { "status": "error", "message": "Validation failed", "errors": [ { "field": "gameId", "message": "gameId must be a positive integer", "value": "abc" } ] }

errors数组仅出现在422响应中，列出每个无效字段及其错误信息和提交的值。