Skip to main content
Version: main

NFL — nflpro

sportsdataverse.nfl — 16 endpoints.

nfl_pro_players_offense_passing_season

GET /api/secured/stats/players-offense/passing/season — one row per passer for the season — quarterback passing incl. Next Gen time-to-throw, aggressiveness and CPOE.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/players-offense/passing/season

Valid URL: https://pro.nfl.com/api/secured/stats/players-offense/passing/season?season=2024&seasonType=REG

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
sortKeysort_keyYField name to sort by, e.g. epa.
sortValuesort_valueYSort direction: ASC or DESC.
qualifiedPasserqualifiedYRestrict to players meeting the league qualifying threshold.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
nfl_idcharacterNFL ID of player (this is used in Big Data Bowl Data)
display_namecharacterFull name of player
short_namecharacterPlayer short name (i.e. "F.Last")
headshotcharacterNFL headshot url for player
team_idcharacterESPN team id.
jersey_numberintegerJersey number. Often useful for joins by name/team/jersey.
positioncharacterPrimary position as reported by NFL.com
position_groupcharacterPostion group of player as listed by NFL
ngs_positioncharacterPrimary position as reported by the NextGen stats API.
ngs_position_groupcharacterPosition group of player as listed by Next Gen Stats
gpintegerGames played.
gsintegerGames started.
tginteger
total_tginteger
cmpinteger
attinteger
ydsinteger
tdinteger
intintegerBinary flag for an interception.
ratingdoubleOverall SP+ rating (Bill Connelly methodology, in points per game).
ypadouble
cmp_pctdouble
sackintegerBinary indicator for if the play ended in a sack.
x_cmpdouble
cpoedoubleFor a single pass play this is 1 - cp when the pass was completed or 0 - cp when the pass was incomplete. Analyzed for a whole game or season an indicator for the passer how much over or under expectation his completion percentage was.
dbinteger
epadoubleExpected points added (EPA) by the posteam for the given play.
epa_dbdouble
avg_tttdouble
avg_ttpdouble
avg_ttsdouble
qbpinteger
qbp_rdouble
blitz_rdouble
dropinteger
drop_rdouble
aydoubleAcceleration of the pitch in the y-direction at y=50 ft (ft/s^2).
yacdouble
x_yacdouble
yac_pctdouble
ay_attdouble
avg_sepdouble
deep_att_pctdouble
tw_att_pctdouble
pa_db_pctdouble
qplogical
cmp_pgdouble
att_pgdouble
yds_pgdouble
td_pgdouble
int_pgdouble
sack_pgdouble
db_pgdouble
epa_pgdouble
qbp_pgdouble
drop_pgdouble
tw_att_pgdouble

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_players_offense_passing_season(season=2024, season_type='REG')

Last validated n/a.

nfl_pro_players_offense_passing_week

GET /api/secured/stats/players-offense/passing/week — one row per passer per week — quarterback passing incl. Next Gen time-to-throw, aggressiveness and CPOE.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/players-offense/passing/week

Valid URL: https://pro.nfl.com/api/secured/stats/players-offense/passing/week?season=2024&seasonType=REG

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
sortKeysort_keyYField name to sort by, e.g. epa.
sortValuesort_valueYSort direction: ASC or DESC.
qualifiedPasserqualifiedYRestrict to players meeting the league qualifying threshold.
nflIdnfl_idYOptional player filter; omit for the whole league-week table. Note week is a path scope here, not a query param.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
nfl_idcharacterNFL ID of player (this is used in Big Data Bowl Data)
display_namecharacterFull name of player
short_namecharacterPlayer short name (i.e. "F.Last")
headshotcharacterNFL headshot url for player
team_idcharacterESPN team id.
jersey_numberintegerJersey number. Often useful for joins by name/team/jersey.
positioncharacterPrimary position as reported by NFL.com
position_groupcharacterPostion group of player as listed by NFL
ngs_positioncharacterPrimary position as reported by the NextGen stats API.
ngs_position_groupcharacterPosition group of player as listed by Next Gen Stats
gpintegerGames played.
gsintegerGames started.
tginteger
total_tginteger
week_slugcharacter
game_idintegerTen digit identifier for NFL game.
fapi_game_idcharacter
opponent_team_idcharacterUnique identifier for the opponent team.
is_homelogicalWhether the subject team was the home team.
final_scorecharacter
game_resultcharacterGame result for the player's team (W/L).
cmpinteger
attinteger
ydsinteger
tdinteger
intintegerBinary flag for an interception.
ratingdoubleOverall SP+ rating (Bill Connelly methodology, in points per game).
ypadouble
cmp_pctdouble
sackintegerBinary indicator for if the play ended in a sack.
x_cmpdouble
cpoedoubleFor a single pass play this is 1 - cp when the pass was completed or 0 - cp when the pass was incomplete. Analyzed for a whole game or season an indicator for the passer how much over or under expectation his completion percentage was.
dbinteger
epadoubleExpected points added (EPA) by the posteam for the given play.
epa_dbdouble
avg_tttdouble
avg_ttpdouble
avg_ttsdouble
qbpinteger
qbp_rdouble
blitz_rdouble
dropinteger
drop_rdouble
aydoubleAcceleration of the pitch in the y-direction at y=50 ft (ft/s^2).
yacdouble
x_yacdouble
yac_pctdouble
ay_attdouble
avg_sepdouble
deep_att_pctdouble
tw_att_pctdouble
pa_db_pctdouble
qplogical
cmp_pginteger
att_pginteger
yds_pginteger
td_pginteger
int_pginteger
sack_pginteger
db_pginteger
epa_pgdouble
qbp_pginteger
drop_pginteger
tw_att_pginteger

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_players_offense_passing_week(season=2024, season_type='REG')

