Skip to content
datasportsAPI

LeaguesPlayer of the season race

Documentation

/

Type to filter the docs by title or path.

LeaguesEndpoint 85 of 116

Player of the season race

GET

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

Plan
Pro + Business
Auth
Bearer dsa_live_…
Parameters
2 required · 0 optional
Returns
PlayerOfTheSeasonCandidate[]
Try in Playground

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

Plan access

Requires a Pro or Business plan; every other plan receives 403 endpoint_not_in_plan.

Worth knowing

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

01Parameters

  • idpathRequired

    league id issued by DataSportsAPI, a positive integer

  • seasonqueryRequired

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

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/leagues/{id}/player-of-the-season/race?season=…"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
PlayerOfTheSeasonCandidate[]
meta
season, count
ObjectsPlayerOfTheSeasonCandidate
Example response
{ "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 } }

04Errors

  • 403history_not_in_plan

    your plan’s history window begins after this season ended

  • 404not_found

    the season id does not belong to this league

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code