1 of 5

Statistics

Welcome to the tutorial about statistics. At Sportmonks we have plenty of statistics to offer you, such as match, team, season, player and in-play player statistics.

In this tutorial, we will go through every option one by one.

Let’s get started.

We recommend you submit your requests with Postman since we have already prepared the request for you there! Hit the button below to import our Football API collection.

Match statistics

One of the most frequently asked questions is: “How can I get match statistics just like below?”.

Please note that above is just a snippet of the match stats we cover.

There are many possible ways, thanks to the flexibility of our API.

As you've seen in our previous tutorials, every fixture has a unique id. Therefore, you can use one of our fixtures by id endpoints, or you can request them by date. In our fixtures tutorial, we’ve discussed all the different ways to access fixtures.

Now, as you have read in our includes tutorial, you can enrich the API response. If you want statistics, you can add the include stats.

https://soccer.sportmonks.com/api/v2.0/fixtures/16475287?api_token={API_TOKEN}&include=stats

        "stats": {
            "data": [
                {
                    "team_id": 53,
                    "fixture_id": 16475287,
                    "shots": {
                        "total": 28,
                        "ongoal": 15,
                        "blocked": 6,
                        "offgoal": 13,
                        "insidebox": 18,
                        "outsidebox": 7
                    },
                    "passes": {
                        "total": 670,
                        "accurate": 587,
                        "percentage": 87.61
                    },
                    "attacks": {
                        "attacks": 115,
                        "dangerous_attacks": 55
                    },
                    "fouls": 9,
                    "corners": 11,
                    "offsides": 0,
                    "possessiontime": 80,
                    "yellowcards": 1,
                    "redcards": 0,
                    "yellowredcards": 0,
                    "saves": 1,
                    "substitutions": 4,
                    "goal_kick": null,
                    "goal_attempts": 19,
                    "free_kick": null,
                    "throw_in": null,
                    "ball_safe": 91,
                    "goals": 5,
                    "penalties": 0,
                    "injuries": 0
                },
                {
                    "team_id": 338,
                    "fixture_id": 16475287,
                    "shots": {
                        "total": 6,
                        "ongoal": 2,
                        "blocked": 1,
                        "offgoal": 4,
                        "insidebox": 4,
                        "outsidebox": 3
                    },
                    "passes": {
                        "total": 157,
                        "accurate": 85,
                        "percentage": 54.14
                    },
                    "attacks": {
                        "attacks": 70,
                        "dangerous_attacks": 41
                    },
                    "fouls": 9,
                    "corners": 8,
                    "offsides": 2,
                    "possessiontime": 20,
                    "yellowcards": 3,
                    "redcards": 0,
                    "yellowredcards": 0,
                    "saves": 9,
                    "substitutions": 3,
                    "goal_kick": null,
                    "goal_attempts": 7,
                    "free_kick": null,
                    "throw_in": null,
                    "ball_safe": 67,
                    "goals": 1,
                    "penalties": 0,
                    "injuries": 1
                }
            ]
        }

Stats Field Description

Nothing more, nothing less.

Live Match statistics

Let’s say you want the statistics of matches that are currently live. As you know you can use our livescores/now endpoint to request all the in-play fixtures:

The only thing you need to do is to add the stats include:

https://soccer.sportmonks.com/api/v2.0/livescores/now?api_token={API_TOKEN}&include=stats

The stats include will enrich your response with all the match statistics of all games that are currently live. If you only want to have stats for certain live fixtures, then you can filter. For instance, if you only want all the live matches from the English Premier League (league id: 8) with stats, you can use this request:

https://soccer.sportmonks.com/api/v2.0/livescores/now?api_token={API_TOKEN}&include=stats&leagues=8

Team statistics

It’s possible to request statistics per team. This could be really interesting if you want to build a football application showing all the statistics of your favorite team. Requesting team statistics is easy!

Simply, use the team by id endpoint and once again use the include stats. For this example, we’ll request the team statistics of Real Madrid (team id: 3468):

