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://basketball.sportdevs.com/players-statistics?player_id=eq.{player_id}
Get top 20 players with most goals from a specific league_id and season_idhttps://basketball.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://basketball.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://basketball.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://basketball.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://basketball.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://basketball.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://basketball.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://basketball.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://basketball.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.739148
The id of the player
- team_id integer
Default value:
eq.8850
The id of the team
- league_id integer
Default value:
eq.1994
The id of the league
- season_id integer
Default value:
eq.7621
The id of the season
- type text
Default value:
eq.overall
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
- time_played_seconds numeric
The number of seconds played by the player
- player_points numeric
The number of points made by the player
- two_point_field_goals_made numeric
The number of two points made by the player
- two_point_field_goal_attempts numeric
The number of two point attempts made by the player
- three_point_field_goals_made numeric
The number of three points made by the player
- three_point_field_goal_attempts numeric
The number of three point attempts made by the player
- free_throws_scored numeric
The number of free throws made by the player
- free_throw_attempts numeric
The number of free throw attempts made by the player
- total_field_goals_made numeric
The number of field goals made by the player
- total_field_goal_attempts numeric
The number of field goal attempts made by the player
- total_rebounds numeric
The number of rebounds made by the player
- defensive_rebounds numeric
The number of defensive rebounds made by the player
- offensive_rebounds numeric
The number of offensive rebounds made by the player
- player_turnovers numeric
The number of turnovers made by the player
- player_blocks numeric
The number of blocks made by the player
- personal_fouls_committed numeric
The number of personal fouls made by the player
- player_assists numeric
The assists made by the player
- player_steals numeric
The number of steals made by the player
- plus_minus_rating numeric
The number of plus minus made by the player
- field_goal_percentage numeric
The number of field goals made by the player in
%
- free_throw_percentage numeric
The number of free throws made by the player in
%
- three_point_percentage numeric
The number of three points made by the player in
%
- two_point_percentage numeric
The number of two points made by the player in
%
- double_doubles_count numeric
The number of double doubles made by the player
- triple_doubles_count numeric
The number of triple doubles made by the player
- assist_to_turnover_ratio numeric
The number of assist turnover ratio made by the player
- total_appearances numeric
The number of appearances by the player
[
{
"id": 51976,
"player_id": 739148,
"team_id": 8850,
"team_name": "Darüşşafaka Lassa",
"team_hash_image": "798ab03100f9a6f60387021eab80b66b1322a6f94b36635fe0927101677b6a74",
"league_id": 1994,
"league_name": "Türkiye Sigorta Basketbol Süper Ligi",
"league_hash_image": "c308a0e71188f08614318fa44d5d7d609ec87969c8acffa62f5cd57211ddfb05",
"season_id": 7621,
"season_name": "Super Lig 23/24",
"type": "overall",
"time_played_seconds": 177,
"player_points": 0,
"two_point_field_goals_made": 0,
"two_point_field_goal_attempts": 1,
"three_point_field_goals_made": 0,
"three_point_field_goal_attempts": 0,
"free_throws_scored": 0,
"free_throw_attempts": 0,
"total_field_goals_made": 0,
"total_field_goal_attempts": 1,
"total_rebounds": 1,
"defensive_rebounds": 0,
"offensive_rebounds": 1,
"player_turnovers": 1,
"player_blocks": 0,
"personal_fouls_committed": 0,
"player_assists": 0,
"player_steals": 0,
"field_goal_percentage": 0,
"free_throw_percentage": 0,
"three_point_percentage": 0,
"two_point_percentage": 0,
"double_doubles_count": 0,
"triple_doubles_count": 0,
"assist_to_turnover_ratio": 0,
"total_appearances": 1
}
]