Last validated n/a.

nfl_pro_players_offense_rushing_season

GET /api/secured/stats/players-offense/rushing/season — one row per rusher for the season — rushing incl. Next Gen efficiency, yards over expected and defenders-in-box.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/players-offense/rushing/season

Valid URL: https://pro.nfl.com/api/secured/stats/players-offense/rushing/season?season=2024&seasonType=REG

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
sortKeysort_keyYField name to sort by, e.g. epa.
sortValuesort_valueYSort direction: ASC or DESC.
qualifiedRusherqualifiedYRestrict to players meeting the league qualifying threshold.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
nfl_idcharacterNFL ID of player (this is used in Big Data Bowl Data)
display_namecharacterFull name of player
short_namecharacterPlayer short name (i.e. "F.Last")
headshotcharacterNFL headshot url for player
team_idcharacterESPN team id.
jersey_numberintegerJersey number. Often useful for joins by name/team/jersey.
positioncharacterPrimary position as reported by NFL.com
position_groupcharacterPostion group of player as listed by NFL
ngs_positioncharacterPrimary position as reported by the NextGen stats API.
ngs_position_groupcharacterPosition group of player as listed by Next Gen Stats
gpintegerGames played.
gsintegerGames started.
tginteger
total_tginteger
attinteger
ydsinteger
tdinteger
ypcdouble
epadoubleExpected points added (EPA) by the posteam for the given play.
epa_attdouble
x_rydouble
x_ypcdouble
ryoedouble
ryoe_attdouble
yacodouble
yaco_attdouble
ybcodouble
ybco_attdouble
successdoubleBinary indicator whether epa > 0 in the given play.
fuminteger
lostinteger
rush10_p_ydsinteger
rush15_p_mphinteger
rush20_p_mphinteger
effdoubleEff.
in_t_pctdouble
st_box_pctdouble
under_pctdouble
qrlogical
att_pgdouble
yds_pgdouble
td_pgdouble
epa_pgdouble
x_ry_pgdouble
ryoe_pgdouble
yaco_pgdouble
ybco_pgdouble
fum_pgdouble
lost_pgdouble
rush10_p_yds_pgdouble
rush15_p_mph_pgdouble
rush20_p_mph_pgdouble

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_players_offense_rushing_season(season=2024, season_type='REG')

Last validated n/a.

nfl_pro_players_offense_rushing_week

GET /api/secured/stats/players-offense/rushing/week — one row per rusher per week — rushing incl. Next Gen efficiency, yards over expected and defenders-in-box.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/players-offense/rushing/week

Valid URL: https://pro.nfl.com/api/secured/stats/players-offense/rushing/week?season=2024&seasonType=REG

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
sortKeysort_keyYField name to sort by, e.g. epa.
sortValuesort_valueYSort direction: ASC or DESC.
qualifiedRusherqualifiedYRestrict to players meeting the league qualifying threshold.
nflIdnfl_idYOptional player filter; omit for the whole league-week table. Note week is a path scope here, not a query param.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
nfl_idcharacterNFL ID of player (this is used in Big Data Bowl Data)
display_namecharacterFull name of player
short_namecharacterPlayer short name (i.e. "F.Last")
headshotcharacterNFL headshot url for player
team_idcharacterESPN team id.
jersey_numberintegerJersey number. Often useful for joins by name/team/jersey.
positioncharacterPrimary position as reported by NFL.com
position_groupcharacterPostion group of player as listed by NFL
ngs_positioncharacterPrimary position as reported by the NextGen stats API.
ngs_position_groupcharacterPosition group of player as listed by Next Gen Stats
gpintegerGames played.
gsintegerGames started.
tginteger
total_tginteger
week_slugcharacter
game_idintegerTen digit identifier for NFL game.
fapi_game_idcharacter
opponent_team_idcharacterUnique identifier for the opponent team.
is_homelogicalWhether the subject team was the home team.
final_scorecharacter
game_resultcharacterGame result for the player's team (W/L).
attinteger
ydsinteger
tdinteger
ypcdouble
epadoubleExpected points added (EPA) by the posteam for the given play.
epa_attdouble
x_rydouble
x_ypcdouble
ryoedouble
ryoe_attdouble
yacodouble
yaco_attdouble
ybcodouble
ybco_attdouble
successdoubleBinary indicator whether epa > 0 in the given play.
fuminteger
lostinteger
rush10_p_ydsinteger
rush15_p_mphinteger
rush20_p_mphinteger
effdoubleEff.
in_t_pctdouble
st_box_pctinteger
under_pctdouble
qrlogical
att_pginteger
yds_pginteger
td_pginteger
epa_pgdouble
x_ry_pgdouble
ryoe_pgdouble
yaco_pgdouble
ybco_pgdouble
fum_pginteger
lost_pginteger
rush10_p_yds_pginteger
rush15_p_mph_pginteger
rush20_p_mph_pginteger

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_players_offense_rushing_week(season=2024, season_type='REG')

Last validated n/a.

nfl_pro_players_offense_receiving_season

GET /api/secured/stats/players-offense/receiving/season — one row per receiver for the season — receiving incl. Next Gen separation, cushion and catch rate over expected.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/players-offense/receiving/season

