Teams
Team top players
GET/v2/teams/{id}/top-playersPro + Business
A team’s own season leaderboards in one league — its best-rated players, top scorers, assisters, … — paged like the league leaderboards.
The same shape and paging as /v2/leagues/{id}/top-players, limited to this team’s players. An empty array when the source has none for the team in that league and season.
Parameters
id
our numeric id (positive integer)
league
a league id the team plays in (/v2/teams/{id}/leagues)
season
a season id from /v2/leagues/{id}/seasons
type
overall | home | away | regularSeason | playoffs. Default: the season’s own — overall where it has one (football), else regularSeason (NBA, NHL, …); meta.type says which was used
category
one leaderboard only (a category of this season, e.g. goals); unknown → 400 listing the season’s categories
limit
entries per leaderboard, 1–50 (default 10)
page
page of limit entries, 0–49 (default 0 = the leaders)
Response
- data
TopPlayersCategory[]- meta
- season, type (the one used), category (null = all), limit, page, count (categories), hasNextPage
- errors
- 400 bad_request — league or season missing, or the paging / type / category invalid (as /v2/leagues/{id}/top-players)403 history_not_in_plan — the season ended before your plan’s history404 not_found — season is not one of this league’s seasons
Every /v2 call can also answer the common errors.
$ curl -H "Authorization: Bearer sk_live_…" \ "https://api.sportsapi.app/v2/teams/{id}/top-players?league=…&season=…"
Example
{ "data": [ { "category": "goals", "statistic": "goals", "players": [ { "player": { "id": 3759, "name": "Bukayo Saka", … }, "team": { "id": 18, "name": "Arsenal", … }, "value": 3, "appearances": 7, "playedEnough": true, "statistics": { "goals": 3, "appearances": 7 } }, … ] }, … ], "meta": { "season": 200386, "type": "overall", "category": null, "limit": 10, "page": 0, "count": 26, "hasNextPage": true } }