Endpoint Playground

Try the SofaScore season top players API

Returns a competition season's top players for every statistic category SofaScore ranks (for football about 30 categories such as rating, goals, assists, expected goals, tackles and saves; for basketball points, rebounds, assists and more), each with the ranked players, their team and the value. The category set depends on the sport and competition, so the response lists every category it holds. The `type` enum accepts `overall`, `regular_season` and `playoffs`: football competitions publish `overall`, the NBA publishes `regular_season` and `playoffs`, and a type the competition does not publish answers 404. Optional `limit` caps the rows per category (up to 50). Get `id` from search and `season` from tournament-seasons.

What a live request returned

14 Oct 2026: 32 categories; 3 fields had a value in every checked item.

Observed request: GET /sofascore/tournament-top-players?id=17&limit=40&season=96668
Fields with a value in every checked item: key, count, players

Sample value profiles: count: 9 to 40, median 40; players: median 40 entries.

Request: GET /sofascore/tournament-top-players
Cost: 2 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 3.10 s
Monitored request: GET /sofascore/tournament-top-players?id=17&limit=3&season=96668

SofaScore season top players API documentation SofaScore platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/sofascore/tournament-top-players?id=17&season=96668&type=overall' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	string	Yes	17	Numeric SofaScore unique-tournament (competition) id
season	string	Yes	96668	Numeric SofaScore season id
type	string	No	overall	Statistics scope. Defaults to overall
limit	integer	No		Rows per category, 1 to 50. Omit to return every row

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "tournament_id": 17,
    "season_id": 96668,
    "type": "overall",
    "sport": "football",
    "category_count": 32,
    "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/top-players/overall",
    "fetched_at": "2026-10-07T14:00:00Z",
    "categories": [
      {
        "key": "goals",
        "count": 1,
        "players": [
          {
            "rank": 1,
            "value": 5,
            "appearances": 5,
            "played_enough": true,
            "player": {
              "id": 839956,
              "name": "Erling Haaland",
              "short_name": "E. Haaland",
              "slug": "erling-haaland",
              "position": "F"
            },
            "team": {
              "id": 17,
              "name": "Manchester City",
              "slug": "manchester-city"
            }
          }
        ]
      }
    ]
  }
}

More SofaScore endpoints

SofaScore categories for a sport SofaScore competitions in a category SofaScore league draft SofaScore league draft picks SofaScore esports game detail SofaScore event detail SofaScore event at-bat pitches SofaScore event at-bats SofaScore event average positions SofaScore event baseball top performers SofaScore event best players SofaScore event commentary All 109 SofaScore endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestsofascore.tournamentTopPlayersResponseDocSofaScore

GET /sofascore/tournament-top-players

SofaScore season top players

Response behavior

- `categories` keeps SofaScore's order and holds one entry per statistic, each with `key`, `count` and `players`. The category set depends on the sport and the competition, so read it from the response rather than assuming it. Premier League 2026/27 returns 32 categories: `rating`, `goals`, `expectedGoals`, `assists`, `expectedAssists`, `goalsAssistsSum`, `kilometersCoveredPer90`, `numberOfSprintsPer90`, `topSpeed`, `penaltyGoals`, `freeKickGoal`, `scoringFrequency`, `totalShots`, `shotsOnTarget`, `bigChancesMissed`, `bigChancesCreated`, `accuratePasses`, `keyPasses`, `accurateLongBalls`, `successfulDribbles`, `penaltyWon`, `tackles`, `interceptions`, `clearances`, `possessionLost`, `yellowCards`, `redCards`, `saves`, `goalsPrevented`, `mostConceded`, `leastConceded` and `cleanSheet`. The Champions League returns 30 (no per-90 distance or sprint categories), and the NBA 24 (`rating`, `points`, `rebounds`, `assists`, `steals`, `blocks`, `threePointsMade`, `plusMinus` and more). - `rank` is the position in SofaScore's list for that category. For `mostConceded` and `leastConceded` the list order is not strictly by value. - `value` is the category's headline figure (for `mostConceded` and `leastConceded` it is goals conceded). `details` holds any secondary figures SofaScore sends with it, such as `penaltiesTaken` for `penaltyGoals`, and is omitted when there are none. `played_enough` tells whether the player met SofaScore's minimum-appearances rule for ranked lists. - Short categories are normal (for example `redCards` or `cleanSheet` early in a season); a response with no categories at all is treated as an upstream error. - The payload is large (about 2 MB upstream), so prefer `limit`. For a sortable table of every player use `sofascore/tournament-player-statistics`. Example response (shortened): ```json { "code": 200, "msg": "OK", "data": { "tournament_id": 17, "season_id": 96668, "type": "overall", "sport": "football", "category_count": 32, "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/top-players/overall", "fetched_at": "2026-10-07T14:00:00Z", "categories": [ { "key": "goals", "count": 1, "players": [ { "rank": 1, "value": 5, "appearances": 5, "played_enough": true, "player": { "id": 839956, "name": "Erling Haaland", "short_name": "E. Haaland", "slug": "erling-haaland", "position": "F" }, "team": { "id": 17, "name": "Manchester City", "slug": "manchester-city" } } ] } ] } } ```

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

