Endpoint Playground

Try the SofaScore Player Season Stats API

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.

What a live request returned

14 Oct 2026: 40 players; 4 fields had a value in every checked item.

Observed request: GET /sofascore/tournament-player-statistics?id=17&limit=40&order=goals&season=96668
Fields with a value in every checked item: rank, player, team, statistics

Sample value profiles: rank: 1 to 40, median 20.

Request: GET /sofascore/tournament-player-statistics
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.97 s
Monitored request: GET /sofascore/tournament-player-statistics?id=17&limit=5&order=goals&season=96668

SofaScore Player Season Stats API documentation SofaScore platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/sofascore/tournament-player-statistics?id=17&season=96668&order=rating&direction=desc&accumulation=total&group=summary' \
  -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 of a football competition
season	string	Yes	96668	Numeric SofaScore season id
order	string	No	rating	Statistic to sort by. Defaults to rating
direction	string	No	desc	Sort direction. Defaults to desc
accumulation	string	No	total	How statistics are accumulated. Defaults to total
group	string	No	summary	Statistic columns returned. Defaults to summary
limit	integer	No		Rows per page, 1 to 100. Defaults to 20
offset	integer	No		Rows to skip. Defaults to 0
team	array	No		Team ids to keep, comma separated, up to 20 (ids from tournament-statistics-info or tournament-teams)
nationality	array	No		Nationality codes to keep, comma separated, up to 20 (codes from tournament-statistics-info)
position	array	No		Position codes to keep, comma separated
min_appearances	integer	No		Keep players with at least this many appearances, 0 to 1000. Omit for no minimum
min_minutes	integer	No		Keep players with at least this many minutes played, 0 to 100000. Omit for no minimum

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "tournament_id": 17,
    "season_id": 96668,
    "order": "rating",
    "direction": "desc",
    "accumulation": "total",
    "group": "attack",
    "limit": 2,
    "offset": 0,
    "page": 1,
    "total_pages": 211,
    "has_next_page": true,
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/statistics?accumulation=total&group=attack&limit=2&order=-rating",
    "fetched_at": "2026-10-07T14:00:00Z",
    "players": [
      {
        "rank": 1,
        "player": {
          "id": 1142315,
          "name": "Jack Hinshelwood",
          "slug": "jack-hinshelwood"
        },
        "team": {
          "id": 30,
          "name": "Brighton & Hove Albion",
          "slug": "brighton-and-hove-albion"
        },
        "statistics": {
          "goals": 2,
          "expectedGoals": 1.41,
          "bigChancesMissed": 0,
          "successfulDribbles": 1,
          "totalShots": 3,
          "goalConversionPercentage": 66.67,
          "rating": 9
        }
      }
    ]
  }
}

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

GETapiKey1 credit/requestsofascore.tournamentPlayerStatisticsResponseDocSofaScore

GET /sofascore/tournament-player-statistics

SofaScore season player statistics table

Response behavior

- Values outside the enums above are rejected with 400 before a request is made. SofaScore itself silently ignores unknown values and answers with default data, which is why they are validated here. - `rank` continues from `offset` (the first row of `offset=40` is rank 41). `page`, `total_pages` and `has_next_page` describe the table at the requested `limit`. - `statistics` is a map of the group's columns; a statistic SofaScore has no value for is `null` rather than `0` (for example `expectedGoals` for a player with no tracked shots). The table is not filtered by a minimum number of appearances, so a player with one match can top `rating`. - Filters combine: different filters are joined with AND (`position=G&team=42` is Arsenal's goalkeepers) and several values of one filter with OR (`team=42,17` is Arsenal and Manchester City). The applied filters are echoed in `filters` (`team_ids`, `nationalities`, `positions`, `min_appearances`, `min_minutes`) and are omitted when none were given. A filter that matches nobody (an unknown nationality code, a team that is not in the season, a minimum nobody reaches) returns an empty `players` list with a 200 instead of the 404 below. Team ids, nationality codes and positions are checked for format before the request; SofaScore itself does not report unknown values. - Competitions of other sports return no rows, which is reported as 404 (without filters). An offset past the last row returns an empty `players` list. - The `order` values were verified against the Premier League 2026/27 table; `perGame` and `per90` ordering was verified with `rating`. - The filters were verified on the Premier League 2025/26 and 2026/27 tables and the Champions League 2025/26 table: `position` (`G`, `D`, `M`, `F` each returned only that position), `team`, `nationality`, and the minimums (ascending order started at exactly the minimum: 30 appearances, 31 for a strict greater-than, and 2503 minutes for `min_minutes=2500`). Filters are football only. Example response (shortened): ```json { "code": 200, "msg": "OK", "data": { "tournament_id": 17, "season_id": 96668, "order": "rating", "direction": "desc", "accumulation": "total", "group": "attack", "limit": 2, "offset": 0, "page": 1, "total_pages": 211, "has_next_page": true, "count": 1, "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/statistics?accumulation=total&group=attack&limit=2&order=-rating", "fetched_at": "2026-10-07T14:00:00Z", "players": [ { "rank": 1, "player": { "id": 1142315, "name": "Jack Hinshelwood", "slug": "jack-hinshelwood" }, "team": { "id": 30, "name": "Brighton & Hove Albion", "slug": "brighton-and-hove-albion" }, "statistics": { "goals": 2, "expectedGoals": 1.41, "bigChancesMissed": 0, "successfulDribbles": 1, "totalShots": 3, "goalConversionPercentage": 66.67, "rating": 9 } } ] } } ```

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) id of a football competitionseason

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,
    "order": "rating",
    "direction": "desc",
    "accumulation": "total",
    "group": "attack",
    "limit": 2,
    "offset": 0,
    "page": 1,
    "total_pages": 211,
    "has_next_page": true,
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/statistics?accumulation=total&group=attack&limit=2&order=-rating",
    "fetched_at": "2026-10-07T14:00:00Z",
    "players": [
      {
        "rank": 1,
        "player": {
          "id": 1142315,
          "name": "Jack Hinshelwood",
          "slug": "jack-hinshelwood"
        },
        "team": {
          "id": 30,
          "name": "Brighton & Hove Albion",
          "slug": "brighton-and-hove-albion"
        },
        "statistics": {
          "goals": 2,
          "expectedGoals": 1.41,
          "bigChancesMissed": 0,
          "successfulDribbles": 1,
          "totalShots": 3,
          "goalConversionPercentage": 66.67,
          "rating": 9
        }
      }
    ]
  }
}

