Player statistics
GET https://soccer.sportmonks.com/api/v2.0/players/:PLAYER_ID?include=stats&seasons=17141
Introduction
For this example, we’ll go with James Forrest (player id: 172104). 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.
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 by adding the seasons parameter. Just like in this example, the player stats from the 2020/2021 Scottish Premiership season.
Pagination
NO - Indicates if this endpoint contains pagination.
Nested Includes
2 - You can add a maximum of 2 levels of nested includes.
Includes Options
position team stats trophies sidelined transfers lineups country
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
markets | null | Filter odds based on a comma separated list of market ids. | |
bookmakers | null | Filter odds based on a comma separated list of bookmaker ids. | |
include | string | Enrich the API with more data and/or nested includes | |
seasons | number |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
| `` | null |
RESPONSES
status: OK
{"data":{"player_id":172104,"team_id":53,"country_id":1161,"position_id":3,"common_name":"J. Forrest","display_name":"James Forrest","fullname":"James Forrest","firstname":"James","lastname":"Forrest","nationality":"Scotland","birthdate":"07/07/1991","birthcountry":"Scotland","birthplace":"Prestwick","height":"175 cm","weight":null,"image_path":"https://cdn.sportmonks.com/images/soccer/players/8/172104.png","stats":{"data":[{"player_id":172104,"team_id":53,"league_id":501,"season_id":17141,"captain":0,"minutes":484,"appearences":7,"lineups":5,"substitute_in":2,"substitute_out":1,"substitutes_on_bench":2,"goals":2,"owngoals":0,"assists":1,"saves":0,"inside_box_saves":0,"dispossesed":32,"interceptions":2,"yellowcards":0,"yellowred":0,"redcards":0,"type":"domestic","tackles":7,"blocks":null,"hit_post":1,"cleansheets":3,"rating":"7.14","fouls":{"committed":0,"drawn":3},"crosses":{"total":22,"accurate":6},"dribbles":{"attempts":6,"success":3,"dribbled_past":1},"duels":{"total":24,"won":13},"passes":{"total":219,"accuracy":87,"key_passes":7},"penalties":{"won":null,"scores":null,"missed":null,"committed":null,"saves":null}}]}},"meta":{"subscription":{"started_at":{"date":"2017-03-20 21:02:56.000000","timezone_type":3,"timezone":"UTC"},"trial_ends_at":null,"ends_at":null},"plan":{"name":"Free Plan","price":"0.00","request_limit":"3,1"},"sports":[{"id":1,"name":"Soccer","current":true},{"id":6,"name":"Cricket","current":false}]}}