https://soccer.sportmonks.com/api/v2.0/teams/3468?api_token={API_TOKEN}&include=stats

Be aware that this request will give you all the team statistics of the seasons the team has played or is active in. Therefore, it might be useful to add a filter to only request the team statistics of the season you’re interested in.

For example, the request below will return all the team statistics of Real Madrid, but only for the Spanish La Liga 2019/2020 season (season id: 16326).

https://soccer.sportmonks.com/api/v2.0/teams/3468?api_token={API_TOKEN}&include=stats&seasons=16326

{
    "data": {
        "id": 3468,
        "legacy_id": 117,
        "name": "Real Madrid",
        "short_code": "RMA",
        "twitter": "@realmadrid",
        "country_id": 32,
        "national_team": false,
        "founded": 1902,
        "logo_path": "https://cdn.sportmonks.com/images//soccer/teams/12/3468.png",
        "venue_id": 2020,
        "current_season_id": 17480,
        "is_placeholder": false,
        "stats": {
            "data": [
                {
                    "team_id": 3468,
                    "season_id": 16326,
                    "stage_id": 77444988,
                    "win": {
                        "total": 26,
                        "home": 15,
                        "away": 11
                    },
                    "draw": {
                        "total": 9,
                        "home": 4,
                        "away": 5
                    },
                    "lost": {
                        "total": 3,
                        "home": 0,
                        "away": 3
                    },
                    "goals_for": {
                        "total": 70,
                        "home": 40,
                        "away": 30
                    },
                    "goals_against": {
                        "total": 25,
                        "home": 11,
                        "away": 14
                    },
                    "clean_sheet": {
                        "total": 19,
                        "home": 11,
                        "away": 8
                    },
                    "failed_to_score": {
                        "total": 6,
                        "home": 2,
                        "away": 4
                    },
                    "scoring_minutes": [
                        {
                            "period": [
                                {
                                    "minute": "0-15",
                                    "count": 8,
                                    "percentage": 11.4
                                },
                                {
                                    "minute": "15-30",
                                    "count": 9,
                                    "percentage": 12.9
                                },
                                {
                                    "minute": "30-45",
                                    "count": 13,
                                    "percentage": 18.6
                                },
                                {
                                    "minute": "45-60",
                                    "count": 10,
                                    "percentage": 14.3
                                },
                                {
                                    "minute": "60-75",
                                    "count": 15,
                                    "percentage": 21.4
                                },
                                {
                                    "minute": "75-90",
                                    "count": 15,
                                    "percentage": 21.4
                                }
                            ]
                        }
                    ],
                    "goals_conceded_minutes": [
                        {
                            "period": [
                                {
                                    "minute": "0-15",
                                    "count": 5,
                                    "percentage": 20
                                },
                                {
                                    "minute": "15-30",
                                    "count": 0,
                                    "percentage": 0
                                },
                                {
                                    "minute": "30-45",
                                    "count": 2,
                                    "percentage": 8
                                },
                                {
                                    "minute": "45-60",
                                    "count": 3,
                                    "percentage": 12
                                },
                                {
                                    "minute": "60-75",
                                    "count": 5,
                                    "percentage": 20
                                },
                                {
                                    "minute": "75-90",
                                    "count": 10,
                                    "percentage": 40
                                }
                            ]
                        }
                    ],
                    "avg_goals_per_game_scored": {
                        "total": 1.84,
                        "home": 2.11,
                        "away": 1.58
                    },
                    "avg_goals_per_game_conceded": {
                        "total": 0.66,
                        "home": 0.58,
                        "away": 0.74
                    },
                    "avg_first_goal_scored": {
                        "total": "42m",
                        "home": "39m",
                        "away": "45m"
                    },
                    "avg_first_goal_conceded": {
                        "total": "52m",
                        "home": "51m",
                        "away": "53m"
                    },
                    "attacks": 4557,
                    "dangerous_attacks": 2466,
                    "avg_ball_possession_percentage": "59.00",
                    "fouls": 476,
                    "avg_fouls_per_game": "12.53",
                    "offsides": 84,
                    "redcards": 4,
                    "yellowcards": 82,
                    "shots_blocked": 19,
                    "shots_off_target": 335,
                    "avg_shots_off_target_per_game": "8.82",
                    "shots_on_target": 229,
                    "avg_shots_on_target_per_game": "6.03",
                    "avg_corners": "5.05",
                    "total_corners": 192,
                    "btts": 44.74,
                    "goal_line": {
                        "over": {
                            "0_5": {
                                "home": 89.47,
                                "away": 89.47
                            },
                            "1_5": {
                                "home": 78.95,
                                "away": 57.89
                            },
                            "2_5": {
                                "home": 47.37,
                                "away": 52.63
                            },
                            "3_5": {
                                "home": 31.58,
                                "away": 26.32
                            },
                            "4_5": {
                                "home": 15.79,
                                "away": 5.26
                            },
                            "5_5": {
                                "home": 5.26,
                                "away": 0
                            }
                        },
                        "under": {
                            "0_5": {
                                "home": 10.53,
                                "away": 10.53
                            },
                            "1_5": {
                                "home": 21.05,
                                "away": 42.11
                            },
                            "2_5": {
                                "home": 52.63,
                                "away": 47.37
                            },
                            "3_5": {
                                "home": 68.42,
                                "away": 73.68
                            },
                            "4_5": {
                                "home": 84.21,
                                "away": 94.74
                            },
                            "5_5": {
                                "home": 94.74,
                                "away": 100
                            }
                        }
                    },
                    "avg_player_rating": 6.81,
                    "avg_player_rating_per_match": 6.82,
                    "tackles": null
                }
            ]
        }
    },

Team Field Description

Team Stats Field Description

Player statistics

You've just learnt how you can request match and team statistics. Now, we’re going to request the statistics of one specific player.

For this example, we’ll go with Robert Lewandowski (player id: 31000). The endpoint you'll need to use is our player by id endpoint. Just like with the match and team stats, you'll only need to use the stats include.

 https://soccer.sportmonks.com/api/v2.0/players/31000?api_token={API_TOKEN}&include=stats

Be aware that, just like with the team statistics, this request will give you all the player statistics of the seasons the player has played or is active in. If you only want the player’s statistics of one particular season, you can filter on it.

For example, below request return the statistics of Robert Lewandowski for his German Bundesliga 2019/2020 season (season id: 16264)

 https://soccer.sportmonks.com/api/v2.0/players/31000?api_token={API_TOKEN}&include=stats&seasons=16264

{
    "data": {
        "player_id": 31000,
        "team_id": 503,
        "country_id": 2,
        "position_id": 4,
        "common_name": "R. Lewandowski",
        "display_name": "Robert Lewandowski",
        "fullname": "Robert Lewandowski",
        "firstname": "Robert",
        "lastname": "Lewandowski",
        "nationality": "Poland",
        "birthdate": "21/08/1988",
        "birthcountry": "Poland",
        "birthplace": "Warszawa",
        "height": "184 cm",
        "weight": "80 kg",
        "image_path": "https://cdn.sportmonks.com/images/soccer/players/24/31000.png",
        "stats": {
            "data": [
                {
                    "player_id": 31000,
                    "team_id": 503,
                    "league_id": 82,
                    "season_id": 16264,
                    "captain": 0,
                    "minutes": 2761,
                    "appearences": 31,
                    "lineups": 31,
                    "substitute_in": 0,
                    "substitute_out": 2,
                    "substitutes_on_bench": 0,
                    "goals": 34,
                    "owngoals": 0,
                    "assists": 4,
                    "saves": 0,
                    "inside_box_saves": 0,
                    "dispossesed": 0,
                    "interceptions": 7,
                    "yellowcards": 5,
                    "yellowred": 0,
                    "redcards": 0,
                    "type": "domestic",
                    "tackles": 17,
                    "blocks": 1,
                    "hit_post": 3,
                    "cleansheets": 13,
                    "rating": "7.67",
                    "fouls": {
                        "committed": 32,
                        "drawn": 43
                    },
                    "crosses": {
                        "total": 22,
                        "accurate": 10
                    },
                    "dribbles": {
                        "attempts": 88,
                        "success": 57,
                        "dribbled_past": 12
                    },
                    "duels": {
                        "total": 86,
                        "won": 34
                    },
                    "passes": {
                        "total": 561,
                        "accuracy": 73,
                        "key_passes": 36
                    },
                    "penalties": {
                        "won": 1,
                        "scores": 5,
                        "missed": null,
                        "committed": null,
                        "saves": null
                    }
                }
            ]
        }
    },

Player Field Description

Player Stats Field Description

Live Player statistics

You might notice that the stats include on our fixtures/livescores endpoint will only provide you with statistics of the match. But, where are the player statistics? Great question! The player statistics are available via the lineup include.

The lineup include will provide you with the starting eleven of both teams. Next to that, each player will also have an array of stats.

For example, below you can view the in-play stats of Marcus Rashford in the Champions League match PSG – United.

https://soccer.sportmonks.com/api/v2.0/livescores/now?api_token={API_TOKEN}&include=lineup.player

{
                    "team_id": 14,
                    "fixture_id": 17361246,
                    "player_id": 1878,
                    "player_name": "Marcus Rashford",
                    "number": 10,
                    "position": "A",
                    "additional_position": null,
                    "formation_position": 11,
                    "posx": null,
                    "posy": null,
                    "captain": false,
                    "type": "lineup",
                    "stats": {
                        "shots": {
                            "shots_total": 4,
                            "shots_on_goal": 3
                        },
                        "goals": {
                            "scored": 1,
                            "assists": 0,
                            "conceded": 0,
                            "owngoals": 0
                        },
                        "fouls": {
                            "drawn": 0,
                            "committed": 0
                        },
                        "cards": {
                            "yellowcards": 0,
                            "redcards": 0,
                            "yellowredcards": 0
                        },
                        "passing": {
                            "total_crosses": 0,
                            "crosses_accuracy": 0,
                            "passes": 22,
                            "accurate_passes": 17,
                            "passes_accuracy": 77,
                            "key_passes": 1
                        },
                        "dribbles": {
                            "attempts": 7,
                            "success": 2,
                            "dribbled_past": 1
                        },
                        "duels": {
                            "total": 14,
                            "won": 3
                        },
                        "other": {
                            "aerials_won": 0,
                            "punches": 0,
                            "offsides": 0,
                            "saves": 0,
                            "inside_box_saves": 0,
                            "pen_scored": 0,
                            "pen_missed": 0,
                            "pen_saved": 0,
                            "pen_committed": 0,
                            "pen_won": 0,
                            "hit_woodwork": 0,
                            "tackles": 1,
                            "blocks": 0,
                            "interceptions": 0,
                            "clearances": 2,
                            "dispossesed": 1,
                            "minutes_played": 90
                        },
                        "rating": "7.65"
                    },
                    "player": {
                        "data": {
                            "player_id": 1878,
                            "team_id": 14,
                            "country_id": 462,
                            "position_id": 4,
                            "common_name": "M. Rashford",
                            "display_name": "Marcus Rashford",
                            "fullname": "Marcus Rashford",
                            "firstname": "Marcus",
                            "lastname": "Rashford",
                            "nationality": "England",
                            "birthdate": "31/10/1997",
                            "birthcountry": "England",
                            "birthplace": "Manchester",
                            "height": "180 cm",
                            "weight": "70 kg",
                            "image_path": "https://cdn.sportmonks.com/images/soccer/players/22/1878.png"
                        }
                    }
                },

As you can see the lineup include will return all the statistics of the players in the match. Furthermore, we used the nested include.playerto include some basic player information. More information about nested includes can be found in our nested include tutorial.

If you also want access to stats from players who were substituted later on, you will need to use thebenchinclude as well.

Season statistics

Last but not least: we offer season statistics. We calculate a wide range of stats for you like the number of matches, matches played, goals scored, clean sheets, yellow cards, average goals per minute, etc

To request this, you can use our season by id endpoint with the include stats. The response below will give you all the season statistics of the Bundesliga 2019/2020 ( id: 16264) season.

https://soccer.sportmonks.com/api/v2.0/seasons/16264?api_token={API_TOKEN}&include=stats

{
    "data": {
        "id": 16264,
        "name": "2019/2020",
        "league_id": 82,
        "is_current_season": false,
        "current_round_id": null,
        "current_stage_id": null,
        "stats": {
            "data": {
                "id": 1211,
                "season_id": 16264,
                "league_id": 82,
                "number_of_clubs": 18,
                "number_of_matches": 306,
                "number_of_matches_played": 306,
                "number_of_goals": 982,
                "matches_both_teams_scored": 178,
                "number_of_yellowcards": 1192,
                "number_of_yellowredcards": 35,
                "number_of_redcards": 20,
                "avg_goals_per_match": 3.21,
                "avg_yellowcards_per_match": 3.9,
                "avg_yellowredcards_per_match": 0.11,
                "avg_redcards_per_match": 0.07,
                "team_with_most_goals_id": 503,
                "team_with_most_goals_number": 100,
                "team_with_most_conceded_goals_id": 2642,
                "team_with_most_conceded_goals_number": 74,
                "team_with_most_goals_per_match_id": 503,
                "team_with_most_goals_per_match_number": 2.94,
                "season_topscorer_id": 31000,
                "season_topscorer_number": 34,
                "season_assist_topscorer_id": 30286,
                "season_assist_topscorer_number": 21,
                "team_most_cleansheets_id": 503,
                "team_most_cleansheets_number": 15,
                "goals_scored_minutes": {
                    "0-15": "12.41%",
                    "15-30": "13.43%",
                    "30-45": "15.06%",
                    "45-60": "20.85%",
                    "60-75": "17.29%",
                    "75-90": "24.42%"
                },
                "goalkeeper_most_cleansheets_id": 30642,
                "goalkeeper_most_cleansheets_number": 15,
                "goal_scored_every_minutes": 28,
                "btts": 58.17,
                "goal_line": {
                    "over": {
                        "0_5": 96.08,
                        "1_5": 85.62,
                        "2_5": 65.03,
                        "3_5": 41.5,
                        "4_5": 19.93,
                        "5_5": 9.48
                    },
                    "under": {
                        "0_5": 3.92,
                        "1_5": 14.38,
                        "2_5": 34.97,
                        "3_5": 58.5,
                        "4_5": 80.07,
                        "5_5": 90.52
                    }
                },
                "avg_corners_per_match": 10.1,
                "team_most_corners_count": 240,
                "team_most_corners_id": 503,
                "goals_conceded": {
                    "all": 1.6,
                    "home": 1.55,
                    "away": 1.66
                },
                "goals_scored": {
                    "all": 1.6,
                    "home": 1.66,
                    "away": 1.55
                },
                "win_percentage": {
                    "all": 38.89,
                    "home": 40.2,
                    "away": 37.58
                },
                "defeat_percentage": {
                    "all": 38.89,
                    "home": 37.58,
                    "away": 40.2
                },
                "draw_percentage": 22.22,
                "avg_homegoals_per_match": 1.66,
                "avg_awaygoals_per_match": 1.55,
                "avg_player_rating": 6.7,
                "updated_at": {
                    "date": "2020-11-10 08:15:24.000000",
                    "timezone_type": 3,
                    "timezone": "UTC"
                }
            }
        }
    },

Season Field Description

Season Stats Field Description

And that rounds up the tutorial about statistics.

Interested in the detailed team or player level? Please note that you can use the below includes to add this information:

stats.topscorer, stats.assisttopscorer, stats.mostcleansheetsteam, stats.mostcleansheetsgoalkeeper, stats.mostgoalsteam, stats.mostgoalspermatchteam, stats.mostconcededgoalsteam, stats.mostcornersteam

In our next extra tutorial, we’re going to discuss standings.