toolzerhub API Docs

Get a season's top players (v1)

Returns season leaders grouped by statistic, such as rating, goals, assists and xG, each with player, team and value. position filters by role. Nothing found returns data: null.

1 credit / requestBilled only on success
GET
/v1/sofascore/tournament/season/top-players

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

id*integer

Tournament id (uniqueTournament.id), such as 17 for the Premier League. Find one with Search Sports.

Range1 <= value <= 10000000000
season_id*integer

Season id. List seasons with Get Sports Tournament (seasons).

Range1 <= value <= 10000000000
split?string

Statistics split. overall covers every match; regularSeason, playoffs and top16 apply only where the season has them.

Default"overall"

Value in

  • "overall"
  • "regularSeason"
  • "playoffs"
  • "top16"
position?string

Position filter: all, or a code such as gk, dc, mc, st, g, d, f.

Match^[a-z]{1,12}$
Default"all"
curl -X GET "https://example.com/v1/sofascore/tournament/season/top-players?id=17&season_id=61627" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "property1": null,    "property2": null  },  "details": {    "reason": "string",    "message": "string"  }}