Valid URL: https://pro.nfl.com/api/secured/stats/players-offense/receiving/season?season=2024&seasonType=REG

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
sortKeysort_keyYField name to sort by, e.g. epa.
sortValuesort_valueYSort direction: ASC or DESC.
qualifiedReceiverqualifiedYRestrict to players meeting the league qualifying threshold.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
nfl_idcharacterNFL ID of player (this is used in Big Data Bowl Data)
display_namecharacterFull name of player
short_namecharacterPlayer short name (i.e. "F.Last")
headshotcharacterNFL headshot url for player
team_idcharacterESPN team id.
jersey_numberintegerJersey number. Often useful for joins by name/team/jersey.
positioncharacterPrimary position as reported by NFL.com
position_groupcharacterPostion group of player as listed by NFL
ngs_positioncharacterPrimary position as reported by the NextGen stats API.
ngs_position_groupcharacterPosition group of player as listed by Next Gen Stats
gpintegerGames played.
gsintegerGames started.
tginteger
total_tginteger
rtinteger
tgtinteger
recinteger
ydsinteger
tdinteger
intintegerBinary flag for an interception.
ratingdoubleOverall SP+ rating (Bill Connelly methodology, in points per game).
catchdouble
x_catchdouble
croedouble
yds_recdouble
yds_rtdouble
epadoubleExpected points added (EPA) by the posteam for the given play.
epa_tgtdouble
epa_rtdouble
dropinteger
drop_tgtdouble
yacinteger
x_yacinteger
yacoeinteger
yac_recdouble
avg_sepdouble
aydoubleAcceleration of the pitch in the y-direction at y=50 ft (ft/s^2).
ay_tgtdouble
tgt_rtdouble
avg_rt_depdouble
ez_tgtinteger
ez_recinteger
deep_tgt_pctdouble
tw_pctdouble
qrlogical
rt_pgdouble
tgt_pgdouble
rec_pgdouble
yds_pgdouble
td_pgdouble
int_pgdouble
epa_pgdouble
drop_pgdouble
yac_pgdouble
x_yac_pgdouble
yacoe_pgdouble
ay_pgdouble
ez_tgt_pgdouble
ez_rec_pgdouble

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_players_offense_receiving_season(season=2024, season_type='REG')

Last validated n/a.

nfl_pro_players_offense_receiving_week

GET /api/secured/stats/players-offense/receiving/week — one row per receiver per week — receiving incl. Next Gen separation, cushion and catch rate over expected.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/players-offense/receiving/week

Valid URL: https://pro.nfl.com/api/secured/stats/players-offense/receiving/week?season=2024&seasonType=REG

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
sortKeysort_keyYField name to sort by, e.g. epa.
sortValuesort_valueYSort direction: ASC or DESC.
qualifiedReceiverqualifiedYRestrict to players meeting the league qualifying threshold.
nflIdnfl_idYOptional player filter; omit for the whole league-week table. Note week is a path scope here, not a query param.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
nfl_idcharacterNFL ID of player (this is used in Big Data Bowl Data)
display_namecharacterFull name of player
short_namecharacterPlayer short name (i.e. "F.Last")
headshotcharacterNFL headshot url for player
team_idcharacterESPN team id.
jersey_numberintegerJersey number. Often useful for joins by name/team/jersey.
positioncharacterPrimary position as reported by NFL.com
position_groupcharacterPostion group of player as listed by NFL
ngs_positioncharacterPrimary position as reported by the NextGen stats API.
ngs_position_groupcharacterPosition group of player as listed by Next Gen Stats
gpintegerGames played.
gsintegerGames started.
tginteger
total_tginteger
week_slugcharacter
game_idintegerTen digit identifier for NFL game.
fapi_game_idcharacter
opponent_team_idcharacterUnique identifier for the opponent team.
is_homelogicalWhether the subject team was the home team.
final_scorecharacter
game_resultcharacterGame result for the player's team (W/L).
rtinteger
tgtinteger
recinteger
ydsinteger
tdinteger
intintegerBinary flag for an interception.
ratingintegerOverall SP+ rating (Bill Connelly methodology, in points per game).
catchinteger
x_catchinteger
croeinteger
yds_recinteger
yds_rtinteger
epaintegerExpected points added (EPA) by the posteam for the given play.
epa_tgtinteger
epa_rtinteger
dropinteger
drop_tgtinteger
yacinteger
x_yacinteger
yacoeinteger
yac_recinteger
avg_sepinteger
ayintegerAcceleration of the pitch in the y-direction at y=50 ft (ft/s^2).
ay_tgtinteger
tgt_rtinteger
avg_rt_depinteger
ez_tgtinteger
ez_recinteger
deep_tgt_pctinteger
tw_pctinteger
qrlogical
rt_pginteger
tgt_pginteger
rec_pginteger
yds_pginteger
td_pginteger
int_pginteger
epa_pginteger
drop_pginteger
yac_pginteger
x_yac_pginteger
yacoe_pginteger
ay_pginteger
ez_tgt_pginteger
ez_rec_pginteger

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_players_offense_receiving_week(season=2024, season_type='REG')

Last validated n/a.

nfl_pro_defense_overview_season

GET /api/secured/stats/defense/overview/season — one row per defender for the season — defensive overview incl. snap counts, pressures and havoc stops.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/defense/overview/season

Valid URL: https://pro.nfl.com/api/secured/stats/defense/overview/season?season=2024&seasonType=REG

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
sortKeysort_keyYField name to sort by, e.g. epa.
sortValuesort_valueYSort direction: ASC or DESC.
qualifiedDefenderqualifiedYRestrict to players meeting the league qualifying threshold.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
nfl_idcharacterNFL ID of player (this is used in Big Data Bowl Data)
display_namecharacterFull name of player
short_namecharacterPlayer short name (i.e. "F.Last")
headshotcharacterNFL headshot url for player
team_idcharacterESPN team id.
jersey_numberintegerJersey number. Often useful for joins by name/team/jersey.
positioncharacterPrimary position as reported by NFL.com
position_groupcharacterPostion group of player as listed by NFL
ngs_positioncharacterPrimary position as reported by the NextGen stats API.
ngs_position_groupcharacterPosition group of player as listed by Next Gen Stats
gpintegerGames played.
gsintegerGames started.
tginteger
total_tginteger
snapinteger
snap_pctdouble
rdinteger
printeger
tckinteger
t_stopinteger
h_stopinteger
qbpinteger
qbp_rdouble
sackdoubleBinary indicator for if the play ended in a sack.
tgt_ndinteger
rec_ndinteger
rec_yds_ndinteger
rec_td_ndinteger
intintegerBinary flag for an interception.
pass_rating_nddouble
qdlogical
game_snapinteger
team_snapinteger

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_defense_overview_season(season=2024, season_type='REG')

