NFL game_team_stats API
game_team_stats
nfl.game_team_statsEach 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_statsList game_team_stats for NFL
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
team_idquerybigintoptionalFilter by team.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/jsonResponse Schema(131 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
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}Get a single game_team_stat by id
Parameters
idpathbigintrequiredPrimary 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 ▸
| Field | Type | References | Description |
|---|---|---|---|
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 |