SoccersAPIDocsv2.2
Docs/Reference/Statistics

Statistics

Aggregated statistics for leagues, seasons, teams and players, and per-match statistics. The meaning of id depends on the operation.

Open in the interactive reference

Operations

Route reference

Operations

The t query parameter selects the operation. Parameters not listed for an operation are ignored. Plans are listed explicitly for each operation; league coverage and request limits still apply. An include requires both access to the base operation and access to that dataset. See Plans and Data Access.

t Operation Required Optional Plans
league League statistics, current season. Season totals of the current season of a league: matches, goals, cards, clean sheets, goal ranges and goal lines. id — Free, Standard, World Cup
season League statistics by season. Season totals such as goals, cards and goal lines. id — Free, Standard, World Cup
team Team statistics by season. Goals scored and conceded, clean sheets, cards and goal ranges of a team in a season. id, season_id — Free, Standard, World Cup
player Player statistics. Season statistics with id and season_id, or single-match statistics with player_id and match_id. — id, season_id, player_id, match_id, lang Free, Standard, World Cup
match Match statistics. Team statistics of one match, one entry per team. id — Free, Standard, World Cup

Examples

League statistics, current season:

GET /v2.2/stats/?api_key=API_KEY&t=league&id=1005

League statistics by season:

GET /v2.2/stats/?api_key=API_KEY&t=season&id=12588

Team statistics by season:

GET /v2.2/stats/?api_key=API_KEY&t=team&id=98&season_id=406

Player statistics:

GET /v2.2/stats/?api_key=API_KEY&t=player&id=18103&season_id=12516

Match statistics:

GET /v2.2/stats/?api_key=API_KEY&t=match&id=2589310