Skip to main content

Players Statistics​

This endpoint allows you to retrieve the statistics from players.

For the type argument you can search by values such as regularSeason, depending on the competition and source data.

Available American football player statistics include defensive fields such as def_interceptions, def_sacks, def_safeties, def_fg_blocked, def_punt_blocked and def_extra_blocked; fumble fields such as fumble_lost_count, fumble_recovery_count, fumble_opponent_recovery_count and fumble_opponent_td_count; kicking fields such as kicking_fg_attempts_20_to_29, kicking_fg_made_50_plus, kicking_fg_percentage and kicking_extra_percentage; kickoff fields such as kickoff_total, kickoff_touchbacks, kickoff_average_yards and kickoff_onside; passing fields such as pass_yards, pass_touchdowns, pass_interceptions and pass_long_touchdown; receiving fields such as receive_receptions, receive_yards, receive_touchdowns and receive_targets; and rushing fields such as rush_yards, rush_touchdowns and rush_long_touchdown.

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_id
https://american-football.sportmicro.com/players-statistics?player_id=eq.{player_id}

Get top 20 quarterbacks with most passing yards from a specific league_id and season_id
https://american-football.sportmicro.com/players-statistics?league_id=eq.{league_id}&season_id=eq.{season_id}&order=pass_yards.desc&limit=20

Get top 20 players with most passing touchdowns from a specific league_id and season_id
https://american-football.sportmicro.com/players-statistics?league_id=eq.{league_id}&season_id=eq.{season_id}&order=pass_touchdowns.desc&limit=20

Get top 20 players with most rushing yards from a specific league_id and season_id
https://american-football.sportmicro.com/players-statistics?league_id=eq.{league_id}&season_id=eq.{season_id}&order=rush_yards.desc&limit=20

Get top 20 players with most receiving touchdowns from a specific league_id and season_id
https://american-football.sportmicro.com/players-statistics?league_id=eq.{league_id}&season_id=eq.{season_id}&order=receive_touchdowns.desc&limit=20

Get top 20 players with most sacks from a specific league_id and season_id
https://american-football.sportmicro.com/players-statistics?league_id=eq.{league_id}&season_id=eq.{season_id}&order=def_sacks.desc&limit=20

Get top 20 players with most interceptions from a specific league_id and season_id
https://american-football.sportmicro.com/players-statistics?league_id=eq.{league_id}&season_id=eq.{season_id}&order=def_interceptions.desc&limit=20

Get statistics from a specific player_id and team_id
https://american-football.sportmicro.com/players-statistics?player_id=eq.{player_id}&team_id=eq.{team_id}

Get statistics from a specific player_id, team_id and league_id
https://american-football.sportmicro.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_id
https://american-football.sportmicro.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 type
https://american-football.sportmicro.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

    The id of the player

    Example: eq.120
  • team_id integer

    The id of the team

    Example: eq.376
  • league_id integer

    The id of the league

    Example: eq.159
  • season_id integer

    The id of the season

    Example: eq.297
  • type text

    The type of the statistics

    Example: eq.regularSeason
  • offset string

    Default value: 0

    Limiting and Pagination

    Example: 0
  • limit string

    Default value: 50

    Limiting and Pagination

    Example: 50
  • lang string

    Default value: en

    Multi-language

    Example: en
Responses