requiredstring

Numeric SofaScore unique-tournament (competition) idseason

requiredstring

Numeric SofaScore season id

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "tournament_id": 17,
    "season_id": 96668,
    "type": "overall",
    "sport": "football",
    "category_count": 32,
    "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/top-players/overall",
    "fetched_at": "2026-10-07T14:00:00Z",
    "categories": [
      {
        "key": "goals",
        "count": 1,
        "players": [
          {
            "rank": 1,
            "value": 5,
            "appearances": 5,
            "played_enough": true,
            "player": {
              "id": 839956,
              "name": "Erling Haaland",
              "short_name": "E. Haaland",
              "slug": "erling-haaland",
              "position": "F"
            },
            "team": {
              "id": 17,
              "name": "Manchester City",
              "slug": "manchester-city"
            }
          }
        ]
      }
    ]
  }
}

Try the SofaScore season top players API

What a live request returned

14 Oct 2026: 32 categories; 3 fields had a value in every checked item.

Observed request: GET /sofascore/tournament-top-players?id=17&limit=40&season=96668
Fields with a value in every checked item: key, count, players

Sample value profiles: count: 9 to 40, median 40; players: median 40 entries.

Request: GET /sofascore/tournament-top-players
Cost: 2 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 3.10 s
Monitored request: GET /sofascore/tournament-top-players?id=17&limit=3&season=96668

SofaScore season top players API documentation SofaScore platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/sofascore/tournament-top-players?id=17&season=96668&type=overall' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
id	string	Yes	17	Numeric SofaScore unique-tournament (competition) id
season	string	Yes	96668	Numeric SofaScore season id
type	string	No	overall	Statistics scope. Defaults to overall
limit	integer	No		Rows per category, 1 to 50. Omit to return every row

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "tournament_id": 17,
    "season_id": 96668,
    "type": "overall",
    "sport": "football",
    "category_count": 32,
    "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/top-players/overall",
    "fetched_at": "2026-10-07T14:00:00Z",
    "categories": [
      {
        "key": "goals",
        "count": 1,
        "players": [
          {
            "rank": 1,
            "value": 5,
            "appearances": 5,
            "played_enough": true,
            "player": {
              "id": 839956,
              "name": "Erling Haaland",
              "short_name": "E. Haaland",
              "slug": "erling-haaland",
              "position": "F"
            },
            "team": {
              "id": 17,
              "name": "Manchester City",
              "slug": "manchester-city"
            }
          }
        ]
      }
    ]
  }
}

SofaScore season top players

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "tournament_id": 17, "season_id": 96668, "type": "overall", "sport": "football", "category_count": 32, "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/top-players/overall", "fetched_at": "2026-10-07T14:00:00Z", "categories": [ { "key": "goals", "count": 1, "players": [ { "rank": 1, "value": 5, "appearances": 5, "played_enough": true, "player": { "id": 839956, "name": "Erling Haaland", "short_name": "E. Haaland", "slug": "erling-haaland", "position": "F" }, "team": { "id": 17, "name": "Manchester City", "slug": "manchester-city" } } ] } ] } }