LogoLogo
Quick StartFootball APIContactAPI 3.0
  • Welcome
  • Changelog
  • Getting Started
    • Get Started
    • Documentation for the documentation
  • Endpoint overview
    • Continents
      • GET All Continents
      • GET Continent by ID
    • Countries
      • GET All Countries
      • GET Country by ID
    • Leagues
      • GET All Leagues
      • GET League by ID
      • GET Leagues by Country ID
      • Search Leagues by Name
    • Seasons
      • GET All Seasons
      • GET Season by ID
    • Fixtures
      • GET Fixture by ID
      • GET Last Updated Fixtures
      • GET Fixtures by Date
      • GET Fixtures by Date Range
      • GET Fixtures by Date Range for Team
      • GET Fixtures by Multiple ID's
      • GET Deleted Fixtures
    • Statistics
    • Livescores
      • GET All Livescores
      • GET All In play Livescores
    • News API
      • GET All News
      • GET News For Upcoming Fixtures
      • GET News by Season ID
    • Commentaries
      • Commentaries by Fixture ID
    • Video Highlights
      • Get Video Highlights by Fixture ID
    • Head 2 Head
      • GET Head 2 Head by Team IDs
    • Standings
      • GET Standings by Season ID
      • GET LIVE Standings
      • GET Standings by Season ID and Round ID
      • GET Standings by Season and Date(time)
      • GET Standings Corrections by Season ID
    • Teams
      • GET Team by ID
      • GET Teams by Country ID
      • GET Teams by Season ID
      • Search Team by Name
      • GET Current Leagues by Team ID
      • Get All Leagues by Team ID
    • Players
      • GET Player by ID
      • GET Players by Country ID
      • Search Player by Name
    • Topscorers
      • GET Topscorers by Season ID
      • GET Topscorers Aggregated by Season ID
    • Rivals
      • GET Rivals by Team ID
    • Venues
      • GET Venue by ID
      • GET Venues by Season ID
    • Rounds
      • GET Rounds by Season ID
      • GET Round by ID
    • Odds
      • GET Odds by Fixture ID and Bookmaker ID
      • GET Odds by Fixture ID and Market ID
      • GET Odds by Fixture ID
      • GET Inplay Odds by Fixture ID
    • Coaches
      • GET Coach by ID
    • Stages
      • GET Stage by ID
      • GET Stages by Season ID
    • Bookmakers
      • GET All Bookmakers by Fixture ID
      • GET All Bookmakers
      • GET Bookmaker by ID
    • Markets
      • GET All Fixtures by Market ID
      • GET All Markets
      • GET Market by ID
    • Team Squads
      • GET Team Squad by Team and Season ID
    • TV Stations
      • GET TV Station by Fixture ID
    • Prediction API
      • GET Leagues and Performances
      • GET Probabilities
      • GET Probabilities by Fixture ID
      • GET Value Bets
      • GET Value Bet by Fixture ID
  • Tutorials
    • Introduction to our API
      • Make your first request
      • Set your time zone
      • Pagination
    • Enriching your response
      • Includes
      • Nested includes
    • Filtering, limiting & sorting
      • Filtering
      • Limiting
      • Sorting
    • Schedule, fixtures & livescores
      • Season schedule
      • Fixtures
      • Livescores
    • Statistics
      • Match statistics
      • Team statistics
      • Player statistics
      • Season statistics
    • League & topscorers standings
      • League standings
      • Topscorers standings
    • Odds & predictions
      • Odds
        • Odds by fixture, bookmaker and market id
        • FlatOdds
        • InplayOdds
      • Predictions
  • MySportmonks
    • How-to build a custom plan
    • ID Finder
  • How-to Guides
    • Get Started with our how-to guides
      • How-to build your API requests
    • Livescores & fixtures
      • How-to build a livescore website
      • How-to build a schedule page
    • Match & team pages
      • How-to build a match page with events and statistics
      • How-to build a match page with line-ups/formations
      • How-to build a team page with season stats and squads
    • How-to build standings and topscorer standings
      • League standings
      • Topscorer standings
    • Odds & predictions
      • How-to build a match page with odds
      • How-to build a betting odds portal
      • How-to use the predictions API
    • How-to build a fantasy game
    • Developer tools
      • How-to use Sportmonks' APIs in Postman
    • How-to keep your database in sync
    • World Cup 2022
    • EURO 2024
    • Football widgets
      • How-to set up football widgets in your web application
      • Configurations
      • Widgets overview
        • Livescore widget
        • International Cup widgets
  • API References
    • API reference guide
    • Data features
    • ID Finder
    • Code libraries
    • Demo response files
    • Statuses and definitions
    • API Rate limiting
    • Response codes
    • Meta description
  • General
  • Sportmonks
  • Plans & pricing
  • FAQ
  • Contact
Powered by GitBook
On this page
  • Live Player statistics

Was this helpful?

Export as PDF
  1. Tutorials
  2. Statistics

Player statistics

PreviousTeam statisticsNextSeason statistics

Last updated 4 years ago

Was this helpful?

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

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

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.

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

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

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 on it.

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

filter
nested include tutorial.
player by id endpoint
A snippet of Kevin De Bruyne's stats from the 2020/2021 season of the English Premier League