Last validated n/a.

nfl_pro_defense_overview_week

GET /api/secured/stats/defense/overview/week — one row per defender per week — defensive overview incl. snap counts, pressures and havoc stops.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/defense/overview/week

Valid URL: https://pro.nfl.com/api/secured/stats/defense/overview/week?season=2024&seasonType=REG

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
sortKeysort_keyYField name to sort by, e.g. epa.
sortValuesort_valueYSort direction: ASC or DESC.
qualifiedDefenderqualifiedYRestrict to players meeting the league qualifying threshold.
nflIdnfl_idYOptional player filter; omit for the whole league-week table. Note week is a path scope here, not a query param.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
nfl_idcharacterNFL ID of player (this is used in Big Data Bowl Data)
display_namecharacterFull name of player
short_namecharacterPlayer short name (i.e. "F.Last")
headshotcharacterNFL headshot url for player
team_idcharacterESPN team id.
jersey_numberintegerJersey number. Often useful for joins by name/team/jersey.
positioncharacterPrimary position as reported by NFL.com
position_groupcharacterPostion group of player as listed by NFL
ngs_positioncharacterPrimary position as reported by the NextGen stats API.
ngs_position_groupcharacterPosition group of player as listed by Next Gen Stats
gpintegerGames played.
gsintegerGames started.
tginteger
total_tginteger
week_slugcharacter
game_idintegerTen digit identifier for NFL game.
fapi_game_idcharacter
opponent_team_idcharacterUnique identifier for the opponent team.
is_homelogicalWhether the subject team was the home team.
final_scorecharacter
game_resultcharacterGame result for the player's team (W/L).
snapinteger
snap_pctdouble
rdinteger
printeger
tckinteger
t_stopinteger
h_stopinteger
qbpinteger
qbp_rdouble
sackintegerBinary indicator for if the play ended in a sack.
tgt_ndinteger
rec_ndinteger
rec_yds_ndinteger
rec_td_ndinteger
intintegerBinary flag for an interception.
pass_rating_nddouble
qdlogical
game_snapinteger
team_snapinteger

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_defense_overview_week(season=2024, season_type='REG')

Last validated n/a.

nfl_pro_defense_nearest_season

GET /api/secured/stats/defense/nearest/season — one row per defender for the season — nearest-defender coverage incl. targets, catch rate and CROE allowed.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/defense/nearest/season

Valid URL: https://pro.nfl.com/api/secured/stats/defense/nearest/season?season=2024&seasonType=REG

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
sortKeysort_keyYField name to sort by, e.g. epa.
sortValuesort_valueYSort direction: ASC or DESC.
qualifiedDefenderqualifiedYRestrict to players meeting the league qualifying threshold.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
nfl_idcharacterNFL ID of player (this is used in Big Data Bowl Data)
display_namecharacterFull name of player
short_namecharacterPlayer short name (i.e. "F.Last")
headshotcharacterNFL headshot url for player
team_idcharacterESPN team id.
jersey_numberintegerJersey number. Often useful for joins by name/team/jersey.
positioncharacterPrimary position as reported by NFL.com
position_groupcharacterPostion group of player as listed by NFL
ngs_positioncharacterPrimary position as reported by the NextGen stats API.
ngs_position_groupcharacterPosition group of player as listed by Next Gen Stats
gpintegerGames played.
gsintegerGames started.
tginteger
total_tginteger
covinteger
cov_ndinteger
tgt_ndinteger
rec_ndinteger
rec_yds_ndinteger
rec_td_ndinteger
intintegerBinary flag for an interception.
pass_rating_nddouble
catch_nddouble
croe_nddouble
tgt_epa_nddouble
tgt_r_nddouble
sepdouble
twf_pctdouble
bh_pctdouble
yacpr_nddouble
qdlogical
game_snapinteger
team_snapinteger

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_defense_nearest_season(season=2024, season_type='REG')

Last validated n/a.

nfl_pro_defense_nearest_week

GET /api/secured/stats/defense/nearest/week — one row per defender per week — nearest-defender coverage incl. targets, catch rate and CROE allowed.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/defense/nearest/week

