Season Statistics

What Sportmonks provides

Sportmonks provides pre-aggregated season statistics for teams and players in all leagues within your plan. These totals automatically update with each new match.

Season statistics available through the Football API v3 include:

– Total goals scored and conceded
– Total cards (yellow and red)
– Clean sheets and failed to score counts.
– Total corners, attacks, and dangerous attacks
– Shots and shots on target
– Duels won and through balls.
– Matches played, wins, draws, and losses.
– Both teams scored (BTTS) count.
– Average goals per minute
– Top scorer, top assist provider, top card collector, and top-rated player per competition
– Total number of teams, referees, and matches in the competition

Each statistic has a unique type ID, which you can use to filter responses down to only the metrics you need.

Endpoints

The most common way to retrieve season statistics is via the seasons endpoint with the statistics include parameter. Dedicated statistics endpoints are also available, allowing you to retrieve statistics directly without having to propagate them through includes.

Via the seasons endpoint:

GET https://api.sportmonks.com/v3/football/seasons/{season_id}?api_token=YOUR_TOKEN&include=statistics

GET https://api.sportmonks.com/v3/football/seasons/19735?api_token=YOUR_TOKEN&include=statistics.type

Filtering season statistics

The API returns a broad set of season statistics by default, but you can narrow responses down to only the types you need using the seasonStatisticTypes filter with the relevant type IDs.

For example, to retrieve only goals (191), cards (193), and clean sheets (194) for the Scottish Premiership 2022/2023 season:

GET https://api.sportmonks.com/v3/football/seasons/19735?api_token=YOUR_TOKEN&include=statistics.type&filters=seasonStatisticTypes:191,193,194

A full reference of all season statistic type IDs is available in the Sportmonks Football API v3 documentation under Season Statistics Types Reference.

Filtering to active seasons only

When requesting player or team data with a statistics include, you can use the currentSeasons filter to restrict results to only active seasons. This is particularly useful when building features that should only surface current-season performance rather than all historical records:

GET https://api.sportmonks.com/v3/football/players?api_token=YOUR_TOKEN&include=statistics&filters=currentSeasons:playerStatistic

What you can build with season statistics

Season statistics are the backbone of a wide range of product features:

– League summary pages — cumulative goals, cards, clean sheets, and attacking stats across all teams in a competition
– Player leaderboards — rank players by goals, assists, or cards across the full season
– Performance dashboards — track how a team’s totals evolve over the course of a campaign
– Season-over-season comparisons — compare aggregated metrics across multiple historical seasons to identify trends
– Predictive modelling — season-level aggregations are a key input for machine learning models used in match prediction and expected goals calculation
– Fantasy football — season-long player statistics are essential for calculating cumulative fantasy points and ranking players for selection

Availability

Season statistics are included in all Starter, Growth, Pro, and Enterprise plans. All plans include the same professional-grade data ; the differences between plans are the number of leagues you can select and your hourly API call limit. Historical season statistics older than 3 seasons are available via the historical data add-on, with a one-time fee of € 29 for Starter subscribers. Enterprise plans include full historical access by default.

You can explore and test the season statistics endpoints using the Postman collection or the API tester in MySportmonks. Full documentation, including the complete list of statistic type IDs, is available in the Sportmonks Football API v3 docs.

Try it free ; all paid plans include a 14-day free trial, and the forever-free plan gives you immediate access to the Danish Superliga and Scottish Premiership with no credit card required.