Endpoint Playground
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.
14 Oct 2026: 26 categories; 3 fields had a value in every checked item.
Sample value profiles: count: 2 to 26, median 22; players: median 22 entries.
curl 'https://api.crawlora.net/api/v1/sofascore/team-top-players?id=17&tournament_id=17&season=96668&type=overall' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| id | string | Yes | 17 | Numeric SofaScore team id |
| tournament_id | string | Yes | 17 | Numeric SofaScore unique-tournament (competition) id from team-player-statistics-seasons |
| season | string | Yes | 96668 | Numeric SofaScore season id from team-player-statistics-seasons |
| type | string | No | overall | Statistics scope |
| limit | integer | No | Rows per category, 1 to 50. Omit to return every row |
{
"code": 200,
"msg": "OK",
"data": {
"team_id": 17,
"tournament_id": 17,
"season_id": 96668,
"type": "overall",
"sport": "football",
"category_count": 1,
"source_url": "https://api.sofascore.com/api/v1/team/17/unique-tournament/17/season/96668/top-players/overall",
"fetched_at": "2026-10-07T00: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",
"short_name": "Man City",
"slug": "manchester-city"
}
}
]
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.