Valid URL: https://pro.nfl.com/api/secured/stats/defense/nearest/week?season=2024&seasonType=REG

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
sortKeysort_keyYField name to sort by, e.g. epa.
sortValuesort_valueYSort direction: ASC or DESC.
qualifiedDefenderqualifiedYRestrict to players meeting the league qualifying threshold.
nflIdnfl_idYOptional player filter; omit for the whole league-week table. Note week is a path scope here, not a query param.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
nfl_idcharacterNFL ID of player (this is used in Big Data Bowl Data)
display_namecharacterFull name of player
short_namecharacterPlayer short name (i.e. "F.Last")
headshotcharacterNFL headshot url for player
team_idcharacterESPN team id.
jersey_numberintegerJersey number. Often useful for joins by name/team/jersey.
positioncharacterPrimary position as reported by NFL.com
position_groupcharacterPostion group of player as listed by NFL
ngs_positioncharacterPrimary position as reported by the NextGen stats API.
ngs_position_groupcharacterPosition group of player as listed by Next Gen Stats
gpintegerGames played.
gsintegerGames started.
tginteger
total_tginteger
week_slugcharacter
game_idintegerTen digit identifier for NFL game.
fapi_game_idcharacter
opponent_team_idcharacterUnique identifier for the opponent team.
is_homelogicalWhether the subject team was the home team.
final_scorecharacter
game_resultcharacterGame result for the player's team (W/L).
covinteger
cov_ndinteger
tgt_ndinteger
rec_ndinteger
rec_yds_ndinteger
rec_td_ndinteger
intintegerBinary flag for an interception.
pass_rating_nddouble
catch_nddouble
croe_nddouble
tgt_epa_nddouble
tgt_r_nddouble
sepdouble
twf_pctinteger
bh_pctdouble
yacpr_nddouble
qdlogical
game_snapinteger
team_snapinteger

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_defense_nearest_week(season=2024, season_type='REG')

Last validated n/a.

nfl_pro_team_offense_overview_season

GET /api/secured/stats/team-offense/overview/season — one row per team for the season — team offensive overview incl. EPA per play, pass and rush splits.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/team-offense/overview/season

Valid URL: https://pro.nfl.com/api/secured/stats/team-offense/overview/season?season=2024&seasonType=REG

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
sortKeysort_keyYField name to sort by, e.g. epa.
sortValuesort_valueYSort direction: ASC or DESC.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
team_idcharacterESPN team id.
gpintegerGames played.
totalintegerThe sum of each team's score in the game. Equals h_score + v_score. Is NA for games which haven't yet been played. Convenient for evaluating over/under total bets.
passintegerBinary indicator if the play was a pass play (sacks and scrambles included).
runintegerExpected Points Added on run plays
pass_pctdouble
ppgdoublePoints per game.
ydsinteger
ypgdouble
yppdouble
tdinteger
epadoubleExpected points added (EPA) by the posteam for the given play.
epa_ppdouble
pass_ydsinteger
pass_ypgdouble
pass_yppdouble
sacked_ydsinteger
sacked_ypgdouble
epa_passdouble
epa_pass_ppdouble
rush_ydsintegerRushing yards gained on the play.
rush_ypgdouble
rush_yppdouble
epa_rushdouble
epa_rush_ppdouble
ryoedouble
tttdouble
qbpinteger
qbp_pctdouble

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_team_offense_overview_season(season=2024, season_type='REG')

Last validated n/a.

nfl_pro_team_offense_overview_week

GET /api/secured/stats/team-offense/overview/week — one row per team per week — team offensive overview incl. EPA per play, pass and rush splits.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/team-offense/overview/week

Valid URL: https://pro.nfl.com/api/secured/stats/team-offense/overview/week?season=2024&seasonType=REG

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
sortKeysort_keyYField name to sort by, e.g. epa.
sortValuesort_valueYSort direction: ASC or DESC.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
team_idcharacterESPN team id.
gpintegerGames played.
totalintegerThe sum of each team's score in the game. Equals h_score + v_score. Is NA for games which haven't yet been played. Convenient for evaluating over/under total bets.
passintegerBinary indicator if the play was a pass play (sacks and scrambles included).
runintegerExpected Points Added on run plays
pass_pctdouble
ppgintegerPoints per game.
ydsinteger
ypginteger
yppdouble
tdinteger
epadoubleExpected points added (EPA) by the posteam for the given play.
epa_ppdouble
pass_ydsinteger
pass_ypginteger
pass_yppdouble
sacked_ydsinteger
sacked_ypginteger
epa_passdouble
epa_pass_ppdouble
rush_ydsintegerRushing yards gained on the play.
rush_ypginteger
rush_yppdouble
epa_rushdouble
epa_rush_ppdouble
ryoedouble
tttdouble
qbpinteger
qbp_pctdouble
week_slugcharacter
opponent_team_idcharacterUnique identifier for the opponent team.
game_resultcharacterGame result for the player's team (W/L).
final_scorecharacter
is_homelogicalWhether the subject team was the home team.
game_idintegerTen digit identifier for NFL game.
fapi_game_idcharacter

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_team_offense_overview_week(season=2024, season_type='REG')

Last validated n/a.

nfl_pro_team_defense_overview_season

GET /api/secured/stats/team-defense/overview/season — one row per team for the season — team defensive overview incl. EPA allowed per play and takeaways.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/team-defense/overview/season

Valid URL: https://pro.nfl.com/api/secured/stats/team-defense/overview/season?season=2024&seasonType=REG

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
sortKeysort_keyYField name to sort by, e.g. epa.
sortValuesort_valueYSort direction: ASC or DESC.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
team_idcharacterESPN team id.
gpintegerGames played.
totalintegerThe sum of each team's score in the game. Equals h_score + v_score. Is NA for games which haven't yet been played. Convenient for evaluating over/under total bets.
passintegerBinary indicator if the play was a pass play (sacks and scrambles included).
runintegerExpected Points Added on run plays
pass_pctdouble
ppgdoublePoints per game.
ydsinteger
ypgdouble
yppdouble
tdinteger
pass_tdintegerBinary flag for a passing touchdown.
rush_tdintegerBinary flag for a rushing touchdown.
epadoubleExpected points added (EPA) by the posteam for the given play.
epa_ppdouble
pass_ydsinteger
pass_ypgdouble
pass_yppdouble
sacked_ydsinteger
sacked_ypgdouble
epa_passdouble
epa_pass_ppdouble
rush_ydsintegerRushing yards gained on the play.
rush_ypgdouble
rush_yppdouble
epa_rushdouble
epa_rush_ppdouble
ryoedouble
tttdouble
qbpinteger
qbp_pctdouble
interceptionintegerBinary indicator for if the pass was intercepted.
forced_fumbleinteger
fumble_recoveredinteger
defensive_touchdowninteger
total_takeawaysinteger

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_team_defense_overview_season(season=2024, season_type='REG')

