SofaScore Player Season Stats API

Endpoint facts

Method

GET

API path

/sofascore/tournament-player-statistics

Auth

apiKey

Credits

1 credit/request

Charged on

Successful 2xx responses only

Platform

SofaScore

Response schema

#/definitions/sofascore.tournamentPlayerStatisticsResponseDoc

How this endpoint behaves

Query parameters:

• id: required. Numeric SofaScore unique-tournament (competition) id of a football competition, e.g. 17 for the Premier League.
• season: required. Numeric SofaScore season id from sofascore/tournament-seasons, e.g. 96668.
• order: optional enum, the statistic to sort by. Allowed values: rating, goals, expectedGoals, assists, successfulDribbles, tackles, accuratePassesPercentage, bigChancesMissed, totalShots, goalConversionPercentage, interceptions, clearances, errorLeadToGoal, outfielderBlocks, bigChancesCreated, accuratePasses, keyPasses, saves, cleanSheet, penaltySave, savedShotsFromInsideTheBox, runsOut. Defaults to rating. Any statistic can be used with any group.
• direction: optional enum. Allowed values: desc (highest first), asc (lowest first). Defaults to desc.
• accumulation: optional enum. Allowed values: total (season totals), perGame (average per match), per90 (average per 90 minutes). Defaults to total.
• group: optional enum, which statistic columns each row carries. Allowed values: summary, attack, defence, passing, goalkeeper. Defaults to summary.
• limit: optional integer, 1 to 100. Rows per page. Defaults to 20.
• offset: optional integer, 0 or more. Rows to skip. Defaults to 0.
• team: optional. Comma-separated numeric team ids (up to 20); keeps only those teams' players, for example 42,17. The ids come from sofascore/tournament-statistics-info (or sofascore/tournament-teams).
• nationality: optional. Comma-separated two-letter SofaScore nationality codes (up to 20), for example EN,ES; keeps only players of those nationalities. The codes of a season come from sofascore/tournament-statistics-info; SofaScore uses EN for England, SX for Scotland, WA for Wales and NX for Northern Ireland.
• position: optional enum list, comma-separated. Allowed values: G (goalkeeper), D (defender), M (midfielder), F (forward), for example G,D.
• min_appearances: optional integer, 0 to 1000. Keeps only players with at least this many appearances in the season. 0 or omitted means no minimum.
• min_minutes: optional integer, 0 to 100000. Keeps only players with at least this many minutes played in the season. 0 or omitted means no minimum.

Group columns:

• summary: goals, expectedGoals, successfulDribbles, tackles, assists, accuratePassesPercentage, rating.
• attack: goals, expectedGoals, bigChancesMissed, successfulDribbles, totalShots, goalConversionPercentage, rating.
• defence: tackles, interceptions, clearances, errorLeadToGoal, outfielderBlocks, rating.
• passing: bigChancesCreated, assists, accuratePasses, accuratePassesPercentage, keyPasses, rating.
• goalkeeper: saves, cleanSheet, penaltySave, savedShotsFromInsideTheBox, runsOut, rating.

Notable 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):

{
  "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 }
      }
    ]
  }
}

Live monitoring

Monitored request

GET /sofascore/tournament-player-statistics?id=17&limit=5&order=goals&season=96668

Checks passed, 7 days to 14 Oct 2026

100%

Median response time

0.97 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026

GET /sofascore/tournament-player-statistics?id=17&limit=40&order=goals&season=96668

Items in players

40

Fields filled in every checked item

4

Shared guides

Related