Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Teams

Squad statistics seasons

GET

/v2/teams/{id}/top-players/seasons

All plans

View as MarkdownTry in Playground →

Lists the leagues and seasons where squad (player) statistics exist for the team — the inputs for /v2/teams/{id}/top-players. Available since 2026-11-04.

Uses the response shape of /v2/teams/{id}/statistics/seasons.

Parameters

id

pathrequired

DataSportsAPI team id, a positive integer

Response

meta
count
errors
404 not_found — DataSportsAPI has never assigned this id

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/teams/{id}/top-players/seasons"
Example
{ "data": [ { "league": { "id": 200001, "name": "Premier League", … }, "seasons": [ … ] } ], "meta": { "count": 6 } }