Try the SofaScore Player Season Stats API

What a live request returned

14 Oct 2026: 40 players; 4 fields had a value in every checked item.

Observed request: GET /sofascore/tournament-player-statistics?id=17&limit=40&order=goals&season=96668
Fields with a value in every checked item: rank, player, team, statistics

Sample value profiles: rank: 1 to 40, median 20.

Request: GET /sofascore/tournament-player-statistics
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 0.97 s
Monitored request: GET /sofascore/tournament-player-statistics?id=17&limit=5&order=goals&season=96668

SofaScore Player Season Stats API documentation SofaScore platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/sofascore/tournament-player-statistics?id=17&season=96668&order=rating&direction=desc&accumulation=total&group=summary' \
  -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 of a football competition
season	string	Yes	96668	Numeric SofaScore season id
order	string	No	rating	Statistic to sort by. Defaults to rating
direction	string	No	desc	Sort direction. Defaults to desc
accumulation	string	No	total	How statistics are accumulated. Defaults to total
group	string	No	summary	Statistic columns returned. Defaults to summary
limit	integer	No		Rows per page, 1 to 100. Defaults to 20
offset	integer	No		Rows to skip. Defaults to 0
team	array	No		Team ids to keep, comma separated, up to 20 (ids from tournament-statistics-info or tournament-teams)
nationality	array	No		Nationality codes to keep, comma separated, up to 20 (codes from tournament-statistics-info)
position	array	No		Position codes to keep, comma separated
min_appearances	integer	No		Keep players with at least this many appearances, 0 to 1000. Omit for no minimum
min_minutes	integer	No		Keep players with at least this many minutes played, 0 to 100000. Omit for no minimum

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "tournament_id": 17,
    "season_id": 96668,
    "order": "rating",
    "direction": "desc",
    "accumulation": "total",
    "group": "attack",
    "limit": 2,
    "offset": 0,
    "page": 1,
    "total_pages": 211,
    "has_next_page": true,
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/statistics?accumulation=total&group=attack&limit=2&order=-rating",
    "fetched_at": "2026-10-07T14:00:00Z",
    "players": [
      {
        "rank": 1,
        "player": {
          "id": 1142315,
          "name": "Jack Hinshelwood",
          "slug": "jack-hinshelwood"
        },
        "team": {
          "id": 30,
          "name": "Brighton & Hove Albion",
          "slug": "brighton-and-hove-albion"
        },
        "statistics": {
          "goals": 2,
          "expectedGoals": 1.41,
          "bigChancesMissed": 0,
          "successfulDribbles": 1,
          "totalShots": 3,
          "goalConversionPercentage": 66.67,
          "rating": 9
        }
      }
    ]
  }
}

SofaScore season player statistics table

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, "order": "rating", "direction": "desc", "accumulation": "total", "group": "attack", "limit": 2, "offset": 0, "page": 1, "total_pages": 211, "has_next_page": true, "count": 1, "source_url": "https://api.sofascore.com/api/v1/unique-tournament/17/season/96668/statistics?accumulation=total&group=attack&limit=2&order=-rating", "fetched_at": "2026-10-07T14:00:00Z", "players": [ { "rank": 1, "player": { "id": 1142315, "name": "Jack Hinshelwood", "slug": "jack-hinshelwood" }, "team": { "id": 30, "name": "Brighton & Hove Albion", "slug": "brighton-and-hove-albion" }, "statistics": { "goals": 2, "expectedGoals": 1.41, "bigChancesMissed": 0, "successfulDribbles": 1, "totalShots": 3, "goalConversionPercentage": 66.67, "rating": 9 } } ] } }