Last validated n/a.

nfl_pro_team_defense_overview_week

GET /api/secured/stats/team-defense/overview/week — one row per team per week — team defensive overview incl. EPA allowed per play and takeaways.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/team-defense/overview/week

Valid URL: https://pro.nfl.com/api/secured/stats/team-defense/overview/week?season=2024&seasonType=REG

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
sortKeysort_keyYField name to sort by, e.g. epa.
sortValuesort_valueYSort direction: ASC or DESC.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
team_idcharacterESPN team id.
gpintegerGames played.
totalintegerThe sum of each team's score in the game. Equals h_score + v_score. Is NA for games which haven't yet been played. Convenient for evaluating over/under total bets.
passintegerBinary indicator if the play was a pass play (sacks and scrambles included).
runintegerExpected Points Added on run plays
pass_pctdouble
ppgintegerPoints per game.
ydsinteger
ypginteger
yppdouble
tdinteger
pass_tdintegerBinary flag for a passing touchdown.
rush_tdintegerBinary flag for a rushing touchdown.
epadoubleExpected points added (EPA) by the posteam for the given play.
epa_ppdouble
pass_ydsinteger
pass_ypginteger
pass_yppdouble
sacked_ydsinteger
sacked_ypginteger
epa_passdouble
epa_pass_ppdouble
rush_ydsintegerRushing yards gained on the play.
rush_ypginteger
rush_yppdouble
epa_rushdouble
epa_rush_ppdouble
ryoedouble
tttdouble
qbpinteger
qbp_pctdouble
interceptionintegerBinary indicator for if the pass was intercepted.
forced_fumbleinteger
fumble_recoveredinteger
defensive_touchdowninteger
total_takeawaysinteger
week_slugcharacter
opponent_team_idcharacterUnique identifier for the opponent team.
game_resultcharacterGame result for the player's team (W/L).
final_scorecharacter
is_homelogicalWhether the subject team was the home team.
game_idintegerTen digit identifier for NFL game.
fapi_game_idcharacter

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_team_defense_overview_week(season=2024, season_type='REG')

Last validated n/a.

nfl_pro_fantasy_season

GET /api/secured/stats/fantasy/season — one row per player for the season — fantasy points, opportunity and usage.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/fantasy/season

