STAT-API

NFL game_player_stats API

game_player_statsnfl.game_player_stats
Each NFL player's stat line for each game — every passing, rushing, receiving, defensive, special-teams, and scoring statistic recorded that day.
GET/api/v1/nfl/game_player_stats
Requires one of: game_id or player_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
player_idquerybigintoptional
Filter to a single player.
team_idquerybigintoptional
Filter by team.
opponent_team_idquerybigintoptional
Filter by opponent team.
positionquerystringoptional
Filter by player position. Values: DB, DEF, DL, K, LB, LS, OL, P, QB, RB, TE, WR.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return rows with id strictly greater than this value; page using the previous response's `next_from_id`. Omit on the first page.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nfl/game_player_stats?game_id=1'
Responses
200game_player_stats rows matching the declared filter set, wrapped in { game_player_stats, limit, next_from_id }. next_from_id is the last row's id on a full page — pass it back via ?from_id= to walk the full result; null marks the terminal page.application/jsonshow example ▸
400No declared filter set was satisfied — response body matches MissingRequiredFiltersError; pick one combo from the accepted-sets hint and resend.application/json
Response Schema(141 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 90
opponent_team_id
bigint—
e.g. 15
player_id
bigint—
e.g. 298
team_id
bigint—
e.g. 10
air_yds_share
decimal—Percentage of team air yards
e.g. 0.0000
assisted_tackles
integernullable—Assisted tackles
e.g. 1
blocked_kick_return_tds
integernullable—Blocked kick return touchdowns
e.g. 0
blocked_kick_return_yds
integernullable—Blocked kick return yards
e.g. 0
blocked_kicks
integernullable—Blocked kicks (FG, XP, punts)
e.g. 0
completions
integer——
e.g. 0
dakota
decimalnullable—DAKOTA: adjusted completion % + EPA metric
e.g. 0.1798
defensive_interceptions
integernullable—Defensive interceptions
e.g. 0
defensive_sack_yds
integernullable—Yards lost on defensive sacks
e.g. 0
defensive_sacks
decimalnullable—Defensive sacks (can be half sacks)
e.g. 0.0000
defensive_snaps
integernullable—Defensive snaps played
e.g. 0
defensive_tds
integernullable—Total defensive touchdowns (INT + fumble return TDs)
e.g. 0
defensive_team_snaps
integernullable—Total team defensive snaps (for calculating snap %)
e.g. 1
depth_order
integernullable—Depth order within position (1=starter, 2=backup, etc.) - joined from depth charts
e.g. 1
depth_position
stringnullable—Depth chart position (QB1, RB2, etc.) - joined from depth charts
e.g. WR
extra_pts_attempted
integernullable—Extra points attempted
e.g. 0
extra_pts_had_blocked
integernullable—Extra points blocked by opponent
e.g. 0
extra_pts_made
integernullable—Extra points made
e.g. 0
fantasy_pts
decimal—Standard-scoring fantasy points
e.g. 0.0000
fantasy_pts_ppr
decimal—PPR fantasy points
e.g. 0.0000
field_goal_percentage
decimalnullable—Field goal percentage
e.g. — (all-null in sample)
field_goal_return_tds
integernullable—Field goal return touchdowns
e.g. — (all-null in sample)
field_goal_return_yds
integernullable—Field goal return yards (missed FG returns)
e.g. — (all-null in sample)
field_goals_attempted
integernullable—Field goals attempted
e.g. 0
field_goals_had_blocked
integernullable—Field goals blocked by opponent
e.g. 0
field_goals_longest
integernullable—Longest field goal made (yards)
e.g. — (all-null in sample)
field_goals_made
integernullable—Field goals made
e.g. 0
field_goals_made_0_19
integernullable—Field goals made 0-19 yards
e.g. 0
field_goals_made_20_29
integernullable—Field goals made 20-29 yards
e.g. 0
field_goals_made_30_39
integernullable—Field goals made 30-39 yards
e.g. 0
field_goals_made_40_49
integernullable—Field goals made 40-49 yards
e.g. 0
field_goals_made_50_plus
integernullable—Field goals made 50+ yards
e.g. 0
forced_fumbles
integernullable—Forced fumbles
e.g. 1
fumble_return_tds
integernullable—Fumble return touchdowns
e.g. 0
fumble_return_yds
integernullable—Fumble return yards
e.g. 0
fumbles_out_of_bounds
integernullable—Fumbles out of bounds
e.g. 1
fumbles_own_recoveries
integernullable—Own fumbles recovered
e.g. 1
fumbles_recovered
integernullable—Fumbles recovered
e.g. 1
humidity
integernullable—Humidity percentage
e.g. — (all-null in sample)
interception_return_tds
integernullable—Interception return touchdowns
e.g. 0
interception_return_yds
integernullable—Interception return yards
e.g. 0
interceptions_thrown
integer——
e.g. 0
is_home
boolean—True if player's team is the home team
Values:falsetrue
kick_return_avg
floatnullable—Kick return average (yards per return)
e.g. 260
kick_return_fair_catches
integernullable—Fair catches on kick returns
e.g. 0
kick_return_fumbles
integernullable—Fumbles on kick returns
e.g. 0
kick_return_fumbles_lost
integernullable—Fumbles lost on kick returns
e.g. 0
kick_return_long
integernullable—Longest kick return (yards)
e.g. 31
kick_return_tds
integernullable—Kick return touchdowns
e.g. 0
kick_return_yds
integernullable—Total kick return yards
e.g. 0
kick_returns
integernullable—Number of kick returns
e.g. 1
misc_assisted_tackles
integernullable—Miscellaneous assisted tackles
e.g. — (all-null in sample)
misc_fumbles_forced
integernullable—Miscellaneous fumbles forced
e.g. — (all-null in sample)
misc_fumbles_recovered
integernullable—Miscellaneous fumbles recovered
e.g. — (all-null in sample)
misc_solo_tackles
integernullable—Miscellaneous solo tackles
e.g. — (all-null in sample)
offensive_snaps
integernullable—Offensive snaps played
e.g. 14
offensive_team_snaps
integernullable—Total team offensive snaps (for calculating snap %)
e.g. 64
pacr
decimalnullable—Passer air conversion ratio
e.g. 2.0000
pass_attempts
integer——
e.g. 0
passes_defended
integernullable—Passes defended
e.g. 1
passing_2pt_conversions
integer——
e.g. 0
passing_air_yds
integer——
e.g. 0
passing_completion_percentage
decimalnullable—Completion percentage
e.g. 10.0000
passing_epa
decimal—Expected points added from passing
e.g. 0.0000
passing_first_downs
integer——
e.g. 0
passing_long
integernullable—Longest pass completion (yards)
e.g. 25
passing_rating
decimalnullable—Passer rating
e.g. 39.5833
passing_tds
integer——
e.g. 0
passing_yds
integer——
e.g. 0
passing_yds_after_catch
integer——
e.g. 0
playing_surface
stringnullable—Playing surface type (grass, turf, etc.)
e.g. — (all-null in sample)
position
string—Player position at time of game
Values:DEFWRTEDBRBOL
position_group
string—Position group (QB, RB, WR, TE, etc.)
Values:DEFWRTERBOLSPEC
punt_average
decimalnullable—Punt average (yards)
e.g. 510.0000
punt_inside_20
integernullable—Punts inside 20 yard line
e.g. 1
punt_long
integernullable—Longest punt (yards)
e.g. 60
punt_net_average
floatnullable—Net punt average (gross - return yards)
e.g. — (all-null in sample)
punt_net_yds
integernullable—Net punt yards (gross - return yards)
e.g. — (all-null in sample)
punt_return_avg
floatnullable—Punt return average (yards per return)
e.g. 100
punt_return_fair_catches
integernullable—Fair catches on punt returns
e.g. 0
punt_return_fumbles
integernullable—Fumbles on punt returns (includes muffs)
e.g. 0
punt_return_fumbles_lost
integernullable—Fumbles lost on punt returns
e.g. 0
punt_return_long
integernullable—Longest punt return (yards)
e.g. 8
punt_return_tds
integernullable—Punt return touchdowns
e.g. 0
punt_return_yds
integernullable—Total punt return yards
e.g. 0
punt_returns
integernullable—Number of punt returns
e.g. 1
punt_touchbacks
integernullable—Punt touchbacks
e.g. 0
punt_yds
integernullable—Total punt yards
e.g. 0
punts
integernullable—Number of punts
e.g. 2
punts_had_blocked
integernullable—Punts blocked by opponent
e.g. 0
quarterback_hits
integernullable—Quarterback hits
e.g. 0
racr
decimalnullable—Receiver air conversion ratio
e.g. 0.0000
receiving_2pt_conversions
integer——
e.g. 0
receiving_air_yds
integer——
e.g. 0
receiving_epa
decimal—Expected points added from receiving
e.g. 0.0000
receiving_first_downs
integer——
e.g. 0
receiving_fumbles
integer——
e.g. 0
receiving_fumbles_lost
integer——
e.g. 0
receiving_long
integernullable—Longest reception (yards)
e.g. 9
receiving_tds
integer——
e.g. 0
receiving_yds
integer——
e.g. 0
receiving_yds_after_catch
integer——
e.g. 0
receiving_yds_per_reception
decimalnullable—Yards per reception
e.g. 50.0000
reception_percentage
decimalnullable—Reception percentage (receptions/targets)
e.g. 10.0000
receptions
integer——
e.g. 0
rushing_2pt_conversions
integer——
e.g. 0
rushing_attempts
integer——
e.g. 0
rushing_epa
decimal—Expected points added from rushing
e.g. 0.0000
rushing_first_downs
integer——
e.g. 0
rushing_fumbles
integer——
e.g. 0
rushing_fumbles_lost
integer——
e.g. 0
rushing_long
integernullable—Longest rush (yards)
e.g. 9
rushing_tds
integer——
e.g. 0
rushing_yds
integer——
e.g. 0
rushing_yds_per_attempt
decimalnullable—Rushing yards per attempt
e.g. 20.0000
sack_fumbles
integer——
e.g. 0
sack_fumbles_lost
integer——
e.g. 0
sack_yds
integer——
e.g. 0
sacks_allowed
integer——
e.g. 0
safeties
integernullable—Safeties
e.g. 0
solo_tackles
integernullable—Solo tackles
e.g. 1
special_teams_assisted_tackles
integernullable—Assisted tackles on special teams
e.g. 1
special_teams_fumbles_forced
integernullable—Fumbles forced on special teams
e.g. 0
special_teams_fumbles_recovered
integernullable—Fumbles recovered on special teams
e.g. 0
special_teams_snaps
integernullable—Special teams snaps played
e.g. 0
special_teams_solo_tackles
integernullable—Solo tackles on special teams
e.g. 1
special_teams_tds
integer——
e.g. 0
special_teams_team_snaps
integernullable—Total team special teams snaps (for calculating snap %)
e.g. 13
stadium
stringnullable—Stadium name
e.g. — (all-null in sample)
tackles_for_loss
integernullable—Tackles for loss
e.g. 0
target_share
decimal—Percentage of team targets
e.g. 0.0000
targets
integer——
e.g. 0
temperature
integernullable—Game temperature (Fahrenheit)
e.g. — (all-null in sample)
two_pt_returns
integernullable—Two-point conversion returns (defensive)
e.g. — (all-null in sample)
wind_speed
integernullable—Wind speed (mph)
e.g. — (all-null in sample)
wopr
decimalnullable—Weighted opportunity rating
e.g. 0.0000
GET/api/v1/nfl/game_player_stats/{id}
Parameters
idpathbigintrequired
Primary key (id) of the game_player_stat row.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nfl/game_player_stats/{pk_value}'
Responses
200Single game_player_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(141 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 90
opponent_team_id
bigint—
e.g. 15
player_id
bigint—
e.g. 298
team_id
bigint—
e.g. 10
air_yds_share
decimal—Percentage of team air yards
e.g. 0.0000
assisted_tackles
integernullable—Assisted tackles
e.g. 1
blocked_kick_return_tds
integernullable—Blocked kick return touchdowns
e.g. 0
blocked_kick_return_yds
integernullable—Blocked kick return yards
e.g. 0
blocked_kicks
integernullable—Blocked kicks (FG, XP, punts)
e.g. 0
completions
integer——
e.g. 0
dakota
decimalnullable—DAKOTA: adjusted completion % + EPA metric
e.g. 0.1798
defensive_interceptions
integernullable—Defensive interceptions
e.g. 0
defensive_sack_yds
integernullable—Yards lost on defensive sacks
e.g. 0
defensive_sacks
decimalnullable—Defensive sacks (can be half sacks)
e.g. 0.0000
defensive_snaps
integernullable—Defensive snaps played
e.g. 0
defensive_tds
integernullable—Total defensive touchdowns (INT + fumble return TDs)
e.g. 0
defensive_team_snaps
integernullable—Total team defensive snaps (for calculating snap %)
e.g. 1
depth_order
integernullable—Depth order within position (1=starter, 2=backup, etc.) - joined from depth charts
e.g. 1
depth_position
stringnullable—Depth chart position (QB1, RB2, etc.) - joined from depth charts
e.g. WR
extra_pts_attempted
integernullable—Extra points attempted
e.g. 0
extra_pts_had_blocked
integernullable—Extra points blocked by opponent
e.g. 0
extra_pts_made
integernullable—Extra points made
e.g. 0
fantasy_pts
decimal—Standard-scoring fantasy points
e.g. 0.0000
fantasy_pts_ppr
decimal—PPR fantasy points
e.g. 0.0000
field_goal_percentage
decimalnullable—Field goal percentage
e.g. — (all-null in sample)
field_goal_return_tds
integernullable—Field goal return touchdowns
e.g. — (all-null in sample)
field_goal_return_yds
integernullable—Field goal return yards (missed FG returns)
e.g. — (all-null in sample)
field_goals_attempted
integernullable—Field goals attempted
e.g. 0
field_goals_had_blocked
integernullable—Field goals blocked by opponent
e.g. 0
field_goals_longest
integernullable—Longest field goal made (yards)
e.g. — (all-null in sample)
field_goals_made
integernullable—Field goals made
e.g. 0
field_goals_made_0_19
integernullable—Field goals made 0-19 yards
e.g. 0
field_goals_made_20_29
integernullable—Field goals made 20-29 yards
e.g. 0
field_goals_made_30_39
integernullable—Field goals made 30-39 yards
e.g. 0
field_goals_made_40_49
integernullable—Field goals made 40-49 yards
e.g. 0
field_goals_made_50_plus
integernullable—Field goals made 50+ yards
e.g. 0
forced_fumbles
integernullable—Forced fumbles
e.g. 1
fumble_return_tds
integernullable—Fumble return touchdowns
e.g. 0
fumble_return_yds
integernullable—Fumble return yards
e.g. 0
fumbles_out_of_bounds
integernullable—Fumbles out of bounds
e.g. 1
fumbles_own_recoveries
integernullable—Own fumbles recovered
e.g. 1
fumbles_recovered
integernullable—Fumbles recovered
e.g. 1
humidity
integernullable—Humidity percentage
e.g. — (all-null in sample)
interception_return_tds
integernullable—Interception return touchdowns
e.g. 0
interception_return_yds
integernullable—Interception return yards
e.g. 0
interceptions_thrown
integer——
e.g. 0
is_home
boolean—True if player's team is the home team
Values:falsetrue
kick_return_avg
floatnullable—Kick return average (yards per return)
e.g. 260
kick_return_fair_catches
integernullable—Fair catches on kick returns
e.g. 0
kick_return_fumbles
integernullable—Fumbles on kick returns
e.g. 0
kick_return_fumbles_lost
integernullable—Fumbles lost on kick returns
e.g. 0
kick_return_long
integernullable—Longest kick return (yards)
e.g. 31
kick_return_tds
integernullable—Kick return touchdowns
e.g. 0
kick_return_yds
integernullable—Total kick return yards
e.g. 0
kick_returns
integernullable—Number of kick returns
e.g. 1
misc_assisted_tackles
integernullable—Miscellaneous assisted tackles
e.g. — (all-null in sample)
misc_fumbles_forced
integernullable—Miscellaneous fumbles forced
e.g. — (all-null in sample)
misc_fumbles_recovered
integernullable—Miscellaneous fumbles recovered
e.g. — (all-null in sample)
misc_solo_tackles
integernullable—Miscellaneous solo tackles
e.g. — (all-null in sample)
offensive_snaps
integernullable—Offensive snaps played
e.g. 14
offensive_team_snaps
integernullable—Total team offensive snaps (for calculating snap %)
e.g. 64
pacr
decimalnullable—Passer air conversion ratio
e.g. 2.0000
pass_attempts
integer——
e.g. 0
passes_defended
integernullable—Passes defended
e.g. 1
passing_2pt_conversions
integer——
e.g. 0
passing_air_yds
integer——
e.g. 0
passing_completion_percentage
decimalnullable—Completion percentage
e.g. 10.0000
passing_epa
decimal—Expected points added from passing
e.g. 0.0000
passing_first_downs
integer——
e.g. 0
passing_long
integernullable—Longest pass completion (yards)
e.g. 25
passing_rating
decimalnullable—Passer rating
e.g. 39.5833
passing_tds
integer——
e.g. 0
passing_yds
integer——
e.g. 0
passing_yds_after_catch
integer——
e.g. 0
playing_surface
stringnullable—Playing surface type (grass, turf, etc.)
e.g. — (all-null in sample)
position
string—Player position at time of game
Values:DEFWRTEDBRBOL
position_group
string—Position group (QB, RB, WR, TE, etc.)
Values:DEFWRTERBOLSPEC
punt_average
decimalnullable—Punt average (yards)
e.g. 510.0000
punt_inside_20
integernullable—Punts inside 20 yard line
e.g. 1
punt_long
integernullable—Longest punt (yards)
e.g. 60
punt_net_average
floatnullable—Net punt average (gross - return yards)
e.g. — (all-null in sample)
punt_net_yds
integernullable—Net punt yards (gross - return yards)
e.g. — (all-null in sample)
punt_return_avg
floatnullable—Punt return average (yards per return)
e.g. 100
punt_return_fair_catches
integernullable—Fair catches on punt returns
e.g. 0
punt_return_fumbles
integernullable—Fumbles on punt returns (includes muffs)
e.g. 0
punt_return_fumbles_lost
integernullable—Fumbles lost on punt returns
e.g. 0
punt_return_long
integernullable—Longest punt return (yards)
e.g. 8
punt_return_tds
integernullable—Punt return touchdowns
e.g. 0
punt_return_yds
integernullable—Total punt return yards
e.g. 0
punt_returns
integernullable—Number of punt returns
e.g. 1
punt_touchbacks
integernullable—Punt touchbacks
e.g. 0
punt_yds
integernullable—Total punt yards
e.g. 0
punts
integernullable—Number of punts
e.g. 2
punts_had_blocked
integernullable—Punts blocked by opponent
e.g. 0
quarterback_hits
integernullable—Quarterback hits
e.g. 0
racr
decimalnullable—Receiver air conversion ratio
e.g. 0.0000
receiving_2pt_conversions
integer——
e.g. 0
receiving_air_yds
integer——
e.g. 0
receiving_epa
decimal—Expected points added from receiving
e.g. 0.0000
receiving_first_downs
integer——
e.g. 0
receiving_fumbles
integer——
e.g. 0
receiving_fumbles_lost
integer——
e.g. 0
receiving_long
integernullable—Longest reception (yards)
e.g. 9
receiving_tds
integer——
e.g. 0
receiving_yds
integer——
e.g. 0
receiving_yds_after_catch
integer——
e.g. 0
receiving_yds_per_reception
decimalnullable—Yards per reception
e.g. 50.0000
reception_percentage
decimalnullable—Reception percentage (receptions/targets)
e.g. 10.0000
receptions
integer——
e.g. 0
rushing_2pt_conversions
integer——
e.g. 0
rushing_attempts
integer——
e.g. 0
rushing_epa
decimal—Expected points added from rushing
e.g. 0.0000
rushing_first_downs
integer——
e.g. 0
rushing_fumbles
integer——
e.g. 0
rushing_fumbles_lost
integer——
e.g. 0
rushing_long
integernullable—Longest rush (yards)
e.g. 9
rushing_tds
integer——
e.g. 0
rushing_yds
integer——
e.g. 0
rushing_yds_per_attempt
decimalnullable—Rushing yards per attempt
e.g. 20.0000
sack_fumbles
integer——
e.g. 0
sack_fumbles_lost
integer——
e.g. 0
sack_yds
integer——
e.g. 0
sacks_allowed
integer——
e.g. 0
safeties
integernullable—Safeties
e.g. 0
solo_tackles
integernullable—Solo tackles
e.g. 1
special_teams_assisted_tackles
integernullable—Assisted tackles on special teams
e.g. 1
special_teams_fumbles_forced
integernullable—Fumbles forced on special teams
e.g. 0
special_teams_fumbles_recovered
integernullable—Fumbles recovered on special teams
e.g. 0
special_teams_snaps
integernullable—Special teams snaps played
e.g. 0
special_teams_solo_tackles
integernullable—Solo tackles on special teams
e.g. 1
special_teams_tds
integer——
e.g. 0
special_teams_team_snaps
integernullable—Total team special teams snaps (for calculating snap %)
e.g. 13
stadium
stringnullable—Stadium name
e.g. — (all-null in sample)
tackles_for_loss
integernullable—Tackles for loss
e.g. 0
target_share
decimal—Percentage of team targets
e.g. 0.0000
targets
integer——
e.g. 0
temperature
integernullable—Game temperature (Fahrenheit)
e.g. — (all-null in sample)
two_pt_returns
integernullable—Two-point conversion returns (defensive)
e.g. — (all-null in sample)
wind_speed
integernullable—Wind speed (mph)
e.g. — (all-null in sample)
wopr
decimalnullable—Weighted opportunity rating
e.g. 0.0000