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.

A snippet of Kevin De Bruyne's stats from the 2020/2021 season of the English Premier League

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)

Request

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

Response

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

Field Description

Player Field Description

Field	Description
player_id	The unique id of the main player
team_id	The unique id of the team the player belongs to
country_id	The unique id of the country the player is from
position_id	The unique id of the position the player plays in
common_name	The common name the player is known for
display_name	The display name of the player. Often used to show in the lineup formation
fullname	The full name of the player
firstname	The first name of the player
lastname	The last name of the player
nationality	The nationality of the player
birthdate	The date of birth of the player
birthcountry	The country the player was born in
birthplace	The place the player was born in
height	The height of the player
weight	The weight of the player
image_path	The URL of the player image

Player Stats Field Description

Field	Description
player_id	The unique id of the player
team_id	The unique id of the team the player plays for
league_id	The unique id of the league the season belongs to
season_id	The unique id of the season you've requested the stats for
captain	The total number of times the player was captain in the requested season
minutes	The total number of minutes played in the requested season
appearences	The total number of appearences in the requested season
lineups	The total number of times the player was included in the lineup in the requested season
substitute_in	The total number of times the player was substituted into the field in the requested season
substitute_out	The total number of times the player was substituted off the field in the requested season
substitutes_on_bench	Number of times the player is in the squad, but starts a match on the bench
goals	The total number of goals the player has scored in the requested season
owngoals	The total number of own goals the player has scored in the requested season
assists	The total number of assists the player has given in the requested season
saves	The total number of saves the player has made. (only available for goalkeepers.)
inside_box_saves	The total number of inside the box (the goalkeeper area) saves the player has made. (only available for goalkeepers)
dispossesed	The total number of times the player was dispossesed in the requested season
interceptions	The total number of interceptions the player has made in the requested season
yellowcards	The total number of yellow cards the player has received in the requested season
yellowred	The total number of yellow-red cards the player has received in the requested season. In other words: if the player received a second yellow card that resulted in a red card.
redcards	The total number of red cards the player has received in the requested season
type	The season type
tackles	The total number of tackles the player has made in the requested season
blocks	The total number of blocks the player has made in the requested season
hit_post	The total number of times the player has hit the woodwork in the requested season
cleansheets	The total number of times the player has maintained a clean sheet in the requested season
rating	The average player rating in the requested season
fouls	Opens an array containing information about the fouls committed and drawn in the requested season
crosses	Opens an array containing information about the crosses the player has made in the requested season. Divided by total and accurate
dribbles	Opens an array containing information about dribbles the player was involved with in the requested season. Divided by attempts, success and the times an opponent dribbled past him
duels	Opens an array containing information about the duels the player was involved with in the requested season. Divided by total and won.
passes	Opens an array containing information about the passes the player has made in the requested season. Divided by total, accurate and key passes
penalties	Opens an array containing information about the penalties the player was involved with in the requested season. Divided by won, scored, missed, committed and saved

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.

Request

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

Response

{
                    "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.