---
title: "SofaScore season top players"
method: GET
path: "/sofascore/tournament-top-players"
tags: ["SofaScore"]
---

# SofaScore season top players

`GET /sofascore/tournament-top-players`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sofascore/tournament-top-players`
- Auth: API key in header `x-api-key`

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.

## Query parameters

- `id` string, required
- `season` string, required
- `type` 'overall' | 'regular_season' | 'playoffs'
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreTournamentTopPlayersResponseDoc
  - `code` integer
  - `data` SofascoreTournamentTopPlayersResponse
    - `categories` SofascoreTopPlayerCategory[]
      - `count` integer
      - `key` string
      - `players` SofascoreTopPlayerEntry[]
        - `appearances` integer
        - `details` object
        - `played_enough` boolean
        - `player` SofascorePlayerRef
          - `country` string: Player's country.
          - `id` integer: SofaScore player id. Use it with the player endpoints.
          - `name` string: Player's full name.
          - `position` string: Position code, for example G, D, M or F.
          - `short_name` string: Shortened name, for example "F. Torres".
          - `slug` string: URL slug of the player on SofaScore.
        - `rank` integer
        - `team` SofascoreTeamRef
          - `country` string: Country the team belongs to.
          - `id` integer: SofaScore team id. Use it with the team endpoints.
          - `name` string: Full team name.
          - `national` boolean: True for a national team.
          - `short_name` string: Shortened team name.
          - `slug` string: URL slug of the team on SofaScore.
        - `value` number
    - `category_count` integer
    - `fetched_at` string
    - `season_id` integer
    - `source_url` string
    - `sport` string
    - `tournament_id` integer
    - `type` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)