STAT-API

NFL game_team_stats API

game_team_statsnfl.game_team_stats
Each NFL team's stat line for each game — the same offensive, defensive, scoring, and situational counters as the season aggregate, broken out per game with home/away context.
GET/api/v1/nfl/game_team_stats
Requires one of: game_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
team_idquerybigintoptional
Filter by team.
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_team_stats?game_id=1'
Responses
200game_team_stats rows matching the declared filter set, wrapped in { game_team_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(131 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 4718
team_id
bigint—
e.g. 16
blocked_extra_pts
integer——
e.g. 0
blocked_field_goals
integer——
e.g. 0
blocked_kick_return_tds
integer—Blocked kick return touchdowns
e.g. 0
blocked_kick_return_yds
integer—Blocked kick return yards
e.g. 0
blocked_kicks
integer—Total blocked kicks (FGs + XPs + punts) for DST fantasy scoring
e.g. 0
blocked_punts
integer——
e.g. 0
completion_percentage
decimal——
e.g. 66.6667
completions
integer——
e.g. 22
defensive_interceptions
integer——
e.g. 0
defensive_sacks
integer——
e.g. 2
defensive_tds
integer——
e.g. 0
defensive_team_snaps
integer—Total defensive snaps by team in game
e.g. 715
extra_pt_percentage
decimal—Extra point conversion percentage
e.g. 100.0000
extra_pts_attempted
integer——
e.g. 2
extra_pts_blocked
integer—Extra points that were blocked
e.g. 0
extra_pts_made
integer——
e.g. 2
field_goal_percentage
decimal——
e.g. 100.0000
field_goal_return_tds
integer—Field goal return touchdowns
e.g. 0
field_goal_return_yds
integer—Field goal return yards (missed FGs)
e.g. 0
field_goals_attempted
integer——
e.g. 2
field_goals_blocked
integer—Field goals that were blocked
e.g. 0
field_goals_made
integer——
e.g. 1
first_downs
integer——
e.g. 22
first_downs_passing
integer——
e.g. 11
first_downs_penalty
integer——
e.g. 1
first_downs_rushing
integer——
e.g. 5
forced_fumbles
integer——
e.g. 0
fourth_down_attempts
integer——
e.g. 1
fourth_down_conversions
integer——
e.g. 0
fourth_down_percentage
decimal——
e.g. 0.0000
fumble_return_tds
integer—Fumble return touchdowns
e.g. 0
fumble_return_yds
integer—Fumble return yards
e.g. 0
fumbles_lost
integer——
e.g. 0
fumbles_recovered
integer——
e.g. 0
interception_percentage
decimal—Percentage of passes intercepted
e.g. 0.0000
interception_return_tds
integer—Interception return touchdowns
e.g. 0
interception_return_yds
integer—Interception return yards
e.g. 0
interception_returns
integer—Number of interception returns
e.g. 0
interceptions_thrown
integer——
e.g. 0
is_home
boolean—True if team is the home team
Values:truefalse
kick_return_avg
decimal—Average yards per kick return
e.g. 0.0000
kick_return_long
integer—Longest kick return
e.g. 0
kick_return_tds
integer——
e.g. 0
kick_return_yds
integer——
e.g. 0
kick_return_yds_differential
integer—Kick return yards minus opponent kick return yards
e.g. 0
kick_returns
integer—Number of kick returns
e.g. 0
kickoff_touchbacks
integer—Kickoffs resulting in touchbacks
e.g. 0
kickoffs
integer—Number of kickoffs
e.g. 0
kickoffs_in_endzone
integer—Kickoffs that reached the end zone
e.g. 0
loss
integer——
e.g. 0
offensive_plays
integer—Total offensive plays run
e.g. 64
offensive_team_snaps
integer—Total offensive snaps by team in game
e.g. 715
offensive_yds
integer—Total offensive yards gained
e.g. 367
pass_attempts
integer——
e.g. 30
passer_rating
decimal——
e.g. 97.9167
passes_defended
integer——
e.g. 3
passing_dropbacks
integer—Number of passing dropbacks
e.g. 30
passing_tds
integer——
e.g. 1
passing_yds
integer——
e.g. 235
penalties
integer——
e.g. 5
penalty_yds
integer——
e.g. 30
penalty_yds_differential
integer—Opponent penalty yards minus own penalty yards
e.g. 0
point_differential
integer—Points scored minus points allowed
e.g. 3
pts
integer——
e.g. 20
pts_allowed_def
integer—Points allowed for DEF scoring (FanDuel). Excludes return TDs against - only offensive points allowed.
e.g. 20
pts_allowed_dst
integer—Points allowed for DST scoring (DraftKings/Yahoo). Includes return TDs against - real scoreboard points.
e.g. 20
punt_average
decimal——
e.g. 45.0000
punt_net_average
decimal—Net punt average yards
e.g. 45.0000
punt_net_yds
integer—Total net punt yards
e.g. 0
punt_return_avg
decimal—Average yards per punt return
e.g. 0.0000
punt_return_long
integer—Longest punt return
e.g. 0
punt_return_tds
integer——
e.g. 0
punt_return_yds
integer——
e.g. 0
punt_return_yds_differential
integer—Punt return yards minus opponent punt return yards
e.g. 0
punt_returns
integer—Number of punt returns
e.g. 0
punt_yds
integer——
e.g. 0
punts
integer——
e.g. 4
punts_blocked
integer—Number of punts blocked
e.g. 0
qb_hits_differential
integer—QB hits made minus QB hits allowed
e.g. 0
qb_hits_percentage
decimal—Percentage of dropbacks resulting in QB hit
e.g. 0.0000
quarterback_hits
integer——
e.g. 5
receiving_tds
integer——
e.g. 1
receiving_yds
integer——
e.g. 235
receptions
integer——
e.g. 22
red_zone_attempts
integer——
e.g. 4
red_zone_conversions
integer——
e.g. 3
red_zone_percentage
decimal——
e.g. 100.0000
rushing_attempts
integer——
e.g. 25
rushing_tds
integer——
e.g. 0
rushing_yds
integer——
e.g. 96
rushing_yds_per_attempt
decimal—Rushing yards per attempt
e.g. 4.0000
sack_yds
integer——
e.g. 0
sacked_percentage
decimal—Percentage of dropbacks resulting in sack
e.g. 0.0000
sacks_allowed
integer——
e.g. 2
sacks_differential
integer—Sacks made minus sacks allowed
e.g. 0
safeties
integer——
e.g. 0
score_ot
integer—Points scored in overtime
e.g. 0
score_q1
integer—Points scored in Q1
e.g. 0
score_q2
integer—Points scored in Q2
e.g. 0
score_q3
integer—Points scored in Q3
e.g. 0
score_q4
integer—Points scored in Q4
e.g. 0
special_teams_team_snaps
integer—Total special teams snaps by team in game
e.g. 275
tackles
integer——
e.g. 51
tackles_for_loss
integer——
e.g. 2
tfl_differential
integer—Tackles for loss made minus allowed
e.g. 0
tfl_percentage
decimal—Percentage of plays resulting in TFL
e.g. 0.0000
third_down_attempts
integer——
e.g. 13
third_down_conversions
integer——
e.g. 5
third_down_percentage
decimal——
e.g. 50.0000
tie
integer——
e.g. 0
time_of_possession
integer——
e.g. 1696
total_return_yds
integer—Total punt and kick return yards
e.g. 0
total_yds
integer——
e.g. 367
touchdowns
integer—Total touchdowns scored
e.g. 2
turnover_differential
integer——
e.g. 0
turnovers
integer——
e.g. 1
two_point_conversion_attempts
integer——
e.g. 0
two_point_conversions
integer——
e.g. 0
two_pt_conversion_returns
integer—Defensive two-point conversion returns
e.g. 0
two_pt_pass_attempts
integer—Two-point conversion pass attempts
e.g. 0
two_pt_pass_conversions
integer—Two-point conversion pass conversions
e.g. 0
two_pt_rush_attempts
integer—Two-point conversion rush attempts
e.g. 0
two_pt_rush_conversions
integer—Two-point conversion rush conversions
e.g. 0
win
integer——
e.g. 0
yds_per_carry
decimal——
e.g. 4.0000
yds_per_completion
decimal—Passing yards per completion
e.g. 11.0000
yds_per_pass_attempt
decimal——
e.g. 6.0000
yds_per_play
decimal—Average yards per offensive play
e.g. 5.0000
GET/api/v1/nfl/game_team_stats/{id}
Parameters
idpathbigintrequired
Primary key (id) of the game_team_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_team_stats/{pk_value}'
Responses
200Single game_team_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(131 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 4718
team_id
bigint—
e.g. 16
blocked_extra_pts
integer——
e.g. 0
blocked_field_goals
integer——
e.g. 0
blocked_kick_return_tds
integer—Blocked kick return touchdowns
e.g. 0
blocked_kick_return_yds
integer—Blocked kick return yards
e.g. 0
blocked_kicks
integer—Total blocked kicks (FGs + XPs + punts) for DST fantasy scoring
e.g. 0
blocked_punts
integer——
e.g. 0
completion_percentage
decimal——
e.g. 66.6667
completions
integer——
e.g. 22
defensive_interceptions
integer——
e.g. 0
defensive_sacks
integer——
e.g. 2
defensive_tds
integer——
e.g. 0
defensive_team_snaps
integer—Total defensive snaps by team in game
e.g. 715
extra_pt_percentage
decimal—Extra point conversion percentage
e.g. 100.0000
extra_pts_attempted
integer——
e.g. 2
extra_pts_blocked
integer—Extra points that were blocked
e.g. 0
extra_pts_made
integer——
e.g. 2
field_goal_percentage
decimal——
e.g. 100.0000
field_goal_return_tds
integer—Field goal return touchdowns
e.g. 0
field_goal_return_yds
integer—Field goal return yards (missed FGs)
e.g. 0
field_goals_attempted
integer——
e.g. 2
field_goals_blocked
integer—Field goals that were blocked
e.g. 0
field_goals_made
integer——
e.g. 1
first_downs
integer——
e.g. 22
first_downs_passing
integer——
e.g. 11
first_downs_penalty
integer——
e.g. 1
first_downs_rushing
integer——
e.g. 5
forced_fumbles
integer——
e.g. 0
fourth_down_attempts
integer——
e.g. 1
fourth_down_conversions
integer——
e.g. 0
fourth_down_percentage
decimal——
e.g. 0.0000
fumble_return_tds
integer—Fumble return touchdowns
e.g. 0
fumble_return_yds
integer—Fumble return yards
e.g. 0
fumbles_lost
integer——
e.g. 0
fumbles_recovered
integer——
e.g. 0
interception_percentage
decimal—Percentage of passes intercepted
e.g. 0.0000
interception_return_tds
integer—Interception return touchdowns
e.g. 0
interception_return_yds
integer—Interception return yards
e.g. 0
interception_returns
integer—Number of interception returns
e.g. 0
interceptions_thrown
integer——
e.g. 0
is_home
boolean—True if team is the home team
Values:truefalse
kick_return_avg
decimal—Average yards per kick return
e.g. 0.0000
kick_return_long
integer—Longest kick return
e.g. 0
kick_return_tds
integer——
e.g. 0
kick_return_yds
integer——
e.g. 0
kick_return_yds_differential
integer—Kick return yards minus opponent kick return yards
e.g. 0
kick_returns
integer—Number of kick returns
e.g. 0
kickoff_touchbacks
integer—Kickoffs resulting in touchbacks
e.g. 0
kickoffs
integer—Number of kickoffs
e.g. 0
kickoffs_in_endzone
integer—Kickoffs that reached the end zone
e.g. 0
loss
integer——
e.g. 0
offensive_plays
integer—Total offensive plays run
e.g. 64
offensive_team_snaps
integer—Total offensive snaps by team in game
e.g. 715
offensive_yds
integer—Total offensive yards gained
e.g. 367
pass_attempts
integer——
e.g. 30
passer_rating
decimal——
e.g. 97.9167
passes_defended
integer——
e.g. 3
passing_dropbacks
integer—Number of passing dropbacks
e.g. 30
passing_tds
integer——
e.g. 1
passing_yds
integer——
e.g. 235
penalties
integer——
e.g. 5
penalty_yds
integer——
e.g. 30
penalty_yds_differential
integer—Opponent penalty yards minus own penalty yards
e.g. 0
point_differential
integer—Points scored minus points allowed
e.g. 3
pts
integer——
e.g. 20
pts_allowed_def
integer—Points allowed for DEF scoring (FanDuel). Excludes return TDs against - only offensive points allowed.
e.g. 20
pts_allowed_dst
integer—Points allowed for DST scoring (DraftKings/Yahoo). Includes return TDs against - real scoreboard points.
e.g. 20
punt_average
decimal——
e.g. 45.0000
punt_net_average
decimal—Net punt average yards
e.g. 45.0000
punt_net_yds
integer—Total net punt yards
e.g. 0
punt_return_avg
decimal—Average yards per punt return
e.g. 0.0000
punt_return_long
integer—Longest punt return
e.g. 0
punt_return_tds
integer——
e.g. 0
punt_return_yds
integer——
e.g. 0
punt_return_yds_differential
integer—Punt return yards minus opponent punt return yards
e.g. 0
punt_returns
integer—Number of punt returns
e.g. 0
punt_yds
integer——
e.g. 0
punts
integer——
e.g. 4
punts_blocked
integer—Number of punts blocked
e.g. 0
qb_hits_differential
integer—QB hits made minus QB hits allowed
e.g. 0
qb_hits_percentage
decimal—Percentage of dropbacks resulting in QB hit
e.g. 0.0000
quarterback_hits
integer——
e.g. 5
receiving_tds
integer——
e.g. 1
receiving_yds
integer——
e.g. 235
receptions
integer——
e.g. 22
red_zone_attempts
integer——
e.g. 4
red_zone_conversions
integer——
e.g. 3
red_zone_percentage
decimal——
e.g. 100.0000
rushing_attempts
integer——
e.g. 25
rushing_tds
integer——
e.g. 0
rushing_yds
integer——
e.g. 96
rushing_yds_per_attempt
decimal—Rushing yards per attempt
e.g. 4.0000
sack_yds
integer——
e.g. 0
sacked_percentage
decimal—Percentage of dropbacks resulting in sack
e.g. 0.0000
sacks_allowed
integer——
e.g. 2
sacks_differential
integer—Sacks made minus sacks allowed
e.g. 0
safeties
integer——
e.g. 0
score_ot
integer—Points scored in overtime
e.g. 0
score_q1
integer—Points scored in Q1
e.g. 0
score_q2
integer—Points scored in Q2
e.g. 0
score_q3
integer—Points scored in Q3
e.g. 0
score_q4
integer—Points scored in Q4
e.g. 0
special_teams_team_snaps
integer—Total special teams snaps by team in game
e.g. 275
tackles
integer——
e.g. 51
tackles_for_loss
integer——
e.g. 2
tfl_differential
integer—Tackles for loss made minus allowed
e.g. 0
tfl_percentage
decimal—Percentage of plays resulting in TFL
e.g. 0.0000
third_down_attempts
integer——
e.g. 13
third_down_conversions
integer——
e.g. 5
third_down_percentage
decimal——
e.g. 50.0000
tie
integer——
e.g. 0
time_of_possession
integer——
e.g. 1696
total_return_yds
integer—Total punt and kick return yards
e.g. 0
total_yds
integer——
e.g. 367
touchdowns
integer—Total touchdowns scored
e.g. 2
turnover_differential
integer——
e.g. 0
turnovers
integer——
e.g. 1
two_point_conversion_attempts
integer——
e.g. 0
two_point_conversions
integer——
e.g. 0
two_pt_conversion_returns
integer—Defensive two-point conversion returns
e.g. 0
two_pt_pass_attempts
integer—Two-point conversion pass attempts
e.g. 0
two_pt_pass_conversions
integer—Two-point conversion pass conversions
e.g. 0
two_pt_rush_attempts
integer—Two-point conversion rush attempts
e.g. 0
two_pt_rush_conversions
integer—Two-point conversion rush conversions
e.g. 0
win
integer——
e.g. 0
yds_per_carry
decimal——
e.g. 4.0000
yds_per_completion
decimal—Passing yards per completion
e.g. 11.0000
yds_per_pass_attempt
decimal——
e.g. 6.0000
yds_per_play
decimal—Average yards per offensive play
e.g. 5.0000