Players Statistics
This endpoint allows you to retrieve the statistics from players.
For the type argument you can search by: overall, home and away, but overall is most common type for this endpoint.
Multi-language: This feature allows the user to manually change the language of the API response by adding value to the
lang
attribute. Example:lang=en
.
Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.
Update Period: The endpoint is updated every minute.
Recommended Calls: Limit calls to 1 per minute.
Use Cases
Get statistics from a specific player_idhttps://football.sportdevs.com/players-statistics?player_id=eq.{player_id}
Get top 20 players with most goals from a specific league_id and season_idhttps://football.sportdevs.com/players-statistics?league_id=eq.{league_id}&season_id=eq.{season_id}&order=goals.desc&limit=20
Get top 20 players with most rating from a specific league_id and season_idhttps://football.sportdevs.com/players-statistics?league_id=eq.{league_id}&season_id=eq.{season_id}&order=rating.desc&limit=20
Get top 20 players with most red cards from a specific league_id and season_idhttps://football.sportdevs.com/players-statistics?league_id=eq.{league_id}&season_id=eq.{season_id}&order=red_cards.desc&limit=20
Get top 20 players with most yellow cards from a specific league_id and season_idhttps://football.sportdevs.com/players-statistics?league_id=eq.{league_id}&season_id=eq.{season_id}&order=yellow_cards.desc&limit=20
Get top 20 players with most assists from a specific league_id and season_idhttps://football.sportdevs.com/players-statistics?league_id=eq.{league_id}&season_id=eq.{season_id}&order=assists.desc&limit=20
Get statistics from a specific player_id and team_idhttps://football.sportdevs.com/players-statistics?player_id=eq.{player_id}&team_id=eq.{team_id}
Get statistics from a specific player_id, team_id and league_idhttps://football.sportdevs.com/players-statistics?player_id=eq.{player_id}&team_id=eq.{team_id}&league_id=eq.{league_id}
Get statistics from a specific player_id, team_id, league_id and season_idhttps://football.sportdevs.com/players-statistics?player_id=eq.{player_id}&team_id=eq.{team_id}&league_id=eq.{league_id}&season_id=eq.{season_id}
Get statistics from a specific player_id, team_id, league_id, season_id and typehttps://football.sportdevs.com/players-statistics?player_id=eq.{player_id}&team_id=eq.{team_id}&league_id=eq.{league_id}&season_id=eq.{season_id}&type=eq.{type}
Query Parameters
- player_id integer
Default value:
eq.718544
The id of the player
- team_id integer
Default value:
eq.6859
The id of the team
- league_id integer
Default value:
eq.48
The id of the league
- season_id integer
Default value:
eq.35
The id of the season
- type text
Default value:
eq.home
The type of the statistics
- offset string
Default value:
0
Limiting and Pagination
- limit string
Default value:
50
Limiting and Pagination
- lang string
Default value:
en
Multi-language
- 200
OK
- application/json
- Schema
- Example (from schema)
Schema array
- id integer
The id of the player's statistics
Note: This is a Primary Key.
- player_id integer
The id of the player
Note: This is a Foreign Key to
players.id
. - team_id integer
The id of the team
Note: This is a Foreign Key to
teams.id
. - team_name text
The name of the team
- team_hash_image character varying
Possible values:
<= 64 characters
The name image of the team
- league_id integer
The id of the league
Note: This is a Foreign Key to
leagues.id
. - league_name text
The name of the league
- league_hash_image character varying
Possible values:
<= 64 characters
The name image of the league
- season_id integer
The id of the season
Note: This is a Foreign Key to
seasons.id
. - season_name text
The name of the season
- type text
The type of the statistics
- goals_scored numeric
The number of goals made by the player
- big_chances_created numeric
The number of big chances created by the player
- big_chances_missed numeric
The number of big chances missed by the player
- goals_plus_assists numeric
The number of goals assists by the player
- successful_passes numeric
The number of accurate passes made by the player
- unsuccessful_passes numeric
The number of inaccurate passes made by the player
- total_passes_attempted numeric
The number of total passes made by the player
- pass_accuracy_percentage numeric
The number of accurate passes made by the player in
%
- accurate_passes_in_own_half numeric
The number of accurate passes made by the player in his own half
- accurate_passes_in_opposition_half numeric
The number of accurate passes made by the player in the opposite half
- accurate_final_third_passes numeric
The number of accurate passes made by the player in the final third
- key_passes numeric
The number of the key passes made by the player
- successful_dribbles numeric
The number of the successful dribbles made by the player
- dribble_success_percentage numeric
The number of successful dribbles in
%
- tackles_attempted numeric
The number of tackles made by the player
- interceptions numeric
The number of interceptions made by the player
- yellow_cards_received numeric
The number of yellow cards received
- direct_red_cards numeric
The number of direct red cards gotten by the player
- red_cards_received numeric
The number of the red cards gotten by the player
- accurate_crosses numeric
The number of the accurate crosses made by the player
- cross_accuracy_percentage numeric
The number of accurate crosses made by the player in
%
- total_shots_attempted numeric
The number of total shots made by the player
- shots_on_target numeric
The number of shots on target made by the player
- shots_off_target numeric
The number of shots off target made by the player
- ground_duels_won numeric
The number of ground duels won by the player
- ground_duels_won_percentage numeric
The number of ground duels won by the player in
%
- aerial_duels_won numeric
The number of aerial duels won by the player
- aerial_duels_won_percentage numeric
The number of aerial duels won by the player in
%
- total_duels_won numeric
The number of total duels won by the player
- duels_won_percentage numeric
The dual won percentage
- minutes_played numeric
The number of minutes played by the player
- goal_conversion_percentage numeric
The number of goal conversions made by the player in
%
- penalties_taken numeric
The number of penalties taken by the player
- penalty_goals_scored numeric
The number of penalty goals made by the players
- penalties_won numeric
The number of penalty won by the player
- penalties_conceded numeric
The number of penalty conceded by the player
- shots_from_set_piece numeric
The number of shots from set piece made by the player
- free_kick_goals numeric
The number of free kick goal made by the player
- goals_inside_box numeric
The number of goals from inside the box made by the player
- goals_outside_box numeric
The number of goals from outside the box made by the player
- shots_inside_box numeric
The number of shots from inside the box made by the player
- shots_outside_box numeric
The number of shots from outside the box made by the player
- headed_goals numeric
The number of headed goals made by the player
- left_footed_goals numeric
The number of left foot goals made by the player
- right_footed_goals numeric
The number of right foot goals made by the player
- accurate_long_passes numeric
The number of accurate long balls made by the player
- long_pass_accuracy_percentage numeric
The number of accurate long balls made by the player in
%
- clearances numeric
The number of clearances made by the player
- errors_leading_to_goals numeric
The number of error lead to goal made by the player
- errors_leading_to_shots numeric
The number of error lead to shot made by he player
- dispossessed numeric
The number of dispossessed by the player
- possession_lost numeric
The number of possessions lost by the player
- possession_won_in_attacking_third numeric
The number of possessions won by the player
- total_chipped_passes numeric
The number of total chipped passes made by the player
- accurate_chipped_passes numeric
The number of accurate chipped passes made by the player
- touches numeric
The number of touches made by the player
- fouls_suffered numeric
The number of the player being fouled
- fouls_committed numeric
The number of fouls made by the player
- shots_hit_woodwork numeric
The number of hits woodwork made by the player
- own_goals numeric
The number of own goals made by the player
- dribbled_past numeric
The number of dribbled past made by the player
- offsides numeric
The number of offsides made by the player
- shots_blocked numeric
The number of blocked shots made by the player
- passes_leading_to_assist numeric
The number of passes to assist made by the player
- saves_made numeric
The number of saves made by the player
- clean_sheets numeric
The number of clean sheets made by the player
- penalties_faced numeric
The number of penalties faced by the player
- penalties_saved numeric
The number of penalty saves by the player
- saved_shots_inside_box numeric
The number of saved shots from inside the box made by the player
- saved_shots_outside_box numeric
The number of saved shots from outside the box made by the player
- goals_conceded_inside_box numeric
The number of goals conceded inside the box by the player
- goals_conceded_outside_box numeric
The number of goals conceded outside the box by the player
- punches numeric
The number of punches made by the player
- runs_out numeric
The number of runs out made by the player
- successful_runs_out numeric
The number of successful runs out made by the player
- high_claims numeric
The number of high claims made by the player
- crosses_not_claimed numeric
The number of crosses not claimed made by the player
- matches_started numeric
The number of matches started by the player
- penalty_conversion_percentage numeric
The number of penalty conversions made by the player
- set_piece_conversion_percentage numeric
The number of set piece conversions made by the player
- total_attempted_assist numeric
The number of total attempt assists made by the player
- total_contests numeric
The number of total contests made by the player
- total_crosses numeric
The number of total crosses made by the player
- duels_lost numeric
The number of duels lost by the player
- aerial_duels_lost numeric
The number of aerials lost by the player
- penalties_missed numeric
The number of attempt penalties missed by the player
- penalties_hit_post numeric
The number of attempt penalties posted by the player
- penalties_on_target numeric
The number of attempt penalties target by the player
- total_long_passes_attempted numeric
The number of total long balls made by the player
- goals_conceded numeric
The number of goals conceded by the player
- tackles_won numeric
The number of tackles won by the player
- tackle_success_percentage numeric
The number of tackles won by the player in
%
- scoring_frequency numeric
The number of scoring frequency by the player
- yellow_red_cards_received numeric
The number of yellow-red cards gotten by the player
- saves_caught numeric
The number of saves caught by the player
- saves_parried numeric
The number of saves parried by the player
- total_passes_in_own_half numeric
The number of total passes made by the player in his half
- total_passes_in_opposition_half numeric
The number of total passes made by the player in the opposite half
- team_of_the_week_appearances numeric
The number of teams of the week appearances by the player
- assists numeric
The number of assists by the player
- total_appearances numeric
The number of appearances by the player
[
{
"id": 1120179,
"player_id": 718544,
"team_id": 6859,
"team_name": "Academica Petroleos do Lobito",
"team_hash_image": "45970bf2b8045068273ca3d7d0a7b57bab9946359dbf254ff07fbbb64c05207f",
"league_id": 48,
"league_name": "CAF Confederations Cup",
"league_hash_image": "144956be4117b27927fc6f516a3fc54457ead0b2d466ef9452ae7e72ca68cd09",
"season_id": 35,
"season_name": "CAF Confederations Cup 23/24",
"type": "home",
"goals_scored": 0,
"big_chances_created": 0,
"big_chances_missed": 0,
"goals_plus_assists": 0,
"successful_passes": 8,
"unsuccessful_passes": 9,
"total_passes_attempted": 17,
"pass_accuracy_percentage": 47.058823529412,
"accurate_passes_in_own_half": 4,
"accurate_passes_in_opposition_half": 4,
"accurate_final_third_passes": 2,
"key_passes": 1,
"successful_dribbles": 0,
"dribble_success_percentage": 0,
"tackles_attempted": 1,
"interceptions": 0,
"yellow_cards_received": 0,
"direct_red_cards": 0,
"red_cards_received": 0,
"accurate_crosses": 0,
"cross_accuracy_percentage": 0,
"total_shots_attempted": 0,
"shots_on_target": 0,
"shots_off_target": 0,
"ground_duels_won": 2,
"ground_duels_won_percentage": 100,
"aerial_duels_won": 1,
"aerial_duels_won_percentage": 100,
"total_duels_won": 3,
"duels_won_percentage": 100,
"minutes_played": 90,
"goal_conversion_percentage": 0,
"penalties_taken": 0,
"penalty_goals_scored": 0,
"penalties_won": 0,
"penalties_conceded": 0,
"shots_from_set_piece": 0,
"free_kick_goals": 0,
"goals_inside_box": 0,
"goals_outside_box": 0,
"shots_inside_box": 0,
"shots_outside_box": 0,
"headed_goals": 0,
"left_footed_goals": 0,
"right_footed_goals": 0,
"accurate_long_passes": 2,
"long_pass_accuracy_percentage": 66.666666666667,
"clearances": 1,
"errors_leading_to_goals": 0,
"errors_leading_to_shots": 0,
"dispossessed": 0,
"possession_lost": 11,
"possession_won_in_attacking_third": 0,
"total_chipped_passes": 5,
"accurate_chipped_passes": 3,
"touches": 30,
"fouls_suffered": 1,
"fouls_committed": 0,
"shots_hit_woodwork": 0,
"own_goals": 0,
"dribbled_past": 0,
"offsides": 0,
"shots_blocked": 0,
"passes_leading_to_assist": 0,
"saves_made": 0,
"clean_sheets": 0,
"penalties_faced": 0,
"penalties_saved": 0,
"saved_shots_inside_box": 0,
"saved_shots_outside_box": 0,
"goals_conceded_inside_box": 2,
"goals_conceded_outside_box": 1,
"punches": 0,
"runs_out": 0,
"successful_runs_out": 0,
"high_claims": 0,
"crosses_not_claimed": 0,
"matches_started": 1,
"penalty_conversion_percentage": 0,
"set_piece_conversion_percentage": 0,
"total_attempted_assist": 1,
"total_contests": 0,
"total_crosses": 0,
"duels_lost": 0,
"aerial_duels_lost": 0,
"penalties_missed": 0,
"penalties_hit_post": 0,
"penalties_on_target": 0,
"total_long_passes_attempted": 3,
"goals_conceded": 3,
"tackles_won": 0,
"tackle_success_percentage": 0,
"scoring_frequency": 0,
"yellow_red_cards_received": 0,
"saves_caught": 0,
"saves_parried": 0,
"total_passes_in_own_half": 9,
"total_passes_in_opposition_half": 8,
"team_of_the_week_appearances": 0,
"total_appearances": 1
}
]