Top Scorers - AnySport

Given league_id + season (both required), returns the player stats leaderboard for that season, switching between three leaderboard types — goals (default), assists, and cards — via the kind parameter. Suitable for “Golden Boot / Assists Leader / Discipline Table” style individual stats pages for a competition; all three leaderboard types share an identical structure, only the meaning of value differs (goal count/assist count/card count), so the frontend can reuse the same rendering logic.

Endpoint

GET /v1/soccer/topscorers

Parameters

Parameter	Type	Required	Description
`league_id`	string	Yes	League ID (`asl_`)
`season`	string	Yes	Season (e.g. `2026`); can be obtained from `/seasons`
`kind`	string	No	Leaderboard type: `goals` (default) / `assists` / `cards`
`lang`	string	No	`en` / `zh-CN`; invalid values silently fall back to the default language — see `GET /languages` (19) for available values

Response fields (data: array)

Field	Type	Description
`rank`	int	Ranking
`player_id`	string	Player ID (`asp_`)
`player_name`	string	Name
`team_id`	string	Team ID
`team_name`	string	Team name
`value`	int	The value corresponding to `kind` (goals/assists/cards)

Request example

GET /v1/soccer/topscorers?league_id=asl_62db9cfc3ebf4b87a44570b16668b23e&season=2026&kind=goals&lang=en

Response example

HTTP 200

{
  "success": true,
  "data": [
    {
      "rank": 1,
      "player_id": "asp_dcd517a27bac41fd8657dffd91bc2f74",
      "player_name": "Lionel Messi",
      "team_id": "ast_9137ee449e3b40a68149ca319373adaf",
      "team_name": "Argentina",
      "value": 8
    },
    {
      "rank": 2,
      "player_id": "asp_7b9e560a44b149b698e9715717611fa5",
      "player_name": "Kylian Mbappe",
      "team_id": "ast_99cc49049ab642909e034538476c64ee",
      "team_name": "France",
      "value": 8
    },
    {
      "rank": 3,
      "player_id": "asp_ec6dd3316b1a4e22bac6fa22a0744aa2",
      "player_name": "Erling Haaland",
      "team_id": "ast_f5a0ef581314471a89a41abf397b4416",
      "team_name": "Norway",
      "value": 7
    }
  ],
  "meta": {
    "total": 50,
    "timestamp": "2026-07-13T19:18:23.748207300Z"
  },
  "traceId": "304191b0-f1d2-4187-ae74-499b3e4620ae"
}

Error example

Missing season → HTTP 400, error.code INVALID_PARAMS

GET /v1/soccer/topscorers?league_id=asl_62db9cfc3ebf4b87a44570b16668b23e&kind=goals

​Endpoint

​Parameters

​Response fields (data: array)

​Request example

​Response example

​Error example