Valid URL: https://pro.nfl.com/api/secured/stats/fantasy/season?season=2024&seasonType=REG

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
nflIdnfl_idYOptional player filter.
positionGroupposition_groupYOptional position-group filter, e.g. QB. Optional on this season scope — it is the game scope that requires it.
sortKeysort_keyYField name to sort by, e.g. fpHalfPPR.
sortValuesort_valueYSort direction: ASC or DESC.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
nfl_idcharacterNFL ID of player (this is used in Big Data Bowl Data)
display_namecharacterFull name of player
short_namecharacterPlayer short name (i.e. "F.Last")
headshotcharacterNFL headshot url for player
team_idcharacterESPN team id.
jersey_numberintegerJersey number. Often useful for joins by name/team/jersey.
positioncharacterPrimary position as reported by NFL.com
position_groupcharacterPostion group of player as listed by NFL
gpintegerGames played.
gsintegerGames started.
o_snapinteger
o_snap3rdinteger
o_tm_snapinteger
o_snap_pgdouble
pt_pctdouble
pt_pct3rddouble
pass_cmpinteger
pass_attinteger
pass_ydinteger
pass_tdintegerBinary flag for a passing touchdown.
pass_intinteger
pass_two_pt_convinteger
pass_dbinteger
pass_cmp_pctdouble
pass_exp_cmp_pctdouble
pass_cpoedouble
pass_ratingdouble
pass_avg_tttdouble
pass_ay_padouble
pass_deep_att_pctdouble
pass_yac_pctdouble
pass_qbpinteger
pass_qbp_pctdouble
pass_sackinteger
pass_sack_pgdouble
pass_cmp_pgdouble
pass_att_pgdouble
pass_yd_pgdouble
pass_td_pgdouble
pass_int_pgdouble
pass_db_pgdouble
rush_attinteger
rush_ydinteger
rush_tdintegerBinary flag for a rushing touchdown.
rush_two_pt_convinteger
rush_exp_ydinteger
rush_ryoeinteger
rush_att_pgdouble
rush_yd_pgdouble
rush_yd_padouble
rush_yacodouble
rush_ybcodouble
rush_yaco_padouble
rush_ybco_padouble
rush_stuffedinteger
rush_td_pgdouble
scr_rush_attinteger
scr_rush_ydinteger
scr_rush_tdinteger
scr_rush_pctdouble
design_rush_attinteger
design_rush_ydinteger
design_rush_tdinteger
rush_rz_attinteger
rush_gl_attinteger
rush10_plus_ydinteger
rec_rtinteger
rec_tgtinteger
rec_recinteger
rec_ydinteger
rec_tdinteger
rec_two_pt_convinteger
rec_rt_pgdouble
rec_tgt_pgdouble
rec_rec_pgdouble
rec_yd_pgdouble
rec_td_pgdouble
rec_catch_pctdouble
rec_ay_sharedouble
rec_tgt_ratedouble
rec_tgt_sharedouble
rec_rt_part_pctdouble
rec_tgt_quickinteger
rec_tgt_play_actinteger
rec_ez_tgtinteger
rec_ez_recinteger
rec_rz_tgtinteger
rec_ay_tgtinteger
rec_ay_recinteger
rec_ay_unrealizedinteger
rec_ay_ptdouble
rec_tgt_ay10_plusinteger
rec_yd_p_rtdouble
rec_yd_ptdouble
rec_yd_prdouble
rec_yacinteger
rec_exp_yacinteger
rec_yacoeinteger
kick_xp_attinteger
kick_xp_madeinteger
kick_fg_attinteger
kick_fg_madeinteger
kick_fg_missinteger
kick_fg_made_less40integer
kick_fg_made40_to49integer
kick_fg_made50_to59integer
kick_fg_made60_plusinteger
misc_kickoff_ret_tdinteger
misc_punt_ret_tdinteger
misc_fum_rec_tdinteger
misc_fum_lostinteger
misc_fuminteger
misc_int_ret_tdinteger
misc_fum_ret_tdinteger
misc_blk_punt_fg_ret_tdinteger
misc_two_pt_retinteger
misc_one_pt_safetyinteger
o_touchinteger
o_oppinteger
o_opp_pgdouble
o_miss_tkl_forcedinteger
o_miss_tkl_forced_pctdouble
o_tm_dbinteger
o_tm_pass_pctdouble
o_tm_ppgdouble
o_tm_yd_pgdouble
rz_oppinteger
fp_stddouble
fp_half_pprdouble
fp_pprdouble
fp_passdouble
fp_rushdouble
fp_rec_stddouble
fp_rec_half_pprdouble
fp_rec_pprdouble
fp_kickinteger
fp_miscinteger
fp_pg_stddouble
fp_pg_half_pprdouble
fp_pgpprdouble
fp_pos_rk_stdinteger
fp_pos_rk_half_pprinteger
fp_pos_rk_pprinteger
fp_pos_rk_lbl_stdcharacter
fp_pos_rk_lbl_half_pprcharacter
fp_pos_rk_lbl_pprcharacter
fp_ps_stddouble
fp_ps_half_pprdouble
fp_pspprdouble
fp_p_rt_stddouble
fp_p_rt_half_pprdouble
fp_p_rt_pprdouble
fp_pt_stddouble
fp_pt_half_pprdouble
fp_ptpprdouble
fp_po_stddouble
fp_po_half_pprdouble
fp_popprdouble
top5_qb_wk_stdinteger
top12_qb_wk_stdinteger
top12_rb_wk_stdinteger
top24_rb_wk_stdinteger
top12_wr_wk_stdinteger
top24_wr_wk_stdinteger
top36_wr_wk_stdinteger
top5_te_wk_stdinteger
top12_te_wk_stdinteger
top5_k_wk_stdinteger
top12_k_wk_stdinteger
top5_qb_wk_half_pprinteger
top12_qb_wk_half_pprinteger
top12_rb_wk_half_pprinteger
top24_rb_wk_half_pprinteger
top12_wr_wk_half_pprinteger
top24_wr_wk_half_pprinteger
top36_wr_wk_half_pprinteger
top5_te_wk_half_pprinteger
top12_te_wk_half_pprinteger
top5_k_wk_half_pprinteger
top12_k_wk_half_pprinteger
top5_qb_wk_pprinteger
top12_qb_wk_pprinteger
top12_rb_wk_pprinteger
top24_rb_wk_pprinteger
top12_wr_wk_pprinteger
top24_wr_wk_pprinteger
top36_wr_wk_pprinteger
top5_te_wk_pprinteger
top12_te_wk_pprinteger
top5_k_wk_pprinteger
top12_k_wk_pprinteger

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_fantasy_season(season=2024, season_type='REG')

Last validated n/a.

nfl_pro_fantasy_game

GET /api/secured/stats/fantasy/game — one row per player-game — fantasy scoring by game. Requires position_group.

Endpoint URL: GET https://pro.nfl.com/api/secured/stats/fantasy/game