OK

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

  • def_assist_tackles numeric

    The number of defensive assist tackles made by the player

  • def_combine_tackles numeric

    The number of defensive combine tackles made by the player

  • def_forced_fumbles numeric

    The number of defensive forced fumbles made by the player

  • def_interceptions numeric

    The number of defensive interceptions made by the player

  • def_passes_defensed numeric

    The number of defensive passes defensed made by the player

  • def_sacks numeric

    The number of defensive sacks made by the player

  • def_safeties numeric

    The number of defensive safeties made by the player

  • def_total_tackles numeric

    The number of defensive total tackles made by the player

  • def_fg_blocked numeric

    The number of defensive fg blocked made by the player

  • def_punt_blocked numeric

    The number of defensive punt blocked made by the player

  • def_extra_blocked numeric

    The number of defensive extra blocked by the player

  • fumble_count numeric

    The number of fumble fumbles made by the player

  • fumble_lost_count numeric

    The number of fumble lost made by the player

  • fumble_recovery_count numeric

    The number of fumble recovery made by the player

  • fumble_safety_count numeric

    The number of fumble safety made by the player

  • fumble_teammate_recovery_count numeric

    The number of fumble teammate fumble recovery made by the player

  • fumble_touchdown_return_count numeric

    The number of fumble touchdown returns made by the player

  • fumble_out_of_bounds_count numeric

    The number of fumble fumbles outbounds made by the player

  • fumble_teammate_yards numeric

    The number of fumble teammate fumble yards made by the player

  • fumble_teammate_td_count numeric

    The number of fumble teammate fumble td made by the player

  • fumble_touchback_count numeric

    The number of fumble fumbles touch back made by the player

  • fumble_opponent_recovery_count numeric

    The number of opponent fumble recoveries made by the player

  • fumble_opponent_yards numeric

    The number of opponent fumble return yards made by the player

  • fumble_opponent_td_count numeric

    The number of opponent fumble return touchdowns made by the player

  • total_kicking_points numeric

    The number of kicking total points made by the player

  • kicking_extra_made numeric

    The number of kicking extra made by the player

  • kicking_extra_attempts numeric

    The number of kicking extra attempts made by the player

  • kicking_extra_percentage numeric

    The extra point conversion percentage for the player

  • kicking_fg_attempts numeric

    The number of kicking fg attempts made by the player

  • kicking_fg_attempts_1_to_19 numeric

    The number of field goal attempts from 1 to 19 yards made by the player

  • kicking_fg_attempts_20_to_29 numeric

    The number of field goal attempts from 20 to 29 yards made by the player

  • kicking_fg_attempts_30_to_39 numeric

    The number of field goal attempts from 30 to 39 yards made by the player

  • kicking_fg_attempts_40_to_49 numeric

    The number of field goal attempts from 40 to 49 yards made by the player

  • kicking_fg_attempts_50_plus numeric

    The number of field goal attempts from 50 or more yards made by the player

  • kicking_fg_blocked numeric

    The number of blocked field goal attempts by the player

  • kicking_fg_made numeric

    The number of kicking fg made by the player

  • kicking_fg_made_1_to_19 numeric

    The number of field goals made from 1 to 19 yards by the player

  • kicking_fg_made_20_to_29 numeric

    The number of field goals made from 20 to 29 yards by the player

  • kicking_fg_made_30_to_39 numeric

    The number of field goals made from 30 to 39 yards by the player

  • kicking_fg_made_40_to_49 numeric

    The number of field goals made from 40 to 49 yards by the player

  • kicking_fg_made_50_plus numeric

    The number of field goals made from 50 or more yards by the player

  • kicking_fg_long numeric

    The number of kicking fg long made by the player

  • kicking_fg_percentage numeric

    The field goal conversion percentage for the player

  • kicking_extra_blocked numeric

    The number of blocked extra point attempts by the player

  • kickoff_return_yards numeric

    The number of kickoff return yards by the player

  • kickoff_total numeric

    The total number of kickoffs by the player

  • kickoff_touchbacks numeric

    The number of kickoff touchbacks by the player

  • kickoff_yards numeric

    The total kickoff yards by the player

  • kickoff_average_yards numeric

    The average kickoff yards by the player

  • kickoff_touchbacks_percentage numeric

    The kickoff touchback percentage for the player

  • kickoff_outbounds numeric

    The number of kickoffs sent out of bounds by the player

  • kickoff_onside numeric

    The number of onside kickoffs by the player

  • pass_attempts numeric

    The number of passing attempts made by the player

  • pass_completion_percentage numeric

    The number of passing completion percentage made by the player

  • pass_completions numeric

    The number of passing completions made by the player

  • pass_interceptions numeric

    The number of passing interceptions made by the player

  • pass_longest numeric

    The number of passing longest made by the player

  • pass_net_yards numeric

    The number of passing net yards made by the player

  • pass_sacked_count numeric

    The number of passing sacked made by the player

  • pass_touchdowns numeric

    The number of passing touchdowns made by the player

  • pass_yards numeric

    The number of passing yards made by the player

  • pass_yards_per_attempt numeric

    The number of passing yards per attempt made by the player

  • pass_touchdown_percentage numeric

    The number of passing touchdown percentage made by the player

  • pass_interception_percentage numeric

    The number of passing interception percentage made by the player

  • pass_twenty_plus numeric

    The number of passing twenty plus made by the player

  • pass_forty_plus numeric

    The number of passing forty plus made by the player

  • pass_sacked_yards_lost numeric

    The number of passing sacked yards lost made by the player

  • pass_yards_lost_per_sack numeric

    The number of passing yards lost per sack made by the player

  • pass_first_downs numeric

    The number of passing first downs made by the player

  • pass_first_down_percentage numeric

    The number of passing first down made by the player in %

  • pass_passer_rating numeric

    The number of passing passer rating made by the player

  • pass_yards_per_game numeric

    The number of passing yards per game made by the player

  • pass_touchdown_interception_ratio numeric

    The number of passing touchdown interception ratio made by the player

  • pass_long_touchdown numeric

    The number of passing long touchdowns made by the player

  • receive_first_downs numeric

    The number of receiving first downs made by the player

  • receive_longest numeric

    The number of receiving longest made by the player

  • receive_receptions numeric

    The number of receiving receptions made by the player

  • receive_touchdowns numeric

    The number of receiving touchdowns made by the player

  • receive_yards numeric

    The number of receiving yards made by the player

  • receive_yards_per_reception numeric

    The number of receiving yards per reception made by the player

  • receive_targets numeric

    The number of receiving targets made by the player

  • receive_first_down_percentage numeric

    The number of receiving first down made by the player in %

  • receive_long_touchdowns numeric

    The number of receiving long touchdowns made by the player

  • rush_attempts numeric

    The number of rushing attempts made by the player

  • rush_fumbles numeric

    The number of rushing fumbles made by the player

  • rush_longest numeric

    The number of rushing longest made by the player

  • rush_touchdowns numeric

    The number of rushing touchdowns made by the player

  • rush_yards numeric

    The number of rushing yards made by the player

  • rush_yards_per_attempt numeric

    The number of rushing yards per attempt made by the player

  • rush_first_downs numeric

    The number of rushing first downs made by the player

  • rush_twenty_plus numeric

    The number of rushing twenty plus made by the player

  • rush_forty_plus numeric

    The number of rushing forty plus made by the player

  • rush_yards_per_game numeric

    The number of rushing yards per game made by the player

  • rush_first_down_percentage numeric

    The number of rushing first down made by the player in %

  • rush_long_touchdown numeric

    The number of rushing long touchdowns made by the player

  • total_appearances numeric

    The number of appearances by the player

Loading...