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

# SofaScore team top players

`GET /sofascore/team-top-players`

## Request

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

Returns a team's best players for every statistic category SofaScore ranks within the team and season (rating, goals, assists, expected goals, tackles, saves and more for football; points, rebounds and assists for basketball), each as a ranked list with player, team and value. The category set depends on the sport, 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); the payload is large without it.

## Query parameters

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

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreTeamTopPlayersResponseDoc
  - `code` integer
  - `data` SofascoreTeamTopPlayersResponse
    - `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
    - `team_id` integer
    - `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/0497899e2016?raw)