Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Leagues

Player of the season race

GET

/v2/leagues/{id}/player-of-the-season/race

Pro and up

View as MarkdownTry in Playground →

The ongoing contest for player of the season: the front-runners ranked by average rating, highest first.

Our data source shows the leading three. Leagues that have no player-of-the-season race return an empty array.

Parameters

id

pathrequired

league id issued by DataSportsAPI, a positive integer

season

queryrequired

season id, as listed by /v2/leagues/{id}/seasons

Response

meta
season, count
errors
403 history_not_in_plan — your plan’s history window begins after this season ended404 not_found — the season id does not belong to this league

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

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/leagues/{id}/player-of-the-season/race?season=…"
Example
{ "data": [
    { "player": { "id": 4510, "name": "Jan Paul van Hecke", … }, "team": { "name": "Tottenham Hotspur", … }, "rating": 7.83, "appearances": 9, "playedEnough": true },
    { "player": { "name": "Erling Haaland", … }, "team": { "name": "Manchester City", … }, "rating": 7.79, "appearances": 9, "playedEnough": true }, … ],
  "meta": { "season": 200386, "count": 3 } }