Endpoint
GET https://api.thestatsapi.com/api/football/players/{player_id}/stats
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
player_id | string | Yes | Unique identifier for the player. Example: pl_29627593 |
Query parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
season_id | string | Yes | Season identifier. Example: sn_6125938 | |
competition_id | string | No | Filter statistics by competition. Example: comp_3039 | |
stage | string — enum: regular, playoff, all | No | all | Restrict statistics to regular/group-stage fixtures, playoff/knockout fixtures, or all fixtures. Values: regular, playoff, all. Example: regular |
Response (200)
{
"data": {
"player_id": "pl_29627593",
"season_id": "sn_6125938",
"team_id": "tm_0406",
"position": "M",
"rating": 7.24,
"appearances": 37,
"starts": 35,
"minutes_played": 3120,
"scoring": {
"goals": 18,
"assists": 7,
"goals_assists_sum": 25,
"goal_conversion_percentage": 18.4,
"penalties_taken": 4,
"penalty_goals": 3,
"big_chances_created": 10,
"big_chances_missed": 8
},
"shooting": {
"total_shots": 98,
"shots_on_target": 52,
"shots_off_target": 46
},
"passing": {
"total_passes": 1420,
"accurate_passes": 1210,
"inaccurate_passes": 210,
"pass_accuracy": 85.2,
"key_passes": 72,
"accurate_crosses": 35,
"accurate_crosses_percentage": 31.5,
"accurate_own_half_passes": 420,
"accurate_opposition_half_passes": 790,
"accurate_final_third_passes": 310
},
"defending": {
"tackles": 28,
"interceptions": 14
},
"duels": {
"ground_duels_won": 120,
"ground_duels_won_percentage": 54.2,
"aerial_duels_won": 30,
"aerial_duels_won_percentage": 48.4,
"total_duels_won": 150,
"total_duels_won_percentage": 53.1,
"successful_dribbles": 44,
"successful_dribbles_percentage": 61.1
},
"discipline": {
"yellow_cards": 3,
"red_cards": 0,
"direct_red_cards": 0,
"penalty_won": 2,
"penalty_conceded": 0
}
}
}
This page is generated from the live API contract at
https://api.thestatsapi.com/llms.txt.