---
title: "SofaScore season player statistics table"
method: GET
path: "/sofascore/tournament-player-statistics"
tags: ["SofaScore"]
---

# SofaScore season player statistics table

`GET /sofascore/tournament-player-statistics`

## Request

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

Returns one page of a football competition season's player statistics table, sortable by a statistic. `order` chooses the statistic to sort by, `direction` the sort direction (`desc` or `asc`), `accumulation` whether values are season totals, per-game averages or per-90-minute averages (`total`, `perGame`, `per90`), and `group` which statistic columns each row carries (`summary`, `attack`, `defence`, `passing`, `goalkeeper`). Page with `limit` (up to 100) and `offset`; `has_next_page` shows whether more rows follow. Optional filters narrow the table: `team` (team ids), `nationality` (SofaScore nationality codes), `position` (`G`, `D`, `M`, `F`), `min_appearances` and `min_minutes`; several filters combine (AND) and several values of one filter are alternatives (OR). The team ids and nationality codes of a season come from tournament-statistics-info. A filter that matches nobody returns an empty `players` list. Other sports return no rows (404). Get `id` from search and `season` from tournament-seasons.

## Query parameters

- `id` string, required
- `season` string, required
- `order` 'rating' | 'goals' | 'expectedGoals' | 'assists' | 'successfulDribbles' | 'tackles' | 'accuratePassesPercentage' | 'bigChancesMissed' | 'totalShots' | 'goalConversionPercentage' | 'interceptions' | 'clearances' | 'errorLeadToGoal' | 'outfielderBlocks' | 'bigChancesCreated' | 'accuratePasses' | 'keyPasses' | 'saves' | 'cleanSheet' | 'penaltySave' | 'savedShotsFromInsideTheBox' | 'runsOut'
- `direction` 'desc' | 'asc'
- `accumulation` 'total' | 'perGame' | 'per90'
- `group` 'summary' | 'attack' | 'defence' | 'passing' | 'goalkeeper'
- `limit` integer
- `offset` integer
- `team` string[]
- `nationality` string[]
- `position` string[]
- `min_appearances` integer
- `min_minutes` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreTournamentPlayerStatisticsResponseDoc
  - `code` integer
  - `data` SofascoreTournamentPlayerStatisticsResponse
    - `accumulation` string
    - `count` integer
    - `direction` string
    - `fetched_at` string
    - `filters` SofascorePlayerStatisticsFilters
      - `min_appearances` integer
      - `min_minutes` integer
      - `nationalities` string[]
      - `positions` string[]
      - `team_ids` integer[]
    - `group` string
    - `has_next_page` boolean
    - `limit` integer
    - `offset` integer
    - `order` string
    - `page` integer
    - `players` SofascorePlayerStatisticsRow[]
      - `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
      - `statistics` object
      - `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.
    - `season_id` integer
    - `source_url` string
    - `total_pages` integer
    - `tournament_id` integer
  - `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)