StatsHub Docs
APIAPI v2V2 endpoint referenceRankings

/competitions/{competitionId}/seasons/{seasonId}/player-rankings

List aggregate player-season rankings

GET
/competitions/{competitionId}/seasons/{seasonId}/player-rankings

List aggregate player-season rankings

Path Parameters

competitionId*string

Opaque resource ID

Match^[1-9][0-9]*$
seasonId*string

Opaque resource ID

Match^[1-9][0-9]*$

Query Parameters

limit?integer

Maximum resources to return; defaults to 25

Range1 <= value <= 100
Default25
after?string

Opaque cursor for the next page

before?string

Opaque cursor for the previous page

teamId?string

Filter by team

Match^[1-9][0-9]*$
recentAppearances?integer

Aggregate only each player's most recent appearances

Range1 <= value <= 1000
sort?string

Ranking order

Value in

  • "-goals"
  • "-assists"
  • "-appearances"
  • "name"

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/competitions/string/seasons/string/player-rankings"
{  "data": [    {      "appearances": 0,      "assists": 0,      "goals": 0,      "player": {        "id": "string",        "name": "string",        "slug": "string"      },      "position": "string",      "rank": 0,      "statistics": {        "accurateLongBalls": 0,        "accuratePasses": 0,        "aerialDuelsWon": 0,        "bigChancesCreated": 0,        "blockedShots": 0,        "clearances": 0,        "dispossessed": 0,        "duelsLost": 0,        "duelsWon": 0,        "expectedAssists": 0,        "expectedGoals": 0,        "foulsCommitted": 0,        "foulsWon": 0,        "interceptions": 0,        "keyPasses": 0,        "minutesPlayed": 0,        "nonPenaltyExpectedGoals": 0,        "offsides": 0,        "redCards": 0,        "saves": 0,        "shotsOnTarget": 0,        "tackles": 0,        "totalCrosses": 0,        "totalLongBalls": 0,        "totalPasses": 0,        "totalShots": 0,        "touches": 0,        "yellowCards": 0      },      "team": {        "id": "string",        "name": "string",        "slug": "string"      }    }  ],  "links": {    "next": "string",    "previous": "string",    "self": "string"  },  "page": {    "hasNext": true,    "hasPrevious": true,    "limit": 0,    "nextCursor": "string",    "previousCursor": "string"  }}