Valid URL: https://pro.nfl.com/api/secured/stats/fantasy/game?season=2024&seasonType=REG&positionGroup=QB

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason, as the STARTING year (2024 = the 2024-25 NFL season).
seasonTypeseason_typeYSeason type code (string): PRE, REG, or POST -- not ESPN's numeric 1/2/3.
limitlimitYPage size. Responses truncate silently at this many rows; the getter pages on offset until it has them all.
offsetoffsetYZero-based row offset. The getter pages on this automatically; set it only to fetch a specific slice.
nflIdnfl_idYOptional player filter.
positionGroupposition_groupYPosition group, e.g. QB. Required: this scope returns HTTP 500 without it, so it is a required argument rather than an optional filter.
sortKeysort_keyYField name to sort by, e.g. fpHalfPPR.
sortValuesort_valueYSort direction: ASC or DESC.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
nfl_idcharacterNFL ID of player (this is used in Big Data Bowl Data)
display_namecharacterFull name of player
short_namecharacterPlayer short name (i.e. "F.Last")
headshotcharacterNFL headshot url for player
team_idcharacterESPN team id.
jersey_numberintegerJersey number. Often useful for joins by name/team/jersey.
positioncharacterPrimary position as reported by NFL.com
position_groupcharacterPostion group of player as listed by NFL
gpintegerGames played.
gsintegerGames started.
week_slugcharacter
game_idintegerTen digit identifier for NFL game.
fapi_game_idcharacter
opponent_team_idcharacterUnique identifier for the opponent team.
is_homelogicalWhether the subject team was the home team.
final_scorecharacter
game_resultcharacterGame result for the player's team (W/L).
o_snapinteger
o_snap3rdinteger
o_tm_snapinteger
o_snap_pginteger
pt_pctdouble
pt_pct3rddouble
pass_cmpinteger
pass_attinteger
pass_ydinteger
pass_tdintegerBinary flag for a passing touchdown.
pass_intinteger
pass_two_pt_convinteger
pass_dbinteger
pass_cmp_pctdouble
pass_exp_cmp_pctdouble
pass_cpoedouble
pass_ratingdouble
pass_avg_tttdouble
pass_ay_padouble
pass_deep_att_pctdouble
pass_yac_pctdouble
pass_qbpinteger
pass_qbp_pctdouble
pass_sackinteger
pass_sack_pginteger
pass_cmp_pginteger
pass_att_pginteger
pass_yd_pginteger
pass_td_pginteger
pass_int_pginteger
pass_db_pginteger
rush_attinteger
rush_ydinteger
rush_tdintegerBinary flag for a rushing touchdown.
rush_two_pt_convinteger
rush_exp_ydinteger
rush_ryoeinteger
rush_att_pginteger
rush_yd_pginteger
rush_yd_padouble
rush_yacodouble
rush_ybcodouble
rush_yaco_padouble
rush_ybco_padouble
rush_stuffedinteger
rush_td_pginteger
scr_rush_attinteger
scr_rush_ydinteger
scr_rush_tdinteger
scr_rush_pctdouble
design_rush_attinteger
design_rush_ydinteger
design_rush_tdinteger
rush_rz_attinteger
rush_gl_attinteger
rush10_plus_ydinteger
rec_rtinteger
rec_tgtinteger
rec_recinteger
rec_ydinteger
rec_tdinteger
rec_two_pt_convinteger
rec_rt_pginteger
rec_tgt_pginteger
rec_rec_pginteger
rec_yd_pginteger
rec_td_pginteger
rec_catch_pctinteger
rec_ay_shareinteger
rec_tgt_rateinteger
rec_tgt_shareinteger
rec_rt_part_pctdouble
rec_tgt_quickinteger
rec_tgt_play_actinteger
rec_ez_tgtinteger
rec_ez_recinteger
rec_rz_tgtinteger
rec_ay_tgtinteger
rec_ay_recinteger
rec_ay_unrealizedinteger
rec_ay_ptinteger
rec_tgt_ay10_plusinteger
rec_yd_p_rtinteger
rec_yd_ptinteger
rec_yd_printeger
rec_yacinteger
rec_exp_yacinteger
rec_yacoeinteger
kick_xp_attinteger
kick_xp_madeinteger
kick_fg_attinteger
kick_fg_madeinteger
kick_fg_missinteger
kick_fg_made_less40integer
kick_fg_made40_to49integer
kick_fg_made50_to59integer
kick_fg_made60_plusinteger
misc_kickoff_ret_tdinteger
misc_punt_ret_tdinteger
misc_fum_rec_tdinteger
misc_fum_lostinteger
misc_fuminteger
misc_int_ret_tdinteger
misc_fum_ret_tdinteger
misc_blk_punt_fg_ret_tdinteger
misc_two_pt_retinteger
misc_one_pt_safetyinteger
o_touchinteger
o_oppinteger
o_opp_pginteger
o_miss_tkl_forcedinteger
o_miss_tkl_forced_pctinteger
o_tm_dbinteger
o_tm_pass_pctdouble
o_tm_ppginteger
o_tm_yd_pginteger
rz_oppinteger
fp_stddouble
fp_half_pprdouble
fp_pprdouble
fp_passdouble
fp_rushdouble
fp_rec_stdinteger
fp_rec_half_pprinteger
fp_rec_pprinteger
fp_kickinteger
fp_miscinteger
fp_pg_stddouble
fp_pg_half_pprdouble
fp_pgpprdouble
fp_pos_rk_stdinteger
fp_pos_rk_half_pprinteger
fp_pos_rk_pprinteger
fp_pos_rk_lbl_stdcharacter
fp_pos_rk_lbl_half_pprcharacter
fp_pos_rk_lbl_pprcharacter
fp_ps_stddouble
fp_ps_half_pprdouble
fp_pspprdouble
fp_p_rt_stddouble
fp_p_rt_half_pprdouble
fp_p_rt_pprdouble
fp_pt_stdinteger
fp_pt_half_pprinteger
fp_ptpprinteger
fp_po_stddouble
fp_po_half_pprdouble
fp_popprdouble
top5_qb_wk_stdinteger
top12_qb_wk_stdinteger
top12_rb_wk_stdinteger
top24_rb_wk_stdinteger
top12_wr_wk_stdinteger
top24_wr_wk_stdinteger
top36_wr_wk_stdinteger
top5_te_wk_stdinteger
top12_te_wk_stdinteger
top5_k_wk_stdinteger
top12_k_wk_stdinteger
top5_qb_wk_half_pprinteger
top12_qb_wk_half_pprinteger
top12_rb_wk_half_pprinteger
top24_rb_wk_half_pprinteger
top12_wr_wk_half_pprinteger
top24_wr_wk_half_pprinteger
top36_wr_wk_half_pprinteger
top5_te_wk_half_pprinteger
top12_te_wk_half_pprinteger
top5_k_wk_half_pprinteger
top12_k_wk_half_pprinteger
top5_qb_wk_pprinteger
top12_qb_wk_pprinteger
top12_rb_wk_pprinteger
top24_rb_wk_pprinteger
top12_wr_wk_pprinteger
top24_wr_wk_pprinteger
top36_wr_wk_pprinteger
top5_te_wk_pprinteger
top12_te_wk_pprinteger
top5_k_wk_pprinteger
top12_k_wk_pprinteger

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

nfl_pro_fantasy_game(season=2024, season_type='REG', position_group='QB')

Last validated n/a.