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. The plans column lists the plans that include the operation for the leagues they cover; Free plans carry the Standard datasets. A plan outside the list receives 403 with meta.msg = Endpoint not available for your plan.

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 — Standard, World Cup
season League statistics by season. Season totals such as goals, cards and goal lines. id — 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 — 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 Standard, World Cup
match Match statistics. Team statistics of one match, one entry per team. id — 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