Skip to main content
Version: main

NFL — PFF Premium Stats (premium.pff.com)

sportsdataverse.nfl — 46 endpoints.

pff_facet_run_defense_summary

Facet report /defense/run (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/defense/run

Valid URL: https://premium.pff.com/api/v1/facet/defense/run

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
assistsnumericTotal assists.
avg_depth_of_tacklenumeric
declined_penaltiesnumeric
draft_seasonnumeric
eligible_seasonnumeric
forced_fumblesnumeric
franchise_idnumericESPN franchise identifier.
grades_coverage_defensenumeric
grades_defensenumeric
grades_defense_penaltynumeric
grades_pass_rush_defensenumeric
grades_run_defensenumeric
grades_tacklenumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
missed_tackle_ratenumeric
missed_tacklesnumeric
penaltiesnumericTotal number of penalties.
playercharacterPlayer name
player_game_countnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
positioncharacterPrimary position as reported by NFL.com
run_stop_oppnumeric
snap_counts_runnumeric
stop_percentnumeric
stopsnumeric
tacklesnumericTeam tackles.
teamcharacterNFL team. Uses official abbreviations as per NFL.com
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').

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

Example

pff_facet_run_defense_summary()

Last validated n/a.

pff_facet_field_goal_summary

Facet report /field_goal/summary (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/field_goal/summary

Valid URL: https://premium.pff.com/api/v1/facet/field_goal/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
twenty_attemptsnumeric
pat_percentnumeric
draft_seasonnumeric
forty_madenumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
fifty_percentnumeric
total_madenumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
one_madenumeric
fifty_attemptsnumeric
forty_attemptsnumeric
player_game_countnumeric
eligible_seasonnumeric
thirty_percentnumeric
total_attemptsnumeric
pat_attemptsnumeric
twenty_madenumeric
one_attemptsnumeric
grades_fgep_kickernumeric
thirty_attemptsnumeric
penaltiesnumericTotal number of penalties.
pat_madenumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
declined_penaltiesnumeric
one_percentnumeric
total_percentnumeric
positioncharacterPrimary position as reported by NFL.com
twenty_percentnumeric
forty_percentnumeric
playercharacterPlayer name
franchise_idnumericESPN franchise identifier.
fifty_madenumeric
thirty_madenumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters

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

Example

pff_facet_field_goal_summary()

Last validated n/a.

pff_facet_coverage_summary

Facet report /defense/coverage (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/defense/coverage

Valid URL: https://premium.pff.com/api/v1/facet/defense/coverage

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
targetsnumericThe number of pass plays where the player was the targeted receiver.
yards_per_coverage_snapnumeric
draft_seasonnumeric
missed_tacklesnumeric
catch_ratenumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
tacklesnumericTeam tackles.
coverage_percentnumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
dropped_intsnumeric
player_game_countnumeric
eligible_seasonnumeric
grades_tacklenumeric
yardsnumericThe number of receiving yards
receptionsnumericThe number of pass receptions. Lateral receptions officially don't count as reception.
forced_incompletion_ratenumeric
grades_coverage_defensenumeric
interceptionsnumericThe number of interceptions thrown.
snap_counts_coveragenumeric
grades_run_defensenumeric
snap_counts_pass_playnumeric
penaltiesnumericTotal number of penalties.
forced_incompletesnumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
coverage_snaps_per_targetnumeric
stopsnumeric
declined_penaltiesnumeric
positioncharacterPrimary position as reported by NFL.com
longestnumeric
missed_tackle_ratenumeric
grades_defensenumeric
yards_per_receptionnumeric
grades_defense_penaltynumeric
playercharacterPlayer name
franchise_idnumericESPN franchise identifier.
yards_after_catchnumericNumeric value for distance in yards perpendicular to the yard line where the receiver made the reception to where the play ended.
avg_depth_of_targetnumeric
pass_break_upsnumeric
qb_rating_againstnumeric
coverage_snaps_per_receptionnumeric
assistsnumericTotal assists.
grades_pass_rush_defensenumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
touchdownsnumeric

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

Example

pff_facet_coverage_summary()

Last validated n/a.

pff_facet_kicking_summary

Facet report /kickoff/summary (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/kickoff/summary

Valid URL: https://premium.pff.com/api/v1/facet/kickoff/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
attemptsnumericThe number of pass attempts as defined by the NFL.
attempts_with_hangtimenumeric
average_distancenumeric
average_hangtimenumeric
average_starting_field_positionnumeric
average_yards_per_returnnumeric
declined_penaltiesnumeric
draft_seasonnumeric
eligible_seasonnumeric
fair_catchesnumeric
franchise_idnumericESPN franchise identifier.
grades_kickoff_kickernumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
kicked_yardsnumeric
kicks_returnednumeric
onside_kicksnumeric
penaltiesnumericTotal number of penalties.
percent_returnednumeric
playercharacterPlayer name
player_game_countnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
positioncharacterPrimary position as reported by NFL.com
return_yardsnumericYards gained by the return team. Returns may occur on any of: interception, fumble, kickoff, punt, or blocked kicks.
teamcharacterNFL team. Uses official abbreviations as per NFL.com
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
total_hangtimenumeric
touchbacksnumeric

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

Example

pff_facet_kicking_summary()

Last validated n/a.

pff_facet_blocking_summary

Facet report /offense/blocking (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/offense/blocking

Valid URL: https://premium.pff.com/api/v1/facet/offense/blocking

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
grades_pass_blocknumeric
grades_offensenumeric
pbenumeric
non_spike_pass_block_percentagenumeric
draft_seasonnumeric
snap_counts_rgnumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
snap_counts_cenumeric
hits_allowednumeric
block_percentnumeric
snap_counts_offensenumeric
player_game_countnumeric
eligible_seasonnumeric
snap_counts_blocknumeric
hurries_allowednumeric
grades_run_blocknumeric
snap_counts_run_blocknumeric
pressures_allowednumeric
snap_counts_pass_playnumeric
penaltiesnumericTotal number of penalties.
sacks_allowednumericOpponent sacks.
teamcharacterNFL team. Uses official abbreviations as per NFL.com
declined_penaltiesnumeric
snap_counts_tenumeric
snap_counts_rtnumeric
positioncharacterPrimary position as reported by NFL.com
non_spike_pass_blocknumeric
snap_counts_ltnumeric
playercharacterPlayer name
franchise_idnumericESPN franchise identifier.
snap_counts_pass_blocknumeric
pass_block_percentnumeric
snap_counts_lgnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters

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

Example

pff_facet_blocking_summary()

Last validated n/a.

pff_facet_defense_summary

Facet report /defense/summary (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/defense/summary

Valid URL: https://premium.pff.com/api/v1/facet/defense/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
targetsnumericThe number of pass plays where the player was the targeted receiver.
interception_touchdownsnumericTouchdowns scored on interception returns.
draft_seasonnumeric
forced_fumblesnumericForced fumbles.
missed_tacklesnumeric
catch_ratenumeric
team_namecharacterTeam abbreviation the player is credited to for the range.
tacklesnumericTotal tackles made by the defender.
jersey_numbercharacterJersey number (string; zero-padded, e.g. "09").
snap_counts_offballnumeric
snap_counts_boxnumeric
sacksnumericSacks credited.
snap_counts_pass_rushnumeric
player_game_countnumericGames with at least one qualifying snap in the requested range.
eligible_seasonnumeric
snap_counts_dlnumeric
grades_tacklenumeric
yardsnumericThe number of receiving yards
receptionsnumericThe number of pass receptions. Lateral receptions officially don't count as reception.
grades_coverage_defensenumericPFF coverage grade (0-100).
hurriesnumeric
interceptionsnumericInterceptions made in coverage.
snap_counts_coveragenumeric
snap_counts_dl_over_tnumeric
snap_counts_dl_a_gapnumeric
fumble_recoveriesnumeric
grades_run_defensenumericPFF run-defense grade (0-100).
snap_counts_cornernumeric
hitsnumericHits.
penaltiesnumericTotal number of penalties.
batted_passesnumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
stopsnumericTackles that constitute an offensive failure ("stops").
declined_penaltiesnumeric
total_pressuresnumericTotal quarterback pressures (sacks + hits + hurries).
positioncharacterPrimary position as reported by NFL.com
fumble_recovery_touchdownsnumeric
longestnumeric
snap_counts_slotnumeric
missed_tackle_ratenumeric
grades_defensenumericPFF overall defense grade (0-100).
yards_per_receptionnumeric
grades_defense_penaltynumeric
safetiesnumeric
playercharacterPlayer name
franchise_idnumericPFF franchise (team) id (integer join key).
snap_counts_defensenumeric
yards_after_catchnumericNumeric value for distance in yards perpendicular to the yard line where the receiver made the reception to where the play ended.
snap_counts_dl_b_gapnumeric
pass_break_upsnumeric
qb_rating_againstnumeric
snap_counts_run_defensenumeric
tackles_for_lossnumericTeam tackles for a loss.
assistsnumericAssisted tackles.
grades_pass_rush_defensenumeric
player_idnumericPFF player id (integer; matches the /players id and every player_id join key).
snap_counts_fsnumeric
touchdownsnumeric
snap_counts_dl_outside_tnumeric

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

Example

pff_facet_defense_summary()

Last validated n/a.

pff_facet_offense_summary

Facet report /offense/summary (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/offense/summary

Valid URL: https://premium.pff.com/api/v1/facet/offense/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
declined_penaltiesnumeric
draft_seasonnumeric
eligible_seasonnumeric
franchise_idnumericPFF franchise (team) id (integer join key).
grades_hands_fumblenumeric
grades_offensenumericPFF overall offense grade (0-100).
grades_offense_penaltynumeric
grades_passnumericPFF passing grade (0-100).
grades_runnumericPFF rushing grade (0-100).
grades_run_blocknumericPFF run-blocking grade (0-100).
jersey_numbercharacterJersey number (string; zero-padded, e.g. "09").
penaltiesnumericTotal number of penalties.
playercharacterPlayer name
player_game_countnumericGames with at least one qualifying snap in the requested range.
player_idnumericPFF player id (integer; matches the /players id and every player_id join key).
positioncharacterPrimary position as reported by NFL.com
snap_counts_passnumeric
snap_counts_pass_blocknumeric
snap_counts_pass_routenumeric
snap_counts_runnumeric
snap_counts_run_blocknumeric
snap_counts_totalnumeric
snap_counts_total_passnumeric
snap_counts_total_runnumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
team_namecharacterTeam abbreviation the player is credited to for the range.
grades_pass_blocknumericPFF pass-blocking grade (0-100).
grades_pass_routenumericPFF receiving/route grade (0-100).

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

Example

pff_facet_offense_summary()

Last validated n/a.

pff_facet_passing_allowed_pressure

Facet report /passing/allowed_pressure (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/passing/allowed_pressure

Valid URL: https://premium.pff.com/api/v1/facet/passing/allowed_pressure

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
te_percentnumeric
draft_seasonnumeric
pressures_ltnumeric
pressures_rgnumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
lt_percentnumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
hits_allowednumeric
pressures_lgnumeric
player_game_countnumeric
eligible_seasonnumeric
hurries_allowednumeric
self_percentnumeric
pressures_rtnumeric
pressures_allowednumeric
pressures_ol_tenumeric
pressures_cenumeric
penaltiesnumericTotal number of penalties.
sacks_allowednumericOpponent sacks.
ol_te_percentnumeric
allowed_pressure_dropbacksnumeric
pressures_othernumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
declined_penaltiesnumeric
ce_percentnumeric
positioncharacterPrimary position as reported by NFL.com
pressures_tenumeric
pressures_selfnumeric
lg_percentnumeric
playercharacterPlayer name
rt_percentnumeric
franchise_idnumericESPN franchise identifier.
other_percentnumeric
pressures_offnumeric
rg_percentnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters

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

Example

pff_facet_passing_allowed_pressure()

Last validated n/a.

pff_facet_pass_rush_summary

Facet report /defense/pass_rush (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/defense/pass_rush

Valid URL: https://premium.pff.com/api/v1/facet/defense/pass_rush

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
true_pass_set_total_pressuresnumeric
draft_seasonnumeric
true_pass_set_prpnumeric
true_pass_set_hurriesnumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
prpnumeric
true_pass_set_sacksnumeric
pass_rush_win_ratenumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
sacksnumericThe Number of times sacked.
snap_counts_pass_rushnumeric
player_game_countnumeric
eligible_seasonnumeric
true_pass_set_snap_counts_pass_playnumeric
pass_rush_winsnumeric
hurriesnumeric
pass_rush_oppnumeric
snap_counts_pass_playnumeric
hitsnumericHits.
true_pass_set_pass_rush_win_ratenumeric
penaltiesnumericTotal number of penalties.
batted_passesnumeric
true_pass_set_hitsnumeric
true_pass_set_snap_counts_pass_rushnumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
declined_penaltiesnumeric
true_pass_set_pass_rush_winsnumeric
total_pressuresnumeric
positioncharacterPrimary position as reported by NFL.com
true_pass_set_grades_pass_rush_defensenumeric
true_pass_set_batted_passesnumeric
playercharacterPlayer name
franchise_idnumericESPN franchise identifier.
pass_rush_percentnumeric
true_pass_set_pass_rush_oppnumeric
true_pass_set_pass_rush_percentnumeric
grades_pass_rush_defensenumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters

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

Example

pff_facet_pass_rush_summary()

Last validated n/a.

pff_facet_passing_concept

Facet report /passing/concept (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/passing/concept

Valid URL: https://premium.pff.com/api/v1/facet/passing/concept

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
comp_pct_diffnumeric
pa_grades_passnumeric
no_screen_grades_offensenumeric
pa_qb_ratingnumeric
no_screen_qb_ratingnumeric
pa_completionsnumeric
pa_thrown_awaysnumeric
pa_dropbacks_percentnumeric
ypa_diffnumeric
no_screen_dropsnumeric
screen_completion_percentnumeric
npa_batsnumeric
no_screen_thrown_awaysnumeric
pa_grades_runnumeric
screen_pressure_to_sack_ratenumeric
pa_drop_ratenumeric
screen_grades_offensenumeric
dropbacksnumeric
npa_thrown_awaysnumeric
no_screen_def_gen_pressuresnumeric
screen_grades_hands_fumblenumeric
pa_touchdownsnumeric
npa_ypanumeric
draft_seasonnumeric
screen_avg_time_to_thrownumeric
screen_thrown_awaysnumeric
npa_sacksnumeric
npa_aimed_passesnumeric
no_screen_completionsnumeric
no_screen_positive_epa_percentnumeric
screen_spikesnumeric
pa_first_downsnumeric
pa_big_time_throwsnumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
pa_spikesnumeric
pa_sack_percentnumeric
screen_dropbacks_percentnumeric
no_screen_epanumeric
npa_avg_time_to_thrownumeric
screen_batsnumeric
screen_grades_run_blocknumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
no_screen_batsnumeric
npa_grades_offensenumeric
no_screen_grades_pass_routenumeric
screen_def_gen_pressuresnumeric
pa_pressure_to_sack_ratenumeric
screen_sack_percentnumeric
no_screen_btt_ratenumeric
npa_btt_ratenumeric
screen_interceptionsnumeric
no_screen_passing_snapsnumeric
no_screen_grades_hands_fumblenumeric
screen_scramblesnumeric
screen_grades_passnumeric
npa_qb_ratingnumeric
no_screen_grades_passnumeric
pa_avg_time_to_thrownumeric
screen_twp_ratenumeric
player_game_countnumeric
npa_accuracy_percentnumeric
eligible_seasonnumeric
npa_dropsnumeric
screen_yardsnumeric
no_screen_drop_ratenumeric
no_screen_grades_offense_penaltynumeric
npa_passing_snapsnumeric
screen_drop_ratenumeric
screen_epanumeric
screen_grades_pass_routenumeric
screen_grades_offense_penaltynumeric
npa_spikesnumeric
screen_hit_as_threwnumeric
no_screen_aimed_passesnumeric
screen_dropsnumeric
screen_ypanumeric
npa_twp_ratenumeric
screen_accuracy_percentnumeric
npa_hit_as_threwnumeric
pa_accuracy_percentnumeric
pa_def_gen_pressuresnumeric
screen_avg_depth_of_targetnumeric
pa_sacksnumeric
screen_passing_snapsnumeric
no_screen_grades_runnumeric
no_screen_first_downsnumeric
pa_ypanumeric
npa_scramblesnumeric
npa_pressure_to_sack_ratenumeric
pa_twp_ratenumeric
no_screen_twp_ratenumeric
npa_grades_hands_fumblenumeric
screen_completionsnumeric
screen_btt_ratenumeric
npa_grades_runnumeric
no_screen_interceptionsnumeric
npa_grades_run_blocknumeric
no_screen_sacksnumeric
penaltiesnumericTotal number of penalties.
no_screen_big_time_throwsnumeric
npa_drop_ratenumeric
npa_attemptsnumeric
screen_qb_ratingnumeric
npa_grades_offense_penaltynumeric
pa_batsnumeric
pa_attemptsnumeric
npa_def_gen_pressuresnumeric
no_screen_avg_time_to_thrownumeric
pa_yardsnumeric
npa_positive_epa_percentnumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
no_screen_scramblesnumeric
pa_turnover_worthy_playsnumeric
pa_aimed_passesnumeric
declined_penaltiesnumeric
pa_grades_offensenumeric
screen_positive_epa_percentnumeric
no_screen_dropbacksnumeric
no_screen_dropbacks_percentnumeric
npa_grades_pass_routenumeric
npa_sack_percentnumeric
pa_positive_epa_percentnumeric
pa_grades_run_blocknumeric
no_screen_turnover_worthy_playsnumeric
positioncharacterPrimary position as reported by NFL.com
pa_grades_pass_routenumeric
npa_epanumeric
no_screen_avg_depth_of_targetnumeric
pa_grades_hands_fumblenumeric
no_screen_completion_percentnumeric
pa_hit_as_threwnumeric
pa_grades_offense_penaltynumeric
npa_dropbacks_percentnumeric
npa_grades_passnumeric
screen_grades_runnumeric
screen_first_downsnumeric
npa_completion_percentnumeric
no_screen_grades_run_blocknumeric
no_screen_hit_as_threwnumeric
screen_turnover_worthy_playsnumeric
npa_avg_depth_of_targetnumeric
npa_dropbacksnumeric
playercharacterPlayer name
pa_dropsnumeric
pa_btt_ratenumeric
franchise_idnumericESPN franchise identifier.
screen_big_time_throwsnumeric
screen_aimed_passesnumeric
npa_touchdownsnumeric
screen_attemptsnumeric
screen_dropbacksnumeric
no_screen_yardsnumeric
pa_scramblesnumeric
pa_completion_percentnumeric
pa_avg_depth_of_targetnumeric
pa_interceptionsnumeric
no_screen_accuracy_percentnumeric
no_screen_spikesnumeric
pa_dropbacksnumeric
npa_big_time_throwsnumeric
no_screen_sack_percentnumeric
pa_epanumeric
no_screen_attemptsnumeric
pa_passing_snapsnumeric
npa_completionsnumeric
screen_touchdownsnumeric
npa_first_downsnumeric
no_screen_touchdownsnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
npa_yardsnumeric
no_screen_ypanumeric
npa_turnover_worthy_playsnumeric
npa_interceptionsnumeric
no_screen_pressure_to_sack_ratenumeric
screen_sacksnumeric
screen_grades_hands_dropnumeric
screen_grades_pass_blocknumeric
no_screen_grades_pass_blocknumeric
pa_grades_hands_dropnumeric
npa_grades_pass_blocknumeric
pa_grades_pass_blocknumeric
npa_grades_hands_dropnumeric
no_screen_grades_hands_dropnumeric
pa_grades_screen_blocknumeric
screen_grades_screen_blocknumeric
no_screen_grades_screen_blocknumeric
npa_grades_screen_blocknumeric
pa_grades_defense_penaltynumeric
npa_grades_defense_penaltynumeric
npa_grades_coverage_defensenumeric
pa_grades_defensenumeric
screen_grades_coverage_defensenumeric
npa_grades_defensenumeric
screen_grades_defensenumeric
screen_grades_defense_penaltynumeric
no_screen_grades_defensenumeric
pa_grades_coverage_defensenumeric
no_screen_grades_defense_penaltynumeric
no_screen_grades_coverage_defensenumeric
no_screen_grades_overall_tacklenumeric
pa_grades_overall_tacklenumeric
pa_grades_tacklenumeric
pa_grades_pass_rush_defensecharacter
screen_grades_run_defensecharacter
pa_grades_run_defensecharacter
npa_grades_overall_tacklenumeric
no_screen_grades_pass_rush_defensenumeric
npa_grades_tacklenumeric
screen_grades_tacklecharacter
no_screen_grades_tacklenumeric
npa_grades_pass_rush_defensenumeric
no_screen_grades_run_defensenumeric
screen_grades_overall_tacklecharacter
npa_grades_run_defensenumeric
screen_grades_pass_rush_defensenumeric

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

Example

pff_facet_passing_concept()

Last validated n/a.

pff_facet_coverage_scheme

Facet report /defense/coverage_scheme (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/defense/coverage_scheme

Valid URL: https://premium.pff.com/api/v1/facet/defense/coverage_scheme

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
man_touchdownsnumeric
man_interceptionsnumeric
zone_snap_counts_coverage_percentnumeric
man_avg_depth_of_targetnumeric
man_dropped_intsnumeric
draft_seasonnumeric
zone_coverage_snaps_per_targetnumeric
man_yards_per_receptionnumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
man_snap_counts_coveragenumeric
man_tacklesnumeric
zone_stopsnumeric
zone_snap_counts_coveragenumeric
zone_yardsnumeric
man_coverage_snaps_per_targetnumeric
zone_coverage_percentnumeric
player_game_countnumeric
eligible_seasonnumeric
zone_receptionsnumeric
zone_forced_incompletion_ratenumeric
man_snap_counts_pass_playnumeric
zone_yards_per_receptionnumeric
man_longestnumeric
man_assistsnumeric
zone_yards_after_catchnumeric
man_stopsnumeric
man_receptionsnumeric
zone_tacklesnumeric
man_coverage_percentnumeric
penaltiesnumericTotal number of penalties.
zone_yards_per_coverage_snapnumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
man_catch_ratenumeric
man_grades_coverage_defensenumeric
declined_penaltiesnumeric
man_yards_after_catchnumeric
man_pass_break_upsnumeric
man_yardsnumeric
positioncharacterPrimary position as reported by NFL.com
man_targetsnumeric
man_missed_tackle_ratenumeric
zone_assistsnumeric
zone_snap_counts_pass_playnumeric
zone_missed_tackle_ratenumeric
zone_touchdownsnumeric
zone_coverage_snaps_per_receptionnumeric
man_coverage_snaps_per_receptionnumeric
zone_avg_depth_of_targetnumeric
man_snap_counts_coverage_percentnumeric
playercharacterPlayer name
franchise_idnumericESPN franchise identifier.
zone_forced_incompletesnumeric
man_forced_incompletion_ratenumeric
zone_targetsnumeric
zone_longestnumeric
zone_dropped_intsnumeric
zone_interceptionsnumeric
man_forced_incompletesnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
zone_missed_tacklesnumeric
base_snap_counts_coveragenumeric
man_missed_tacklesnumeric
zone_grades_coverage_defensenumeric
man_qb_rating_againstnumeric
zone_pass_break_upsnumeric
zone_qb_rating_againstnumeric
man_yards_per_coverage_snapnumeric
zone_catch_ratenumeric

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

Example

pff_facet_coverage_scheme()

Last validated n/a.

pff_facet_passing_detail_stats

Facet report /passing/detail (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/passing/detail

Valid URL: https://premium.pff.com/api/v1/facet/passing/detail

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
left_behind_los_accuracy_percentnumeric
left_short_scramblesnumeric
center_short_first_downsnumeric
no_blitz_completion_percentnumeric
right_short_batsnumeric
right_behind_los_positive_epa_percentnumeric
left_behind_los_completionsnumeric
comp_pct_diffnumeric
pa_grades_passnumeric
left_medium_dropbacksnumeric
right_medium_grades_passnumeric
right_medium_hit_as_threwnumeric
behind_los_attempts_percentnumeric
grades_offensenumeric
no_screen_grades_offensenumeric
pa_qb_ratingnumeric
right_short_turnover_worthy_playsnumeric
no_screen_qb_ratingnumeric
pa_completionsnumeric
right_medium_qb_ratingnumeric
deep_twp_ratenumeric
center_medium_sacksnumeric
medium_interceptionsnumeric
left_deep_completionsnumeric
no_pressure_scramblesnumeric
twp_ratenumeric
behind_los_spikesnumeric
medium_aimed_passesnumeric
pa_thrown_awaysnumeric
pa_dropbacks_percentnumeric
ypa_diffnumeric
blitz_touchdownsnumeric
center_behind_los_dropsnumeric
pressure_yardsnumeric
no_pressure_spikesnumeric
blitz_ypanumeric
center_behind_los_interceptionsnumeric
no_screen_dropsnumeric
behind_los_dropbacksnumeric
no_blitz_grades_runnumeric
screen_completion_percentnumeric
npa_batsnumeric
left_behind_los_interceptionsnumeric
left_deep_first_downsnumeric
deep_passing_snapsnumeric
btt_ratenumeric
center_short_btt_ratenumeric
center_medium_thrown_awaysnumeric
center_deep_avg_depth_of_targetnumeric
blitz_qb_ratingnumeric
center_short_dropsnumeric
no_pressure_thrown_awaysnumeric
no_screen_thrown_awaysnumeric
no_blitz_batsnumeric
center_deep_first_downsnumeric
left_medium_completion_percentnumeric
center_deep_attemptsnumeric
pa_grades_runnumeric
center_behind_los_attemptsnumeric
right_short_positive_epa_percentnumeric
no_blitz_dropsnumeric
center_deep_aimed_passesnumeric
right_deep_grades_passnumeric
right_medium_big_time_throwsnumeric
deep_sack_percentnumeric
no_pressure_completion_percentnumeric
blitz_aimed_passesnumeric
screen_pressure_to_sack_ratenumeric
pa_drop_ratenumeric
center_medium_pressure_to_sack_ratenumeric
deep_sacksnumeric
right_medium_ypanumeric
spikesnumericSpikes
left_deep_drop_ratenumeric
screen_grades_offensenumeric
right_medium_attempts_percentnumeric
right_deep_btt_ratenumeric
center_short_attempts_percentnumeric
deep_dropsnumeric
center_behind_los_big_time_throwsnumeric
center_behind_los_touchdownsnumeric
dropbacksnumeric
right_behind_los_twp_ratenumeric
center_deep_completionsnumeric
npa_thrown_awaysnumeric
center_short_attemptsnumeric
pressure_grades_runnumeric
left_behind_los_sack_percentnumeric
center_short_pressure_to_sack_ratenumeric
deep_touchdownsnumeric
no_blitz_sack_percentnumeric
no_pressure_batsnumeric
center_behind_los_accuracy_percentnumeric
pressure_completionsnumeric
blitz_big_time_throwsnumeric
center_deep_drop_ratenumeric
right_short_first_downsnumeric
no_screen_def_gen_pressuresnumeric
right_behind_los_first_downsnumeric
screen_grades_hands_fumblenumeric
pa_touchdownsnumeric
short_interceptionsnumeric
center_medium_scramblesnumeric
left_behind_los_sacksnumeric
npa_ypanumeric
no_blitz_drop_ratenumeric
blitz_spikesnumeric
left_short_ypanumeric
no_pressure_completionsnumeric
left_short_qb_ratingnumeric
thrown_awaysnumeric
right_behind_los_qb_ratingnumeric
draft_seasonnumeric
screen_avg_time_to_thrownumeric
right_behind_los_dropbacksnumeric
screen_thrown_awaysnumeric
behind_los_def_gen_pressuresnumeric
npa_sacksnumeric
no_pressure_passing_snapsnumeric
npa_aimed_passesnumeric
no_blitz_first_downsnumeric
right_short_thrown_awaysnumeric
deep_def_gen_pressuresnumeric
right_short_btt_ratenumeric
center_behind_los_positive_epa_percentnumeric
blitz_avg_time_to_thrownumeric
left_behind_los_grades_passnumeric
deep_grades_passnumeric
no_pressure_grades_hands_fumblenumeric
center_short_turnover_worthy_playsnumeric
center_behind_los_scramblesnumeric
pressure_aimed_passesnumeric
no_screen_completionsnumeric
right_short_aimed_passesnumeric
no_screen_positive_epa_percentnumeric
center_short_dropbacksnumeric
medium_epanumeric
right_short_ypanumeric
blitz_sacksnumeric
center_medium_ypanumeric
screen_spikesnumeric
pa_first_downsnumeric
medium_attemptsnumeric
no_pressure_interceptionsnumeric
right_deep_accuracy_percentnumeric
behind_los_scramblesnumeric
center_behind_los_completion_percentnumeric
left_behind_los_btt_ratenumeric
right_behind_los_btt_ratenumeric
pa_big_time_throwsnumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
short_touchdownsnumeric
pa_spikesnumeric
center_medium_dropsnumeric
left_behind_los_aimed_passesnumeric
pa_sack_percentnumeric
deep_attemptsnumeric
right_behind_los_sack_percentnumeric
pressure_epanumeric
center_short_positive_epa_percentnumeric
deep_avg_depth_of_targetnumeric
left_deep_btt_ratenumeric
medium_scramblesnumeric
blitz_completionsnumeric
center_behind_los_avg_depth_of_targetnumeric
blitz_attemptsnumeric
short_attempts_percentnumeric
right_behind_los_sacksnumeric
screen_dropbacks_percentnumeric
center_medium_avg_time_to_thrownumeric
pressure_twp_ratenumeric
pressure_sacksnumeric
left_short_pressure_to_sack_ratenumeric
no_blitz_pressure_to_sack_ratenumeric
no_pressure_ypanumeric
no_screen_epanumeric
center_deep_sack_percentnumeric
center_deep_ypanumeric
left_behind_los_hit_as_threwnumeric
pressure_passing_snapsnumeric
medium_big_time_throwsnumeric
grades_passnumeric
npa_avg_time_to_thrownumeric
deep_thrown_awaysnumeric
right_short_accuracy_percentnumeric
left_deep_turnover_worthy_playsnumeric
center_medium_batsnumeric
right_short_grades_passnumeric
hit_as_threwnumeric
right_deep_spikesnumeric
left_deep_passing_snapsnumeric
center_medium_twp_ratenumeric
right_behind_los_passing_snapsnumeric
left_deep_qb_ratingnumeric
screen_batsnumeric
right_deep_drop_ratenumeric
first_downsnumericFirst downs earned by the team.
screen_grades_run_blocknumeric
left_behind_los_drop_ratenumeric
pressure_batsnumeric
left_medium_drop_ratenumeric
right_deep_attemptsnumeric
left_deep_spikesnumeric
center_behind_los_dropbacksnumeric
blitz_thrown_awaysnumeric
right_deep_big_time_throwsnumeric
medium_hit_as_threwnumeric
right_short_dropbacksnumeric
no_pressure_dropsnumeric
medium_def_gen_pressuresnumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
left_short_positive_epa_percentnumeric
left_short_attemptsnumeric
pressure_grades_offense_penaltynumeric
center_deep_twp_ratenumeric
right_medium_avg_time_to_thrownumeric
left_behind_los_qb_ratingnumeric
no_screen_batsnumeric
left_behind_los_dropbacksnumeric
pressure_scramblesnumeric
blitz_drop_ratenumeric
deep_dropbacksnumeric
right_behind_los_scramblesnumeric
sack_percentnumeric
behind_los_interceptionsnumeric
right_deep_dropsnumeric
right_deep_yardsnumeric
right_short_hit_as_threwnumeric
npa_grades_offensenumeric
right_short_avg_depth_of_targetnumeric
short_batsnumeric
right_deep_twp_ratenumeric
right_behind_los_pressure_to_sack_ratenumeric
screen_def_gen_pressuresnumeric
deep_spikesnumeric
pa_pressure_to_sack_ratenumeric
center_medium_spikesnumeric
screen_sack_percentnumeric
blitz_completion_percentnumeric
behind_los_aimed_passesnumeric
right_behind_los_touchdownsnumeric
batsnumeric
right_medium_pressure_to_sack_ratenumeric
no_screen_btt_ratenumeric
medium_thrown_awaysnumeric
short_sacksnumeric
center_behind_los_twp_ratenumeric
left_behind_los_attemptsnumeric
short_aimed_passesnumeric
short_completionsnumeric
right_short_pressure_to_sack_ratenumeric
npa_btt_ratenumeric
medium_avg_depth_of_targetnumeric
left_behind_los_positive_epa_percentnumeric
screen_interceptionsnumeric
center_medium_attempts_percentnumeric
left_medium_touchdownsnumeric
center_short_batsnumeric
left_deep_avg_time_to_thrownumeric
no_screen_passing_snapsnumeric
no_pressure_first_downsnumeric
center_behind_los_passing_snapsnumeric
center_short_yardsnumeric
blitz_grades_offense_penaltynumeric
right_medium_btt_ratenumeric
right_medium_scramblesnumeric
no_screen_grades_hands_fumblenumeric
medium_btt_ratenumeric
no_blitz_epanumeric
center_behind_los_btt_ratenumeric
blitz_interceptionsnumeric
no_blitz_dropbacksnumeric
center_short_avg_depth_of_targetnumeric
left_medium_sacksnumeric
right_short_yardsnumeric
left_medium_first_downsnumeric
no_blitz_grades_passnumeric
right_medium_positive_epa_percentnumeric
screen_scramblesnumeric
left_short_big_time_throwsnumeric
deep_turnover_worthy_playsnumeric
no_blitz_scramblesnumeric
pressure_drop_ratenumeric
left_deep_batsnumeric
no_blitz_yardsnumeric
left_medium_turnover_worthy_playsnumeric
screen_grades_passnumeric
center_deep_dropsnumeric
center_medium_avg_depth_of_targetnumeric
sacksnumericThe Number of times sacked.
pressure_pressure_to_sack_ratenumeric
center_behind_los_ypanumeric
right_short_attemptsnumeric
center_medium_completion_percentnumeric
no_blitz_grades_hands_fumblenumeric
right_short_sack_percentnumeric
left_behind_los_avg_depth_of_targetnumeric
center_medium_epanumeric
center_behind_los_sack_percentnumeric
npa_qb_ratingnumeric
no_pressure_grades_offensenumeric
medium_completionsnumeric
no_screen_grades_passnumeric
medium_sack_percentnumeric
left_short_grades_passnumeric
deep_btt_ratenumeric
pa_avg_time_to_thrownumeric
left_short_accuracy_percentnumeric
no_pressure_avg_time_to_thrownumeric
screen_twp_ratenumeric
pressure_dropbacksnumeric
short_twp_ratenumeric
short_passing_snapsnumeric
left_deep_sacksnumeric
short_scramblesnumeric
center_medium_turnover_worthy_playsnumeric
no_blitz_grades_offense_penaltynumeric
behind_los_drop_ratenumeric
right_behind_los_epanumeric
right_medium_aimed_passesnumeric
no_pressure_grades_runnumeric
short_accuracy_percentnumeric
player_game_countnumeric
short_btt_ratenumeric
right_short_touchdownsnumeric
center_short_completionsnumeric
right_short_spikesnumeric
behind_los_first_downsnumeric
right_medium_def_gen_pressuresnumeric
blitz_turnover_worthy_playsnumeric
deep_pressure_to_sack_ratenumeric
npa_accuracy_percentnumeric
no_blitz_touchdownsnumeric
no_blitz_avg_depth_of_targetnumeric
medium_qb_ratingnumeric
short_completion_percentnumeric
right_deep_attempts_percentnumeric
no_pressure_dropbacks_percentnumeric
blitz_grades_passnumeric
eligible_seasonnumeric
short_big_time_throwsnumeric
behind_los_attemptsnumeric
blitz_avg_depth_of_targetnumeric
no_blitz_spikesnumeric
center_behind_los_yardsnumeric
npa_dropsnumeric
center_behind_los_batsnumeric
center_behind_los_qb_ratingnumeric
right_deep_pressure_to_sack_ratenumeric
center_short_accuracy_percentnumeric
left_behind_los_batsnumeric
no_pressure_dropbacksnumeric
center_deep_passing_snapsnumeric
right_behind_los_hit_as_threwnumeric
medium_batsnumeric
right_medium_first_downsnumeric
completionsnumericThe number of completed passes.
medium_spikesnumeric
left_deep_thrown_awaysnumeric
screen_yardsnumeric
right_deep_epanumeric
center_medium_hit_as_threwnumeric
left_behind_los_completion_percentnumeric
blitz_btt_ratenumeric
no_screen_drop_ratenumeric
center_short_ypanumeric
right_short_drop_ratenumeric
right_behind_los_accuracy_percentnumeric
blitz_positive_epa_percentnumeric
no_pressure_btt_ratenumeric
left_short_yardsnumeric
deep_accuracy_percentnumeric
right_behind_los_avg_depth_of_targetnumeric
center_behind_los_thrown_awaysnumeric
center_behind_los_attempts_percentnumeric
no_screen_grades_offense_penaltynumeric
right_deep_first_downsnumeric
left_short_completionsnumeric
deep_completion_percentnumeric
left_deep_positive_epa_percentnumeric
npa_passing_snapsnumeric
screen_drop_ratenumeric
screen_epanumeric
no_pressure_drop_ratenumeric
no_blitz_turnover_worthy_playsnumeric
yardsnumericThe number of receiving yards
right_deep_sack_percentnumeric
behind_los_pressure_to_sack_ratenumeric
screen_grades_offense_penaltynumeric
right_deep_touchdownsnumeric
npa_spikesnumeric
pressure_positive_epa_percentnumeric
screen_hit_as_threwnumeric
left_behind_los_def_gen_pressuresnumeric
left_behind_los_dropsnumeric
deep_epanumeric
left_deep_ypanumeric
medium_touchdownsnumeric
no_screen_aimed_passesnumeric
screen_dropsnumeric
left_medium_grades_passnumeric
accuracy_percentnumeric
right_behind_los_spikesnumeric
screen_ypanumeric
medium_grades_passnumeric
blitz_first_downsnumeric
npa_twp_ratenumeric
behind_los_passing_snapsnumeric
left_short_first_downsnumeric
center_short_passing_snapsnumeric
center_deep_accuracy_percentnumeric
right_deep_positive_epa_percentnumeric
right_medium_sack_percentnumeric
right_deep_qb_ratingnumeric
no_blitz_dropbacks_percentnumeric
right_short_completion_percentnumeric
screen_accuracy_percentnumeric
right_behind_los_interceptionsnumeric
behind_los_yardsnumeric
center_behind_los_grades_passnumeric
left_deep_dropbacksnumeric
npa_hit_as_threwnumeric
center_behind_los_spikesnumeric
scramblesnumeric
right_behind_los_aimed_passesnumeric
left_short_interceptionsnumeric
right_medium_interceptionsnumeric
left_behind_los_yardsnumeric
pa_accuracy_percentnumeric
center_deep_btt_ratenumeric
pressure_turnover_worthy_playsnumeric
medium_first_downsnumeric
no_pressure_epanumeric
left_short_avg_depth_of_targetnumeric
left_behind_los_ypanumeric
short_attemptsnumeric
right_medium_batsnumeric
no_blitz_avg_time_to_thrownumeric
left_behind_los_touchdownsnumeric
pa_def_gen_pressuresnumeric
right_medium_dropbacksnumeric
interceptionsnumericThe number of interceptions thrown.
screen_avg_depth_of_targetnumeric
pa_sacksnumeric
short_turnover_worthy_playsnumeric
screen_passing_snapsnumeric
right_deep_thrown_awaysnumeric
drop_ratenumeric
right_behind_los_drop_ratenumeric
no_screen_grades_runnumeric
right_short_qb_ratingnumeric
medium_sacksnumeric
center_deep_attempts_percentnumeric
left_short_dropbacksnumeric
behind_los_dropsnumeric
short_sack_percentnumeric
no_screen_first_downsnumeric
no_blitz_positive_epa_percentnumeric
left_medium_spikesnumeric
left_medium_accuracy_percentnumeric
pressure_btt_ratenumeric
pa_ypanumeric
behind_los_completionsnumeric
npa_scramblesnumeric
no_pressure_aimed_passesnumeric
pressure_dropbacks_percentnumeric
grades_runnumeric
behind_los_sack_percentnumeric
left_deep_yardsnumeric
left_short_aimed_passesnumeric
npa_pressure_to_sack_ratenumeric
center_behind_los_completionsnumeric
pa_twp_ratenumeric
no_pressure_def_gen_pressuresnumeric
left_short_thrown_awaysnumeric
pressure_grades_offensenumeric
left_short_sack_percentnumeric
center_short_thrown_awaysnumeric
center_short_interceptionsnumeric
short_avg_depth_of_targetnumeric
pressure_completion_percentnumeric
left_deep_touchdownsnumeric
deep_yardsnumeric
center_behind_los_turnover_worthy_playsnumeric
medium_ypanumeric
left_medium_epanumeric
left_deep_avg_depth_of_targetnumeric
deep_first_downsnumeric
pressure_avg_depth_of_targetnumeric
short_drop_ratenumeric
left_medium_batsnumeric
blitz_epanumeric
center_deep_spikesnumeric
center_short_hit_as_threwnumeric
left_medium_positive_epa_percentnumeric
center_deep_touchdownsnumeric
right_deep_ypanumeric
right_short_big_time_throwsnumeric
center_short_big_time_throwsnumeric
short_positive_epa_percentnumeric
no_screen_twp_ratenumeric
left_behind_los_avg_time_to_thrownumeric
right_deep_passing_snapsnumeric
pressure_dropsnumeric
right_short_twp_ratenumeric
center_medium_attemptsnumeric
right_deep_avg_time_to_thrownumeric
no_blitz_def_gen_pressuresnumeric
center_deep_def_gen_pressuresnumeric
pressure_attemptsnumeric
npa_grades_hands_fumblenumeric
behind_los_epanumeric
right_medium_twp_ratenumeric
right_deep_aimed_passesnumeric
right_deep_scramblesnumeric
deep_big_time_throwsnumeric
left_short_turnover_worthy_playsnumeric
qb_ratingnumeric
center_short_touchdownsnumeric
right_medium_dropsnumeric
left_deep_epanumeric
pressure_big_time_throwsnumeric
no_blitz_thrown_awaysnumeric
short_ypanumeric
medium_pressure_to_sack_ratenumeric
left_medium_thrown_awaysnumeric
right_behind_los_avg_time_to_thrownumeric
completion_percentnumeric
blitz_dropsnumeric
behind_los_btt_ratenumeric
screen_completionsnumeric
screen_btt_ratenumeric
npa_grades_runnumeric
no_pressure_touchdownsnumeric
no_screen_interceptionsnumeric
medium_avg_time_to_thrownumeric
center_deep_completion_percentnumeric
behind_los_avg_time_to_thrownumeric
right_medium_touchdownsnumeric
no_pressure_sacksnumeric
center_short_avg_time_to_thrownumeric
npa_grades_run_blocknumeric
left_deep_aimed_passesnumeric
left_medium_yardsnumeric
center_medium_touchdownsnumeric
blitz_sack_percentnumeric
no_screen_sacksnumeric
center_short_drop_ratenumeric
left_short_twp_ratenumeric
pressure_sack_percentnumeric
no_pressure_attemptsnumeric
right_behind_los_attempts_percentnumeric
no_blitz_grades_offensenumeric
attemptsnumericThe number of pass attempts as defined by the NFL.
blitz_scramblesnumeric
right_deep_avg_depth_of_targetnumeric
behind_los_sacksnumeric
center_deep_yardsnumeric
short_dropbacksnumeric
no_screen_big_time_throwsnumeric
left_deep_sack_percentnumeric
center_behind_los_avg_time_to_thrownumeric
blitz_dropbacks_percentnumeric
behind_los_avg_depth_of_targetnumeric
left_behind_los_epanumeric
medium_twp_ratenumeric
left_short_def_gen_pressuresnumeric
npa_drop_ratenumeric
medium_turnover_worthy_playsnumeric
behind_los_twp_ratenumeric
left_behind_los_thrown_awaysnumeric
left_short_batsnumeric
center_medium_drop_ratenumeric
npa_attemptsnumeric
right_deep_batsnumeric
screen_qb_ratingnumeric
medium_yardsnumeric
center_deep_grades_passnumeric
center_medium_passing_snapsnumeric
center_behind_los_first_downsnumeric
npa_grades_offense_penaltynumeric
no_pressure_qb_ratingnumeric
center_medium_interceptionsnumeric
pa_batsnumeric
pa_attemptsnumeric
behind_los_grades_passnumeric
no_blitz_passing_snapsnumeric
npa_def_gen_pressuresnumeric
left_short_hit_as_threwnumeric
deep_qb_ratingnumeric
no_blitz_aimed_passesnumeric
blitz_yardsnumeric
no_screen_avg_time_to_thrownumeric
center_deep_batsnumeric
behind_los_ypanumeric
pa_yardsnumeric
right_short_interceptionsnumeric
left_deep_interceptionsnumeric
right_medium_sacksnumeric
npa_positive_epa_percentnumeric
right_behind_los_turnover_worthy_playsnumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
no_screen_scramblesnumeric
pa_turnover_worthy_playsnumeric
right_medium_spikesnumeric
behind_los_hit_as_threwnumeric
no_blitz_attemptsnumeric
pressure_accuracy_percentnumeric
left_medium_pressure_to_sack_ratenumeric
medium_dropbacksnumeric
deep_hit_as_threwnumeric
no_blitz_hit_as_threwnumeric
right_medium_completion_percentnumeric
pressure_hit_as_threwnumeric
short_epanumeric
deep_drop_ratenumeric
blitz_pressure_to_sack_ratenumeric
pa_aimed_passesnumeric
deep_scramblesnumeric
pa_grades_offensenumeric
screen_positive_epa_percentnumeric
left_deep_completion_percentnumeric
no_screen_dropbacksnumeric
right_short_epanumeric
no_screen_dropbacks_percentnumeric
no_blitz_btt_ratenumeric
medium_attempts_percentnumeric
right_behind_los_completion_percentnumeric
left_medium_hit_as_threwnumeric
left_behind_los_pressure_to_sack_ratenumeric
right_short_def_gen_pressuresnumeric
no_blitz_ypanumeric
right_short_attempts_percentnumeric
center_short_aimed_passesnumeric
npa_sack_percentnumeric
short_hit_as_threwnumeric
blitz_grades_runnumeric
right_medium_turnover_worthy_playsnumeric
left_short_epanumeric
center_behind_los_pressure_to_sack_ratenumeric
pa_positive_epa_percentnumeric
pressure_interceptionsnumeric
right_behind_los_ypanumeric
deep_interceptionsnumeric
left_medium_twp_ratenumeric
blitz_grades_hands_fumblenumeric
passing_snapsnumeric
pa_grades_run_blocknumeric
pressure_to_sack_ratenumeric
ypanumeric
right_behind_los_big_time_throwsnumeric
center_medium_sack_percentnumeric
dropsnumericThrows dropped
center_deep_thrown_awaysnumeric
short_thrown_awaysnumeric
left_short_btt_ratenumeric
no_screen_turnover_worthy_playsnumeric
no_pressure_grades_offense_penaltynumeric
right_medium_accuracy_percentnumeric
positioncharacterPrimary position as reported by NFL.com
short_def_gen_pressuresnumeric
center_deep_dropbacksnumeric
center_medium_accuracy_percentnumeric
blitz_grades_offensenumeric
right_behind_los_yardsnumeric
right_medium_attemptsnumeric
grades_hands_fumblenumeric
left_medium_attemptsnumeric
npa_epanumeric
no_screen_avg_depth_of_targetnumeric
medium_accuracy_percentnumeric
left_medium_dropsnumeric
pa_grades_hands_fumblenumeric
no_screen_completion_percentnumeric
left_short_avg_time_to_thrownumeric
pa_hit_as_threwnumeric
medium_passing_snapsnumeric
center_short_epanumeric
left_behind_los_passing_snapsnumeric
left_deep_pressure_to_sack_ratenumeric
avg_time_to_thrownumericAverage time elapsed from the time of snap to throw on every pass attempt for a passer (sacks excluded).
pa_grades_offense_penaltynumeric
deep_batsnumeric
npa_dropbacks_percentnumeric
left_medium_passing_snapsnumeric
pressure_def_gen_pressuresnumeric
left_medium_scramblesnumeric
npa_grades_passnumeric
pressure_grades_passnumeric
right_deep_completion_percentnumeric
big_time_throwsnumeric
screen_grades_runnumeric
left_short_dropsnumeric
screen_first_downsnumeric
npa_completion_percentnumeric
left_deep_accuracy_percentnumeric
medium_positive_epa_percentnumeric
no_blitz_qb_ratingnumeric
blitz_hit_as_threwnumeric
behind_los_turnover_worthy_playsnumeric
right_medium_epanumeric
right_deep_dropbacksnumeric
deep_ypanumeric
center_medium_completionsnumeric
left_medium_avg_time_to_thrownumeric
left_short_sacksnumeric
left_behind_los_spikesnumeric
no_screen_grades_run_blocknumeric
pressure_ypanumeric
left_deep_def_gen_pressuresnumeric
no_screen_hit_as_threwnumeric
center_short_qb_ratingnumeric
center_deep_interceptionsnumeric
right_deep_completionsnumeric
center_behind_los_sacksnumeric
screen_turnover_worthy_playsnumeric
deep_completionsnumeric
left_medium_attempts_percentnumeric
pressure_avg_time_to_thrownumeric
short_yardsnumeric
behind_los_qb_ratingnumeric
right_short_sacksnumeric
right_behind_los_thrown_awaysnumeric
center_short_spikesnumeric
center_behind_los_hit_as_threwnumeric
no_blitz_completionsnumeric
center_deep_turnover_worthy_playsnumeric
left_medium_sack_percentnumeric
behind_los_completion_percentnumeric
left_deep_attempts_percentnumeric
no_pressure_sack_percentnumeric
center_deep_big_time_throwsnumeric
npa_avg_depth_of_targetnumeric
npa_dropbacksnumeric
playercharacterPlayer name
left_medium_avg_depth_of_targetnumeric
no_blitz_accuracy_percentnumeric
behind_los_thrown_awaysnumeric
center_medium_def_gen_pressuresnumeric
short_avg_time_to_thrownumeric
left_deep_twp_ratenumeric
center_behind_los_epanumeric
left_behind_los_big_time_throwsnumeric
pa_dropsnumeric
no_pressure_pressure_to_sack_ratecharacter
right_medium_yardsnumeric
pa_btt_ratenumeric
no_pressure_turnover_worthy_playsnumeric
pressure_first_downsnumeric
positive_epa_percentnumeric
right_medium_drop_ratenumeric
blitz_passing_snapsnumeric
center_medium_big_time_throwsnumeric
franchise_idnumericESPN franchise identifier.
left_short_completion_percentnumeric
screen_big_time_throwsnumeric
left_short_drop_ratenumeric
left_behind_los_scramblesnumeric
left_medium_btt_ratenumeric
screen_aimed_passesnumeric
right_deep_hit_as_threwnumeric
behind_los_batsnumeric
no_pressure_twp_ratenumeric
npa_touchdownsnumeric
no_blitz_sacksnumeric
short_first_downsnumeric
left_deep_attemptsnumeric
right_behind_los_attemptsnumeric
screen_attemptsnumeric
screen_dropbacksnumeric
right_deep_sacksnumeric
left_behind_los_attempts_percentnumeric
behind_los_big_time_throwsnumeric
center_deep_pressure_to_sack_ratenumeric
left_medium_big_time_throwsnumeric
right_behind_los_batsnumeric
left_medium_def_gen_pressuresnumeric
no_screen_yardsnumeric
right_deep_turnover_worthy_playsnumeric
left_short_spikesnumeric
left_medium_aimed_passesnumeric
left_behind_los_twp_ratenumeric
short_grades_passnumeric
right_short_dropsnumeric
right_short_avg_time_to_thrownumeric
pa_scramblesnumeric
right_medium_thrown_awaysnumeric
no_pressure_accuracy_percentnumeric
center_short_sack_percentnumeric
right_short_passing_snapsnumeric
center_short_def_gen_pressuresnumeric
center_medium_positive_epa_percentnumeric
medium_dropsnumeric
center_medium_aimed_passesnumeric
center_short_sacksnumeric
pa_completion_percentnumeric
deep_attempts_percentnumeric
center_behind_los_def_gen_pressuresnumeric
left_short_passing_snapsnumeric
center_medium_grades_passnumeric
center_deep_avg_time_to_thrownumeric
pa_avg_depth_of_targetnumeric
pa_interceptionsnumeric
no_screen_accuracy_percentnumeric
behind_los_positive_epa_percentnumeric
no_screen_spikesnumeric
center_short_completion_percentnumeric
pa_dropbacksnumeric
left_deep_hit_as_threwnumeric
center_short_grades_passnumeric
left_short_attempts_percentnumeric
left_deep_scramblesnumeric
no_blitz_twp_ratenumeric
no_pressure_hit_as_threwnumeric
right_short_completionsnumeric
center_behind_los_aimed_passesnumeric
right_short_scramblesnumeric
center_medium_qb_ratingnumeric
no_pressure_grades_passnumeric
npa_big_time_throwsnumeric
deep_avg_time_to_thrownumeric
no_screen_sack_percentnumeric
avg_depth_of_targetnumeric
no_pressure_positive_epa_percentnumeric
turnover_worthy_playsnumeric
epanumericExpected points added (EPA) by the posteam for the given play.
pressure_spikesnumeric
pressure_grades_hands_fumblenumeric
left_deep_dropsnumeric
right_behind_los_def_gen_pressuresnumeric
pa_epanumeric
pressure_qb_ratingnumeric
center_deep_positive_epa_percentnumeric
center_deep_hit_as_threwnumeric
no_screen_attemptsnumeric
pa_passing_snapsnumeric
aimed_passesnumeric
blitz_batsnumeric
pressure_touchdownsnumeric
npa_completionsnumeric
short_spikesnumeric
pressure_thrown_awaysnumeric
right_behind_los_completionsnumeric
no_blitz_interceptionsnumeric
center_behind_los_drop_ratenumeric
short_dropsnumeric
deep_aimed_passesnumeric
right_medium_avg_depth_of_targetnumeric
short_pressure_to_sack_ratenumeric
screen_touchdownsnumeric
center_deep_qb_ratingnumeric
left_medium_completionsnumeric
center_deep_sacksnumeric
left_deep_big_time_throwsnumeric
blitz_dropbacksnumeric
center_medium_first_downsnumeric
center_medium_dropbacksnumeric
blitz_def_gen_pressuresnumeric
npa_first_downsnumeric
no_screen_touchdownsnumeric
right_deep_def_gen_pressuresnumeric
left_short_touchdownsnumeric
medium_drop_ratenumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
npa_yardsnumeric
left_medium_ypanumeric
right_medium_passing_snapsnumeric
no_screen_ypanumeric
no_blitz_big_time_throwsnumeric
center_short_scramblesnumeric
npa_turnover_worthy_playsnumeric
left_behind_los_turnover_worthy_playsnumeric
center_medium_yardsnumeric
center_deep_epanumeric
npa_interceptionsnumeric
left_medium_interceptionsnumeric
right_deep_interceptionsnumeric
no_pressure_avg_depth_of_targetnumeric
touchdownsnumeric
medium_completion_percentnumeric
right_behind_los_grades_passnumeric
deep_positive_epa_percentnumeric
no_screen_pressure_to_sack_ratenumeric
behind_los_accuracy_percentnumeric
center_deep_scramblesnumeric
center_short_twp_ratenumeric
behind_los_touchdownsnumeric
left_medium_qb_ratingnumeric
no_pressure_yardsnumeric
screen_sacksnumeric
def_gen_pressuresnumeric
right_medium_completionsnumeric
right_behind_los_dropsnumeric
left_behind_los_first_downsnumeric
blitz_twp_ratenumeric
short_qb_ratingnumeric
blitz_accuracy_percentnumeric
center_medium_btt_ratenumeric
no_pressure_big_time_throwsnumeric
left_deep_grades_passnumeric
no_blitz_grades_pass_blocknumeric
screen_grades_hands_dropnumeric
screen_grades_pass_blocknumeric
no_screen_grades_pass_blocknumeric
pressure_grades_pass_routenumeric
no_screen_grades_pass_routenumeric
pa_grades_hands_dropnumeric
blitz_grades_pass_blocknumeric
screen_grades_pass_routenumeric
no_pressure_grades_pass_blocknumeric
npa_grades_pass_blocknumeric
pressure_grades_pass_blocknumeric
pa_grades_pass_blocknumeric
no_pressure_grades_hands_dropnumeric
npa_grades_pass_routenumeric
npa_grades_hands_dropnumeric
pa_grades_pass_routenumeric
blitz_grades_hands_dropnumeric
blitz_grades_pass_routenumeric
no_screen_grades_hands_dropnumeric
no_pressure_grades_pass_routenumeric
no_blitz_grades_pass_routenumeric
pressure_grades_hands_dropnumeric
no_blitz_grades_hands_dropnumeric
pa_grades_screen_blocknumeric
blitz_grades_run_blocknumeric
screen_grades_screen_blocknumeric
no_pressure_grades_run_blocknumeric
no_screen_grades_screen_blocknumeric
no_blitz_grades_run_blocknumeric
blitz_grades_screen_blocknumeric
pressure_grades_screen_blocknumeric
no_blitz_grades_screen_blocknumeric
npa_grades_screen_blocknumeric
pressure_grades_run_blocknumeric
no_pressure_grades_screen_blocknumeric
pa_grades_defense_penaltycharacter
screen_grades_run_defensecharacter
npa_grades_defense_penaltynumeric
pa_grades_run_defensecharacter
pa_grades_defensecharacter
npa_grades_defensenumeric
screen_grades_defensecharacter
screen_grades_defense_penaltycharacter
no_screen_grades_run_defensenumeric
no_screen_grades_defensenumeric
no_screen_grades_defense_penaltynumeric
npa_grades_run_defensenumeric

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

Example

pff_facet_passing_detail_stats()

Last validated n/a.

pff_facet_run_blocking

Facet report /offense/run_blocking (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/offense/run_blocking

Valid URL: https://premium.pff.com/api/v1/facet/offense/run_blocking

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
declined_penaltiesnumeric
draft_seasonnumeric
eligible_seasonnumeric
franchise_idnumericESPN franchise identifier.
gap_grades_run_blocknumeric
gap_run_block_percentnumeric
gap_snap_counts_run_blocknumeric
gap_snap_counts_run_block_percentnumeric
gap_snap_counts_run_playnumeric
grades_run_blocknumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
penaltiesnumericTotal number of penalties.
playercharacterPlayer name
player_game_countnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
positioncharacterPrimary position as reported by NFL.com
run_block_percentnumeric
snap_counts_run_blocknumeric
snap_counts_run_playnumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
zone_grades_run_blocknumeric
zone_run_block_percentnumeric
zone_snap_counts_run_blocknumeric
zone_snap_counts_run_block_percentnumeric
zone_snap_counts_run_playnumeric

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

Example

pff_facet_run_blocking()

Last validated n/a.

pff_facet_pass_blocking

Facet report /offense/pass_blocking (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/offense/pass_blocking

Valid URL: https://premium.pff.com/api/v1/facet/offense/pass_blocking

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
true_pass_set_non_spike_pass_block_percentagenumeric
true_pass_set_pressures_allowednumeric
grades_pass_blocknumeric
true_pass_set_pass_block_percentnumeric
pbenumeric
non_spike_pass_block_percentagenumeric
draft_seasonnumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
hits_allowednumeric
true_pass_set_non_spike_pass_blocknumeric
player_game_countnumeric
eligible_seasonnumeric
hurries_allowednumeric
true_pass_set_hurries_allowednumeric
true_pass_set_snap_counts_pass_playnumeric
true_pass_set_hits_allowednumeric
pressures_allowednumeric
true_pass_set_pbenumeric
snap_counts_pass_playnumeric
penaltiesnumericTotal number of penalties.
sacks_allowednumericOpponent sacks.
teamcharacterNFL team. Uses official abbreviations as per NFL.com
declined_penaltiesnumeric
positioncharacterPrimary position as reported by NFL.com
true_pass_set_grades_pass_blocknumeric
non_spike_pass_blocknumeric
true_pass_set_snap_counts_pass_blocknumeric
playercharacterPlayer name
true_pass_set_sacks_allowednumeric
franchise_idnumericESPN franchise identifier.
snap_counts_pass_blocknumeric
pass_block_percentnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters

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

Example

pff_facet_pass_blocking()

Last validated n/a.

pff_facet_passing_summary

Facet report /passing/summary (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/passing/summary

Valid URL: https://premium.pff.com/api/v1/facet/passing/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
grades_offensenumericPFF overall offense grade (0-100).
twp_ratenumericTurnover-worthy-play rate.
btt_ratenumericBig-time-throw rate.
spikesnumericClock-stopping spike plays.
dropbacksnumericTotal quarterback dropbacks.
thrown_awaysnumericPasses intentionally thrown away.
draft_seasonnumericDraft class (year) of the player.
team_namecharacterTeam name/abbreviation the player is credited to for the range.
grades_passnumericPFF passing grade (0-100).
hit_as_threwnumericPlays where the quarterback was hit as he threw.
first_downsnumericPassing first downs.
jersey_numbercharacterJersey number (string; zero-padded, e.g. "09").
sack_percentnumericSack rate (sacks per dropback).
batsnumericPasses batted at the line.
sacksnumericTimes the passer was sacked.
player_game_countnumericGames with at least one qualifying dropback in the requested range.
eligible_seasonnumericFirst eligible season for the player.
completionsnumericCompleted passes by the passer.
yardsnumericTotal passing yards gained.
accuracy_percentnumericCharted accuracy percentage.
scramblesnumericScramble plays.
interceptionsnumericInterceptions thrown.
drop_ratenumericReceiver drop rate on the quarterback's throws.
grades_runnumericPFF rushing grade (0-100).
qb_ratingnumericNFL passer rating.
completion_percentnumericCompletion percentage.
penaltiesnumericPenalties charged.
attemptsnumericPass attempts thrown by the passer.
teamcharacterTeam abbreviation the player is credited to for the range.
declined_penaltiesnumericDeclined penalties.
passing_snapsnumeric
pressure_to_sack_ratenumeric
ypanumeric
dropsnumericThrows dropped
positioncharacterPrimary position as reported by NFL.com
grades_hands_fumblenumeric
avg_time_to_thrownumericAverage time elapsed from the time of snap to throw on every pass attempt for a passer (sacks excluded).
big_time_throwsnumeric
playercharacterPlayer name
positive_epa_percentnumeric
franchise_idnumericPFF franchise (team) id (integer join key).
avg_depth_of_targetnumeric
turnover_worthy_playsnumeric
epanumericExpected points added (EPA) by the posteam for the given play.
aimed_passesnumeric
player_idnumericPFF player id (integer; matches the /players id and every player_id join key).
touchdownsnumeric
def_gen_pressuresnumeric

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

Example

pff_facet_passing_summary()

Last validated n/a.

pff_facet_punting_summary

Facet report /punting/summary (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/punting/summary

Valid URL: https://premium.pff.com/api/v1/facet/punting/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
touchbacksnumeric
attempts_with_hangtimenumeric
draft_seasonnumeric
percent_returnednumeric
fair_catchesnumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
player_game_countnumeric
eligible_seasonnumeric
average_net_yardsnumeric
yardsnumericThe number of receiving yards
average_hangtimenumeric
total_net_yardsnumeric
penaltiesnumericTotal number of penalties.
attemptsnumericThe number of pass attempts as defined by the NFL.
inside_twentiesnumeric
out_of_boundsnumeric1 if play description contains ran ob, pushed ob, or sacked ob; 0 otherwise.
teamcharacterNFL team. Uses official abbreviations as per NFL.com
average_yards_per_returnnumeric
total_hangtimenumeric
declined_penaltiesnumeric
returnsnumeric
positioncharacterPrimary position as reported by NFL.com
longnumeric
blocksnumericTotal blocks.
average_yards_per_attemptnumeric
playercharacterPlayer name
franchise_idnumericESPN franchise identifier.
grades_punternumeric
return_yardsnumericYards gained by the return team. Returns may occur on any of: interception, fumble, kickoff, punt, or blocked kicks.
downedsnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
snapsnumeric

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

Example

pff_facet_punting_summary()

Last validated n/a.

pff_facet_passing_depth

Facet report /passing/depth (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/passing/depth

Valid URL: https://premium.pff.com/api/v1/facet/passing/depth

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
left_behind_los_accuracy_percentnumeric
left_short_scramblesnumeric
center_short_first_downsnumeric
right_short_batsnumeric
right_behind_los_positive_epa_percentnumeric
left_behind_los_completionsnumeric
left_medium_dropbacksnumeric
right_medium_grades_passnumeric
right_medium_hit_as_threwnumeric
behind_los_attempts_percentnumeric
right_short_turnover_worthy_playsnumeric
right_medium_qb_ratingnumeric
deep_twp_ratenumeric
center_medium_sacksnumeric
medium_interceptionsnumeric
left_deep_completionsnumeric
behind_los_spikesnumeric
medium_aimed_passesnumeric
center_behind_los_dropsnumeric
center_behind_los_interceptionsnumeric
behind_los_dropbacksnumeric
left_behind_los_interceptionsnumeric
left_deep_first_downsnumeric
deep_passing_snapsnumeric
center_short_btt_ratenumeric
center_medium_thrown_awaysnumeric
center_deep_avg_depth_of_targetnumeric
center_short_dropsnumeric
center_deep_first_downsnumeric
left_medium_completion_percentnumeric
center_deep_attemptsnumeric
center_behind_los_attemptsnumeric
right_short_positive_epa_percentnumeric
center_deep_aimed_passesnumeric
right_deep_grades_passnumeric
right_medium_big_time_throwsnumeric
deep_sack_percentnumeric
center_medium_pressure_to_sack_ratenumeric
deep_sacksnumeric
right_medium_ypanumeric
left_deep_drop_ratenumeric
right_medium_attempts_percentnumeric
right_deep_btt_ratenumeric
center_short_attempts_percentnumeric
deep_dropsnumeric
center_behind_los_big_time_throwsnumeric
center_behind_los_touchdownsnumeric
right_behind_los_twp_ratenumeric
center_deep_completionsnumeric
center_short_attemptsnumeric
left_behind_los_sack_percentnumeric
center_short_pressure_to_sack_ratenumeric
deep_touchdownsnumeric
center_behind_los_accuracy_percentnumeric
center_deep_drop_ratenumeric
right_short_first_downsnumeric
right_behind_los_first_downsnumeric
short_interceptionsnumeric
center_medium_scramblesnumeric
left_behind_los_sacksnumeric
left_short_ypanumeric
left_short_qb_ratingnumeric
right_behind_los_qb_ratingnumeric
draft_seasonnumeric
right_behind_los_dropbacksnumeric
behind_los_def_gen_pressuresnumeric
right_short_thrown_awaysnumeric
deep_def_gen_pressuresnumeric
right_short_btt_ratenumeric
center_behind_los_positive_epa_percentnumeric
left_behind_los_grades_passnumeric
deep_grades_passnumeric
center_short_turnover_worthy_playsnumeric
center_behind_los_scramblesnumeric
right_short_aimed_passesnumeric
center_short_dropbacksnumeric
medium_epanumeric
right_short_ypanumeric
center_medium_ypanumeric
medium_attemptsnumeric
right_deep_accuracy_percentnumeric
behind_los_scramblesnumeric
center_behind_los_completion_percentnumeric
left_behind_los_btt_ratenumeric
right_behind_los_btt_ratenumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
short_touchdownsnumeric
center_medium_dropsnumeric
left_behind_los_aimed_passesnumeric
deep_attemptsnumeric
right_behind_los_sack_percentnumeric
center_short_positive_epa_percentnumeric
deep_avg_depth_of_targetnumeric
left_deep_btt_ratenumeric
medium_scramblesnumeric
center_behind_los_avg_depth_of_targetnumeric
short_attempts_percentnumeric
right_behind_los_sacksnumeric
center_medium_avg_time_to_thrownumeric
left_short_pressure_to_sack_ratenumeric
center_deep_sack_percentnumeric
center_deep_ypanumeric
left_behind_los_hit_as_threwnumeric
medium_big_time_throwsnumeric
deep_thrown_awaysnumeric
right_short_accuracy_percentnumeric
left_deep_turnover_worthy_playsnumeric
center_medium_batsnumeric
right_short_grades_passnumeric
right_deep_spikesnumeric
left_deep_passing_snapsnumeric
center_medium_twp_ratenumeric
right_behind_los_passing_snapsnumeric
left_deep_qb_ratingnumeric
right_deep_drop_ratenumeric
left_behind_los_drop_ratenumeric
left_medium_drop_ratenumeric
right_deep_attemptsnumeric
left_deep_spikesnumeric
center_behind_los_dropbacksnumeric
right_deep_big_time_throwsnumeric
medium_hit_as_threwnumeric
right_short_dropbacksnumeric
medium_def_gen_pressuresnumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
left_short_positive_epa_percentnumeric
left_short_attemptsnumeric
center_deep_twp_ratenumeric
right_medium_avg_time_to_thrownumeric
left_behind_los_qb_ratingnumeric
left_behind_los_dropbacksnumeric
deep_dropbacksnumeric
right_behind_los_scramblesnumeric
behind_los_interceptionsnumeric
right_deep_dropsnumeric
right_deep_yardsnumeric
right_short_hit_as_threwnumeric
right_short_avg_depth_of_targetnumeric
short_batsnumeric
right_deep_twp_ratenumeric
right_behind_los_pressure_to_sack_ratenumeric
deep_spikesnumeric
center_medium_spikesnumeric
behind_los_aimed_passesnumeric
right_behind_los_touchdownsnumeric
right_medium_pressure_to_sack_ratenumeric
medium_thrown_awaysnumeric
short_sacksnumeric
center_behind_los_twp_ratenumeric
left_behind_los_attemptsnumeric
short_aimed_passesnumeric
short_completionsnumeric
right_short_pressure_to_sack_ratenumeric
medium_avg_depth_of_targetnumeric
left_behind_los_positive_epa_percentnumeric
center_medium_attempts_percentnumeric
left_medium_touchdownsnumeric
center_short_batsnumeric
left_deep_avg_time_to_thrownumeric
center_behind_los_passing_snapsnumeric
center_short_yardsnumeric
right_medium_btt_ratenumeric
right_medium_scramblesnumeric
medium_btt_ratenumeric
center_behind_los_btt_ratenumeric
center_short_avg_depth_of_targetnumeric
left_medium_sacksnumeric
right_short_yardsnumeric
left_medium_first_downsnumeric
right_medium_positive_epa_percentnumeric
left_short_big_time_throwsnumeric
deep_turnover_worthy_playsnumeric
left_deep_batsnumeric
left_medium_turnover_worthy_playsnumeric
base_dropbacksnumeric
center_deep_dropsnumeric
center_medium_avg_depth_of_targetnumeric
center_behind_los_ypanumeric
right_short_attemptsnumeric
center_medium_completion_percentnumeric
right_short_sack_percentnumeric
left_behind_los_avg_depth_of_targetnumeric
center_medium_epanumeric
center_behind_los_sack_percentnumeric
medium_completionsnumeric
medium_sack_percentnumeric
left_short_grades_passnumeric
deep_btt_ratenumeric
left_short_accuracy_percentnumeric
short_twp_ratenumeric
short_passing_snapsnumeric
left_deep_sacksnumeric
short_scramblesnumeric
center_medium_turnover_worthy_playsnumeric
behind_los_drop_ratenumeric
right_behind_los_epanumeric
right_medium_aimed_passesnumeric
short_accuracy_percentnumeric
player_game_countnumeric
short_btt_ratenumeric
right_short_touchdownsnumeric
center_short_completionsnumeric
right_short_spikesnumeric
behind_los_first_downsnumeric
right_medium_def_gen_pressuresnumeric
deep_pressure_to_sack_ratenumeric
medium_qb_ratingnumeric
short_completion_percentnumeric
right_deep_attempts_percentnumeric
eligible_seasonnumeric
short_big_time_throwsnumeric
behind_los_attemptsnumeric
center_behind_los_yardsnumeric
center_behind_los_batsnumeric
center_behind_los_qb_ratingnumeric
right_deep_pressure_to_sack_ratenumeric
center_short_accuracy_percentnumeric
left_behind_los_batsnumeric
center_deep_passing_snapsnumeric
right_behind_los_hit_as_threwnumeric
medium_batsnumeric
right_medium_first_downsnumeric
medium_spikesnumeric
left_deep_thrown_awaysnumeric
right_deep_epanumeric
center_medium_hit_as_threwnumeric
left_behind_los_completion_percentnumeric
center_short_ypanumeric
right_short_drop_ratenumeric
right_behind_los_accuracy_percentnumeric
left_short_yardsnumeric
deep_accuracy_percentnumeric
right_behind_los_avg_depth_of_targetnumeric
center_behind_los_thrown_awaysnumeric
center_behind_los_attempts_percentnumeric
right_deep_first_downsnumeric
left_short_completionsnumeric
deep_completion_percentnumeric
left_deep_positive_epa_percentnumeric
right_deep_sack_percentnumeric
behind_los_pressure_to_sack_ratenumeric
right_deep_touchdownsnumeric
left_behind_los_def_gen_pressuresnumeric
left_behind_los_dropsnumeric
deep_epanumeric
left_deep_ypanumeric
medium_touchdownsnumeric
left_medium_grades_passnumeric
right_behind_los_spikesnumeric
medium_grades_passnumeric
behind_los_passing_snapsnumeric
left_short_first_downsnumeric
center_short_passing_snapsnumeric
center_deep_accuracy_percentnumeric
right_deep_positive_epa_percentnumeric
right_medium_sack_percentnumeric
right_deep_qb_ratingnumeric
right_short_completion_percentnumeric
right_behind_los_interceptionsnumeric
behind_los_yardsnumeric
center_behind_los_grades_passnumeric
left_deep_dropbacksnumeric
center_behind_los_spikesnumeric
right_behind_los_aimed_passesnumeric
left_short_interceptionsnumeric
right_medium_interceptionsnumeric
left_behind_los_yardsnumeric
center_deep_btt_ratenumeric
medium_first_downsnumeric
left_short_avg_depth_of_targetnumeric
left_behind_los_ypanumeric
short_attemptsnumeric
right_medium_batsnumeric
left_behind_los_touchdownsnumeric
right_medium_dropbacksnumeric
short_turnover_worthy_playsnumeric
right_deep_thrown_awaysnumeric
right_behind_los_drop_ratenumeric
right_short_qb_ratingnumeric
medium_sacksnumeric
center_deep_attempts_percentnumeric
left_short_dropbacksnumeric
behind_los_dropsnumeric
short_sack_percentnumeric
left_medium_spikesnumeric
left_medium_accuracy_percentnumeric
behind_los_completionsnumeric
behind_los_sack_percentnumeric
left_deep_yardsnumeric
left_short_aimed_passesnumeric
center_behind_los_completionsnumeric
left_short_thrown_awaysnumeric
left_short_sack_percentnumeric
center_short_thrown_awaysnumeric
center_short_interceptionsnumeric
short_avg_depth_of_targetnumeric
left_deep_touchdownsnumeric
deep_yardsnumeric
center_behind_los_turnover_worthy_playsnumeric
medium_ypanumeric
left_medium_epanumeric
left_deep_avg_depth_of_targetnumeric
deep_first_downsnumeric
short_drop_ratenumeric
left_medium_batsnumeric
center_deep_spikesnumeric
center_short_hit_as_threwnumeric
left_medium_positive_epa_percentnumeric
center_deep_touchdownsnumeric
right_deep_ypanumeric
right_short_big_time_throwsnumeric
center_short_big_time_throwsnumeric
short_positive_epa_percentnumeric
left_behind_los_avg_time_to_thrownumeric
right_deep_passing_snapsnumeric
right_short_twp_ratenumeric
center_medium_attemptsnumeric
right_deep_avg_time_to_thrownumeric
center_deep_def_gen_pressuresnumeric
behind_los_epanumeric
right_medium_twp_ratenumeric
right_deep_aimed_passesnumeric
right_deep_scramblesnumeric
deep_big_time_throwsnumeric
left_short_turnover_worthy_playsnumeric
center_short_touchdownsnumeric
right_medium_dropsnumeric
left_deep_epanumeric
short_ypanumeric
medium_pressure_to_sack_ratenumeric
left_medium_thrown_awaysnumeric
right_behind_los_avg_time_to_thrownumeric
behind_los_btt_ratenumeric
medium_avg_time_to_thrownumeric
center_deep_completion_percentnumeric
behind_los_avg_time_to_thrownumeric
right_medium_touchdownsnumeric
center_short_avg_time_to_thrownumeric
left_deep_aimed_passesnumeric
left_medium_yardsnumeric
center_medium_touchdownsnumeric
center_short_drop_ratenumeric
left_short_twp_ratenumeric
penaltiesnumericTotal number of penalties.
right_behind_los_attempts_percentnumeric
right_deep_avg_depth_of_targetnumeric
behind_los_sacksnumeric
center_deep_yardsnumeric
short_dropbacksnumeric
left_deep_sack_percentnumeric
center_behind_los_avg_time_to_thrownumeric
behind_los_avg_depth_of_targetnumeric
left_behind_los_epanumeric
medium_twp_ratenumeric
left_short_def_gen_pressuresnumeric
medium_turnover_worthy_playsnumeric
behind_los_twp_ratenumeric
left_behind_los_thrown_awaysnumeric
left_short_batsnumeric
center_medium_drop_ratenumeric
right_deep_batsnumeric
medium_yardsnumeric
center_deep_grades_passnumeric
center_medium_passing_snapsnumeric
center_behind_los_first_downsnumeric
center_medium_interceptionsnumeric
behind_los_grades_passnumeric
left_short_hit_as_threwnumeric
deep_qb_ratingnumeric
center_deep_batsnumeric
behind_los_ypanumeric
right_short_interceptionsnumeric
left_deep_interceptionsnumeric
right_medium_sacksnumeric
right_behind_los_turnover_worthy_playsnumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
right_medium_spikesnumeric
behind_los_hit_as_threwnumeric
left_medium_pressure_to_sack_ratenumeric
medium_dropbacksnumeric
deep_hit_as_threwnumeric
right_medium_completion_percentnumeric
short_epanumeric
deep_drop_ratenumeric
declined_penaltiesnumeric
deep_scramblesnumeric
left_deep_completion_percentnumeric
right_short_epanumeric
medium_attempts_percentnumeric
right_behind_los_completion_percentnumeric
left_medium_hit_as_threwnumeric
left_behind_los_pressure_to_sack_ratenumeric
right_short_def_gen_pressuresnumeric
right_short_attempts_percentnumeric
center_short_aimed_passesnumeric
short_hit_as_threwnumeric
right_medium_turnover_worthy_playsnumeric
left_short_epanumeric
center_behind_los_pressure_to_sack_ratenumeric
right_behind_los_ypanumeric
deep_interceptionsnumeric
left_medium_twp_ratenumeric
right_behind_los_big_time_throwsnumeric
center_medium_sack_percentnumeric
center_deep_thrown_awaysnumeric
short_thrown_awaysnumeric
left_short_btt_ratenumeric
right_medium_accuracy_percentnumeric
positioncharacterPrimary position as reported by NFL.com
short_def_gen_pressuresnumeric
center_deep_dropbacksnumeric
center_medium_accuracy_percentnumeric
right_behind_los_yardsnumeric
right_medium_attemptsnumeric
left_medium_attemptsnumeric
medium_accuracy_percentnumeric
left_medium_dropsnumeric
left_short_avg_time_to_thrownumeric
medium_passing_snapsnumeric
center_short_epanumeric
left_behind_los_passing_snapsnumeric
left_deep_pressure_to_sack_ratenumeric
deep_batsnumeric
left_medium_passing_snapsnumeric
left_medium_scramblesnumeric
right_deep_completion_percentnumeric
left_short_dropsnumeric
left_deep_accuracy_percentnumeric
medium_positive_epa_percentnumeric
behind_los_turnover_worthy_playsnumeric
right_medium_epanumeric
right_deep_dropbacksnumeric
deep_ypanumeric
center_medium_completionsnumeric
left_medium_avg_time_to_thrownumeric
left_short_sacksnumeric
left_behind_los_spikesnumeric
left_deep_def_gen_pressuresnumeric
center_short_qb_ratingnumeric
center_deep_interceptionsnumeric
right_deep_completionsnumeric
center_behind_los_sacksnumeric
deep_completionsnumeric
left_medium_attempts_percentnumeric
short_yardsnumeric
behind_los_qb_ratingnumeric
right_short_sacksnumeric
right_behind_los_thrown_awaysnumeric
base_attemptsnumeric
center_short_spikesnumeric
center_behind_los_hit_as_threwnumeric
center_deep_turnover_worthy_playsnumeric
left_medium_sack_percentnumeric
behind_los_completion_percentnumeric
left_deep_attempts_percentnumeric
center_deep_big_time_throwsnumeric
playercharacterPlayer name
left_medium_avg_depth_of_targetnumeric
behind_los_thrown_awaysnumeric
center_medium_def_gen_pressuresnumeric
short_avg_time_to_thrownumeric
left_deep_twp_ratenumeric
center_behind_los_epanumeric
left_behind_los_big_time_throwsnumeric
right_medium_yardsnumeric
right_medium_drop_ratenumeric
center_medium_big_time_throwsnumeric
franchise_idnumericESPN franchise identifier.
left_short_completion_percentnumeric
left_short_drop_ratenumeric
left_behind_los_scramblesnumeric
left_medium_btt_ratenumeric
right_deep_hit_as_threwnumeric
behind_los_batsnumeric
short_first_downsnumeric
left_deep_attemptsnumeric
right_behind_los_attemptsnumeric
right_deep_sacksnumeric
left_behind_los_attempts_percentnumeric
behind_los_big_time_throwsnumeric
center_deep_pressure_to_sack_ratenumeric
left_medium_big_time_throwsnumeric
right_behind_los_batsnumeric
left_medium_def_gen_pressuresnumeric
right_deep_turnover_worthy_playsnumeric
left_short_spikesnumeric
left_medium_aimed_passesnumeric
left_behind_los_twp_ratenumeric
short_grades_passnumeric
right_short_dropsnumeric
right_short_avg_time_to_thrownumeric
right_medium_thrown_awaysnumeric
center_short_sack_percentnumeric
right_short_passing_snapsnumeric
center_short_def_gen_pressuresnumeric
center_medium_positive_epa_percentnumeric
medium_dropsnumeric
center_medium_aimed_passesnumeric
center_short_sacksnumeric
deep_attempts_percentnumeric
center_behind_los_def_gen_pressuresnumeric
left_short_passing_snapsnumeric
center_medium_grades_passnumeric
center_deep_avg_time_to_thrownumeric
behind_los_positive_epa_percentnumeric
center_short_completion_percentnumeric
left_deep_hit_as_threwnumeric
center_short_grades_passnumeric
left_short_attempts_percentnumeric
left_deep_scramblesnumeric
right_short_completionsnumeric
center_behind_los_aimed_passesnumeric
right_short_scramblesnumeric
center_medium_qb_ratingnumeric
deep_avg_time_to_thrownumeric
left_deep_dropsnumeric
right_behind_los_def_gen_pressuresnumeric
center_deep_positive_epa_percentnumeric
center_deep_hit_as_threwnumeric
short_spikesnumeric
right_behind_los_completionsnumeric
center_behind_los_drop_ratenumeric
short_dropsnumeric
deep_aimed_passesnumeric
right_medium_avg_depth_of_targetnumeric
short_pressure_to_sack_ratenumeric
center_deep_qb_ratingnumeric
left_medium_completionsnumeric
center_deep_sacksnumeric
left_deep_big_time_throwsnumeric
center_medium_first_downsnumeric
center_medium_dropbacksnumeric
right_deep_def_gen_pressuresnumeric
left_short_touchdownsnumeric
medium_drop_ratenumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
left_medium_ypanumeric
right_medium_passing_snapsnumeric
center_short_scramblesnumeric
left_behind_los_turnover_worthy_playsnumeric
center_medium_yardsnumeric
center_deep_epanumeric
left_medium_interceptionsnumeric
right_deep_interceptionsnumeric
medium_completion_percentnumeric
right_behind_los_grades_passnumeric
deep_positive_epa_percentnumeric
behind_los_accuracy_percentnumeric
center_deep_scramblesnumeric
center_short_twp_ratenumeric
behind_los_touchdownsnumeric
left_medium_qb_ratingnumeric
right_medium_completionsnumeric
right_behind_los_dropsnumeric
left_behind_los_first_downsnumeric
short_qb_ratingnumeric
center_medium_btt_ratenumeric
left_deep_grades_passnumeric

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

Example

pff_facet_passing_depth()

Last validated n/a.

pff_facet_passing_pressure

Facet report /passing/pressure (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/passing/pressure

Valid URL: https://premium.pff.com/api/v1/facet/passing/pressure

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
no_blitz_completion_percentnumeric
grades_offensenumeric
no_pressure_scramblesnumeric
blitz_touchdownsnumeric
pressure_yardsnumeric
no_pressure_spikesnumeric
blitz_ypanumeric
no_blitz_grades_runnumeric
blitz_qb_ratingnumeric
no_pressure_thrown_awaysnumeric
no_blitz_batsnumeric
no_blitz_dropsnumeric
no_pressure_completion_percentnumeric
blitz_aimed_passesnumeric
pressure_grades_runnumeric
no_blitz_sack_percentnumeric
no_pressure_batsnumeric
pressure_completionsnumeric
blitz_big_time_throwsnumeric
no_blitz_drop_ratenumeric
blitz_spikesnumeric
no_pressure_completionsnumeric
draft_seasonnumeric
no_pressure_passing_snapsnumeric
no_blitz_first_downsnumeric
blitz_avg_time_to_thrownumeric
no_pressure_grades_hands_fumblenumeric
pressure_aimed_passesnumeric
blitz_sacksnumeric
no_pressure_interceptionsnumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
pressure_epanumeric
blitz_completionsnumeric
blitz_attemptsnumeric
pressure_twp_ratenumeric
pressure_sacksnumeric
no_blitz_pressure_to_sack_ratenumeric
no_pressure_ypanumeric
pressure_passing_snapsnumeric
grades_passnumeric
pressure_batsnumeric
blitz_thrown_awaysnumeric
no_pressure_dropsnumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
pressure_grades_offense_penaltynumeric
pressure_scramblesnumeric
blitz_drop_ratenumeric
pressure_grades_pass_routenumeric
blitz_completion_percentnumeric
no_pressure_first_downsnumeric
blitz_grades_offense_penaltynumeric
no_blitz_epanumeric
blitz_interceptionsnumeric
no_blitz_dropbacksnumeric
no_blitz_grades_passnumeric
no_blitz_scramblesnumeric
pressure_drop_ratenumeric
no_blitz_yardsnumeric
base_dropbacksnumeric
pressure_pressure_to_sack_ratenumeric
no_blitz_grades_hands_fumblenumeric
no_pressure_grades_offensenumeric
no_pressure_avg_time_to_thrownumeric
pressure_dropbacksnumeric
no_blitz_grades_offense_penaltynumeric
no_pressure_grades_runnumeric
player_game_countnumeric
blitz_turnover_worthy_playsnumeric
no_blitz_touchdownsnumeric
no_blitz_avg_depth_of_targetnumeric
no_pressure_dropbacks_percentnumeric
blitz_grades_passnumeric
eligible_seasonnumeric
blitz_avg_depth_of_targetnumeric
no_blitz_spikesnumeric
no_pressure_dropbacksnumeric
blitz_btt_ratenumeric
blitz_positive_epa_percentnumeric
no_pressure_btt_ratenumeric
no_pressure_drop_ratenumeric
no_blitz_turnover_worthy_playsnumeric
pressure_positive_epa_percentnumeric
blitz_first_downsnumeric
no_blitz_dropbacks_percentnumeric
pressure_turnover_worthy_playsnumeric
no_pressure_epanumeric
no_blitz_avg_time_to_thrownumeric
no_blitz_positive_epa_percentnumeric
pressure_btt_ratenumeric
no_pressure_aimed_passesnumeric
pressure_dropbacks_percentnumeric
grades_runnumeric
no_pressure_def_gen_pressuresnumeric
pressure_grades_offensenumeric
pressure_completion_percentnumeric
pressure_avg_depth_of_targetnumeric
blitz_epanumeric
pressure_dropsnumeric
no_blitz_def_gen_pressuresnumeric
pressure_attemptsnumeric
pressure_big_time_throwsnumeric
no_blitz_thrown_awaysnumeric
blitz_dropsnumeric
no_pressure_touchdownsnumeric
no_pressure_sacksnumeric
blitz_sack_percentnumeric
pressure_sack_percentnumeric
penaltiesnumericTotal number of penalties.
no_pressure_attemptsnumeric
no_blitz_grades_offensenumeric
blitz_scramblesnumeric
blitz_dropbacks_percentnumeric
no_pressure_qb_ratingnumeric
no_blitz_passing_snapsnumeric
no_blitz_aimed_passesnumeric
blitz_yardsnumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
no_blitz_attemptsnumeric
pressure_accuracy_percentnumeric
no_blitz_hit_as_threwnumeric
pressure_hit_as_threwnumeric
blitz_pressure_to_sack_ratenumeric
declined_penaltiesnumeric
no_blitz_btt_ratenumeric
no_blitz_ypanumeric
blitz_grades_runnumeric
pressure_interceptionsnumeric
blitz_grades_hands_fumblenumeric
no_pressure_grades_offense_penaltynumeric
positioncharacterPrimary position as reported by NFL.com
blitz_grades_offensenumeric
grades_hands_fumblenumeric
pressure_def_gen_pressuresnumeric
pressure_grades_passnumeric
no_blitz_qb_ratingnumeric
blitz_hit_as_threwnumeric
pressure_ypanumeric
blitz_grades_pass_routenumeric
pressure_avg_time_to_thrownumeric
no_blitz_completionsnumeric
no_pressure_grades_pass_routenumeric
no_pressure_sack_percentnumeric
playercharacterPlayer name
no_blitz_accuracy_percentnumeric
no_pressure_pressure_to_sack_ratecharacter
no_pressure_turnover_worthy_playsnumeric
pressure_first_downsnumeric
blitz_passing_snapsnumeric
franchise_idnumericESPN franchise identifier.
no_pressure_twp_ratenumeric
no_blitz_sacksnumeric
no_blitz_grades_pass_routenumeric
no_pressure_accuracy_percentnumeric
no_blitz_twp_ratenumeric
no_pressure_hit_as_threwnumeric
no_pressure_grades_passnumeric
no_pressure_positive_epa_percentnumeric
pressure_spikesnumeric
pressure_grades_hands_fumblenumeric
pressure_qb_ratingnumeric
blitz_batsnumeric
pressure_touchdownsnumeric
pressure_thrown_awaysnumeric
no_blitz_interceptionsnumeric
blitz_dropbacksnumeric
blitz_def_gen_pressuresnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
no_blitz_big_time_throwsnumeric
no_pressure_avg_depth_of_targetnumeric
no_pressure_yardsnumeric
blitz_twp_ratenumeric
blitz_accuracy_percentnumeric
no_pressure_big_time_throwsnumeric
no_blitz_grades_pass_blocknumeric
blitz_grades_pass_blocknumeric
no_pressure_grades_pass_blocknumeric
pressure_grades_pass_blocknumeric
no_pressure_grades_hands_dropnumeric
blitz_grades_hands_dropnumeric
pressure_grades_hands_dropnumeric
no_blitz_grades_hands_dropnumeric
blitz_grades_run_blocknumeric
no_pressure_grades_run_blocknumeric
no_blitz_grades_run_blocknumeric
blitz_grades_screen_blocknumeric
pressure_grades_screen_blocknumeric
no_blitz_grades_screen_blocknumeric
pressure_grades_run_blocknumeric
no_pressure_grades_screen_blocknumeric
pressure_grades_coverage_defensenumeric
pressure_grades_defensenumeric
no_blitz_grades_defensenumeric
no_blitz_grades_defense_penaltynumeric
blitz_grades_coverage_defensenumeric
no_pressure_grades_defensenumeric
no_pressure_grades_defense_penaltynumeric
no_blitz_grades_coverage_defensenumeric
blitz_grades_defensenumeric
blitz_grades_defense_penaltynumeric
no_pressure_grades_coverage_defensenumeric
pressure_grades_defense_penaltynumeric
pressure_grades_pass_rush_defensenumeric
blitz_grades_pass_rush_defensenumeric
no_pressure_grades_tacklenumeric
blitz_grades_tacklenumeric
blitz_grades_overall_tacklenumeric
no_pressure_grades_pass_rush_defensenumeric
pressure_grades_overall_tacklenumeric
no_blitz_grades_overall_tacklenumeric
pressure_grades_tacklenumeric
no_blitz_grades_pass_rush_defensecharacter
no_pressure_grades_overall_tacklenumeric
no_blitz_grades_tacklenumeric

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

Example

pff_facet_passing_pressure()

Last validated n/a.

pff_facet_receiving_summary

Facet report /receiving/summary (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/receiving/summary

Valid URL: https://premium.pff.com/api/v1/facet/receiving/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
targetsnumericTimes targeted.
grades_pass_blocknumeric
grades_offensenumericPFF overall offense grade (0-100).
yards_after_catch_per_receptionnumeric
grades_pass_routenumericPFF receiving/route grade (0-100).
draft_seasonnumeric
team_namecharacterTeam abbreviation the player is credited to for the range.
yprrnumericYards per route run.
wide_snapsnumeric
fumblesnumeric
first_downsnumericFirst downs earned by the team.
jersey_numbercharacterJersey number (string; zero-padded, e.g. "09").
inline_snapsnumeric
contested_targetsnumericContested targets.
player_game_countnumericGames with at least one qualifying snap in the requested range.
eligible_seasonnumeric
inline_ratenumeric
contested_catch_ratenumeric
yardsnumericReceiving yards.
receptionsnumericPasses caught by the receiver.
targeted_qb_ratingnumeric
interceptionsnumericThe number of interceptions thrown.
caught_percentnumeric
drop_ratenumeric
grades_hands_dropnumericPFF hands/drop grade (0-100).
slot_ratenumeric
slot_snapsnumeric
penaltiesnumericTotal number of penalties.
wide_ratenumeric
pass_block_ratenumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
declined_penaltiesnumeric
route_ratenumeric
dropsnumericDropped passes.
positioncharacterPrimary position as reported by NFL.com
grades_hands_fumblenumeric
longestnumeric
pass_blocksnumeric
routesnumericPass routes run by the receiver.
pass_playsnumeric
yards_per_receptionnumeric
playercharacterPlayer name
positive_epa_percentnumeric
franchise_idnumericPFF franchise (team) id (integer join key).
contested_receptionsnumericContested catches made.
yards_after_catchnumericYards after the catch.
avg_depth_of_targetnumeric
epanumericExpected points added (EPA) by the posteam for the given play.
avoided_tacklesnumeric
player_idnumericPFF player id (integer; matches the /players id and every player_id join key).
touchdownsnumericReceiving touchdowns.

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

Example

pff_facet_receiving_summary()

Last validated n/a.

pff_facet_return_summary

Facet report /return/summary (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/return/summary

Valid URL: https://premium.pff.com/api/v1/facet/return/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
declined_penaltiesnumeric
draft_seasonnumeric
eligible_seasonnumeric
franchise_idnumericESPN franchise identifier.
grades_kick_returnnumeric
grades_returnnumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
kickoff_attemptsnumeric
kickoff_fair_catchesnumeric
kickoff_longnumeric
kickoff_muffed_returnsnumeric
kickoff_touchdownsnumeric
kickoff_yardsnumeric
kickoff_ypanumeric
penaltiesnumericTotal number of penalties.
playercharacterPlayer name
player_game_countnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
positioncharacterPrimary position as reported by NFL.com
punt_attemptsnumeric
punt_fair_catchesnumeric
punt_longnumeric
punt_muffed_returnsnumeric
punt_touchdownsnumeric
punt_yardsnumeric
punt_ypanumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
total_attemptsnumeric
grades_punt_returnnumeric

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

Example

pff_facet_return_summary()

Last validated n/a.

pff_facet_rushing_direction_stats

Facet report /rushing/direction (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/rushing/direction

Valid URL: https://premium.pff.com/api/v1/facet/rushing/direction

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
directionslist
draft_seasonnumeric
eligible_seasonnumeric
franchise_idnumericESPN franchise identifier.
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
playercharacterPlayer name
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
positioncharacterPrimary position as reported by NFL.com
teamcharacterNFL team. Uses official abbreviations as per NFL.com
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
total_attemptsnumeric

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

Example

pff_facet_rushing_direction_stats()

Last validated n/a.

pff_facet_receiving_coverage_stats

Facet report /defense/coverage_matchup (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/defense/coverage_matchup

Valid URL: https://premium.pff.com/api/v1/facet/defense/coverage_matchup

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_pff_report); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

pff_facet_receiving_coverage_stats()

Last validated n/a.

pff_facet_rushing_summary

Facet report /rushing/summary (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/rushing/summary

Valid URL: https://premium.pff.com/api/v1/facet/rushing/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
targetsnumericThe number of pass plays where the player was the targeted receiver.
grades_pass_blocknumeric
grades_offensenumericPFF overall offense grade (0-100).
yards_after_contactnumericYards after contact.
explosivenumeric
grades_pass_routenumeric
draft_seasonnumeric
elu_rush_mtfnumeric
breakaway_attemptsnumeric
designed_yardsnumeric
team_namecharacterTeam abbreviation the player is credited to for the range.
yprrnumeric
breakaway_percentnumeric
fumblesnumericFumbles by the ball carrier.
first_downsnumericRushing first downs.
elusive_ratingnumericPFF elusive rating.
jersey_numbercharacterJersey number (string; zero-padded, e.g. "09").
breakaway_yardsnumericBreakaway (long-run) yards.
player_game_countnumericGames with at least one qualifying snap in the requested range.
eligible_seasonnumeric
total_touchesnumeric
scramble_yardsnumeric
yco_attemptnumeric
yardsnumericTotal rushing yards gained.
grades_run_blocknumeric
receptionsnumericThe number of pass receptions. Lateral receptions officially don't count as reception.
zone_attemptsnumeric
scramblesnumeric
grades_runnumericPFF rushing grade (0-100).
penaltiesnumericTotal number of penalties.
attemptsnumericRushing attempts (carries) by the runner.
elu_yconumeric
elu_recv_mtfnumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
declined_penaltiesnumeric
ypanumeric
dropsnumericThrows dropped
positioncharacterPrimary position as reported by NFL.com
grades_hands_fumblenumeric
longestnumeric
routesnumeric
playercharacterPlayer name
franchise_idnumericPFF franchise (team) id (integer join key).
rec_yardsnumericCareer receiving yards
gap_attemptsnumeric
run_playsnumeric
avoided_tacklesnumericMissed tackles forced.
grades_offense_penaltynumeric
player_idnumericPFF player id (integer; matches the /players id and every player_id join key).
touchdownsnumericRushing touchdowns.
grades_passnumeric

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

Example

pff_facet_rushing_summary()

Last validated n/a.

pff_facet_slot_coverages

Facet report /signature/defense/slot_coverage (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/signature/defense/slot_coverage

Valid URL: https://premium.pff.com/api/v1/facet/signature/defense/slot_coverage

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
coverage_snapsnumeric
coverage_snaps_per_receptionnumeric
coverage_snaps_per_targetnumeric
draft_seasonnumeric
eligible_seasonnumeric
franchise_idnumericESPN franchise identifier.
interceptionsnumericThe number of interceptions thrown.
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
playercharacterPlayer name
player_game_countnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
positioncharacterPrimary position as reported by NFL.com
qb_rating_againstnumeric
receptionsnumericThe number of pass receptions. Lateral receptions officially don't count as reception.
targetsnumericThe number of pass plays where the player was the targeted receiver.
teamcharacterNFL team. Uses official abbreviations as per NFL.com
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
touchdownsnumeric
yardsnumericThe number of receiving yards
yards_after_catchnumericNumeric value for distance in yards perpendicular to the yard line where the receiver made the reception to where the play ended.
yards_per_coverage_snapnumeric

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

Example

pff_facet_slot_coverages()

Last validated n/a.

pff_facet_pbes

Facet report /signature/pass-blocking/efficiency/line (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/signature/pass-blocking/efficiency/line

Valid URL: https://premium.pff.com/api/v1/facet/signature/pass-blocking/efficiency/line

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
attemptsnumericThe number of pass attempts as defined by the NFL.
franchise_idnumericESPN franchise identifier.
hits_allowednumeric
hurries_allowednumeric
pass_snapsnumeric
pbenumeric
player_game_countnumeric
pressures_allowednumeric
sacks_allowednumericOpponent sacks.
season_idnumericUnique season identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').

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

Example

pff_facet_pbes()

Last validated n/a.

pff_facet_prps

Facet report /signature/defense/outside_pass_rush (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/signature/defense/outside_pass_rush

Valid URL: https://premium.pff.com/api/v1/facet/signature/defense/outside_pass_rush

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
lhs_sacksnumeric
rhs_hitsnumeric
rhs_prpnumeric
draft_seasonnumeric
pass_snapsnumeric
lhs_hurriesnumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
prpnumeric
tacklesnumericTeam tackles.
rhs_pressuresnumeric
rhs_pass_rush_percentnumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
lhs_pass_rush_percentnumeric
lhs_pass_rush_snapsnumeric
sacksnumericThe Number of times sacked.
lhs_assistsnumeric
player_game_countnumeric
eligible_seasonnumeric
lhs_pressuresnumeric
pass_rush_snapsnumeric
hurriesnumeric
rhs_pass_rush_snapsnumeric
lhs_prpnumeric
hitsnumericHits.
lhs_hitsnumeric
rhs_tacklesnumeric
lhs_stopsnumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
stopsnumeric
rhs_missesnumeric
positioncharacterPrimary position as reported by NFL.com
pressuresnumeric
missesnumeric
playercharacterPlayer name
rhs_sacksnumeric
franchise_idnumericESPN franchise identifier.
pass_rush_percentnumeric
rhs_hurriesnumeric
rhs_assistsnumeric
rhs_stopsnumeric
assistsnumericTotal assists.
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
lhs_tacklesnumeric
lhs_missesnumeric

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

Example

pff_facet_prps()

Last validated n/a.

pff_facet_receiving_scheme

Facet report /receiving/scheme (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/receiving/scheme

Valid URL: https://premium.pff.com/api/v1/facet/receiving/scheme

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
man_contested_catch_ratenumeric
man_touchdownsnumeric
zone_targets_percentnumeric
man_interceptionsnumeric
zone_epanumeric
man_avg_depth_of_targetnumeric
zone_pass_blocksnumeric
zone_avoided_tacklesnumeric
man_targeted_qb_ratingnumeric
draft_seasonnumeric
zone_positive_epa_percentnumeric
man_targets_percentnumeric
man_yards_per_receptionnumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
man_drop_ratenumeric
zone_grades_pass_routenumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
zone_fumblesnumeric
man_pass_block_ratenumeric
zone_yardsnumeric
man_yprrnumeric
player_game_countnumeric
eligible_seasonnumeric
zone_dropsnumeric
zone_receptionsnumeric
man_pass_playsnumeric
man_epanumeric
zone_yards_per_receptionnumeric
man_contested_targetsnumeric
man_longestnumeric
zone_yards_after_catchnumeric
man_receptionsnumeric
man_avoided_tacklesnumeric
man_first_downsnumeric
base_targetsnumeric
zone_contested_catch_ratenumeric
zone_targeted_qb_ratingnumeric
man_routesnumeric
zone_grades_hands_dropnumeric
man_route_ratenumeric
zone_pass_block_ratenumeric
man_grades_pass_routenumeric
penaltiesnumericTotal number of penalties.
zone_first_downsnumeric
zone_yprrnumeric
man_dropsnumeric
zone_caught_percentnumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
man_fumblesnumeric
declined_penaltiesnumeric
man_yards_after_catchnumeric
man_yardsnumeric
zone_pass_playsnumeric
positioncharacterPrimary position as reported by NFL.com
man_targetsnumeric
man_grades_hands_dropnumeric
man_pass_blocksnumeric
zone_touchdownsnumeric
zone_route_ratenumeric
zone_yards_after_catch_per_receptionnumeric
zone_avg_depth_of_targetnumeric
playercharacterPlayer name
franchise_idnumericESPN franchise identifier.
zone_contested_targetsnumeric
zone_contested_receptionsnumeric
man_contested_receptionsnumeric
man_yards_after_catch_per_receptionnumeric
zone_targetsnumeric
zone_longestnumeric
man_caught_percentnumeric
zone_drop_ratenumeric
zone_interceptionsnumeric
man_positive_epa_percentnumeric
zone_routesnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters

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

Example

pff_facet_receiving_scheme()

Last validated n/a.

pff_facet_time_in_pockets

Facet report /signature/passing/time_in_pocket (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/signature/passing/time_in_pocket

Valid URL: https://premium.pff.com/api/v1/facet/signature/passing/time_in_pocket

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
more_btt_ratenumeric
more_grades_runnumeric
more_ypanumeric
more_passing_snapsnumeric
more_pressure_to_sack_ratenumeric
less_def_gen_pressuresnumeric
dropbacksnumeric
less_sack_percentnumeric
less_first_downsnumeric
less_ypanumeric
draft_seasonnumeric
more_grades_pass_routecharacter
less_pressure_to_sack_ratenumeric
less_aimed_passesnumeric
more_dropbacks_percentnumeric
less_positive_epa_percentnumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
avg_ttt_scramblesnumeric
more_yardsnumeric
more_accuracy_percentnumeric
less_attemptsnumeric
less_drop_ratenumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
more_turnover_worthy_playsnumeric
more_interceptionsnumeric
more_sack_percentnumeric
more_twp_ratenumeric
less_completionsnumeric
more_thrown_awaysnumeric
less_btt_ratenumeric
more_big_time_throwsnumeric
less_qb_ratingnumeric
less_hit_as_threwnumeric
more_attemptsnumeric
player_game_countnumeric
less_spikesnumeric
eligible_seasonnumeric
less_dropbacks_percentnumeric
more_qb_ratingnumeric
less_dropbacksnumeric
more_grades_hands_fumblenumeric
more_avg_depth_of_targetnumeric
less_scramblesnumeric
more_positive_epa_percentnumeric
less_sacksnumeric
less_grades_passnumeric
less_dropsnumeric
more_sacksnumeric
more_first_downsnumeric
less_big_time_throwsnumeric
avg_ttt_attemptsnumeric
more_aimed_passesnumeric
less_accuracy_percentnumeric
more_scramblesnumeric
less_epanumeric
more_spikesnumeric
less_grades_pass_routecharacter
less_grades_offensenumeric
avg_ttt_sacksnumeric
more_grades_offense_penaltynumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
less_batsnumeric
less_grades_runnumeric
positioncharacterPrimary position as reported by NFL.com
less_touchdownsnumeric
less_yardsnumeric
less_grades_run_blockcharacter
less_grades_hands_fumblenumeric
more_hit_as_threwnumeric
more_epanumeric
avg_time_to_thrownumericAverage time elapsed from the time of snap to throw on every pass attempt for a passer (sacks excluded).
less_turnover_worthy_playsnumeric
less_completion_percentnumeric
more_dropsnumeric
playercharacterPlayer name
more_touchdownsnumeric
franchise_idnumericESPN franchise identifier.
more_drop_ratenumeric
less_twp_ratenumeric
more_grades_offensenumeric
less_thrown_awaysnumeric
less_avg_depth_of_targetnumeric
less_avg_time_to_thrownumeric
less_grades_offense_penaltynumeric
less_interceptionsnumeric
more_def_gen_pressuresnumeric
more_avg_time_to_thrownumeric
more_dropbacksnumeric
more_grades_passnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
less_passing_snapsnumeric
more_completionsnumeric
more_grades_run_blockcharacter
more_batsnumeric
more_completion_percentnumeric
more_grades_hands_dropcharacter
less_grades_hands_dropcharacter
less_grades_pass_blockcharacter
more_grades_pass_blockcharacter
less_grades_screen_blockcharacter
more_grades_screen_blockcharacter
less_grades_defense_penaltycharacter
less_grades_coverage_defensecharacter
more_grades_defense_penaltycharacter
more_grades_defensecharacter
more_grades_coverage_defensecharacter
less_grades_defensecharacter
less_grades_overall_tacklecharacter
more_grades_pass_rush_defensecharacter
more_grades_run_defensecharacter
more_grades_tacklecharacter
less_grades_pass_rush_defensecharacter
less_grades_tacklecharacter
more_grades_overall_tacklecharacter
less_grades_run_defensecharacter

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

Example

pff_facet_time_in_pockets()

Last validated n/a.

pff_facet_receiving_concept

Facet report /receiving/concept (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/receiving/concept

Valid URL: https://premium.pff.com/api/v1/facet/receiving/concept

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
screen_caught_percentnumeric
screen_targeted_qb_ratingnumeric
slot_grades_pass_routenumeric
slot_avg_depth_of_targetnumeric
slot_positive_epa_percentnumeric
screen_yprrnumeric
draft_seasonnumeric
slot_routesnumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
screen_grades_hands_dropnumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
screen_contested_catch_ratenumeric
slot_yards_per_receptionnumeric
screen_interceptionsnumeric
slot_targets_percentnumeric
screen_longestnumeric
slot_avoided_tacklesnumeric
slot_yards_after_catchnumeric
slot_grades_hands_dropnumeric
player_game_countnumeric
screen_contested_targetsnumeric
eligible_seasonnumeric
screen_yards_after_catch_per_receptionnumeric
screen_yardsnumeric
slot_route_ratenumeric
screen_drop_ratenumeric
screen_epanumeric
screen_grades_pass_routenumeric
screen_dropsnumeric
screen_fumblesnumeric
slot_interceptionsnumeric
screen_yards_after_catchnumeric
screen_avg_depth_of_targetnumeric
screen_pass_block_ratenumeric
slot_pass_block_ratenumeric
slot_yprrnumeric
base_targetsnumeric
slot_longestnumeric
slot_dropsnumeric
screen_routesnumeric
slot_fumblesnumeric
penaltiesnumericTotal number of penalties.
slot_contested_catch_ratenumeric
slot_pass_playsnumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
declined_penaltiesnumeric
screen_positive_epa_percentnumeric
slot_first_downsnumeric
screen_route_ratenumeric
positioncharacterPrimary position as reported by NFL.com
screen_pass_blocksnumeric
slot_targetsnumeric
slot_pass_blocksnumeric
slot_receptionsnumeric
screen_first_downsnumeric
slot_caught_percentnumeric
screen_avoided_tacklesnumeric
playercharacterPlayer name
slot_epanumeric
slot_drop_ratenumeric
franchise_idnumericESPN franchise identifier.
slot_touchdownsnumeric
slot_yards_after_catch_per_receptionnumeric
screen_receptionsnumeric
slot_targeted_qb_ratingnumeric
slot_contested_targetsnumeric
screen_yards_per_receptionnumeric
slot_contested_receptionsnumeric
screen_pass_playsnumeric
screen_contested_receptionsnumeric
screen_touchdownsnumeric
screen_targetsnumeric
screen_targets_percentnumeric
slot_yardsnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters

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

Example

pff_facet_receiving_concept()

Last validated n/a.

pff_facet_special_teams_summary

Facet report /special/summary (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/special/summary

Valid URL: https://premium.pff.com/api/v1/facet/special/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
assistsnumericTotal assists.
declined_penaltiesnumeric
draft_seasonnumeric
eligible_seasonnumeric
franchise_idnumericESPN franchise identifier.
grades_fgep_kickernumeric
grades_kickoff_kickernumeric
grades_misc_stnumeric
grades_special_teams_penaltynumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
missed_tacklesnumeric
penaltiesnumericTotal number of penalties.
playercharacterPlayer name
player_game_countnumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
positioncharacterPrimary position as reported by NFL.com
snap_counts_field_goalnumeric
snap_counts_field_goal_blockingnumeric
snap_counts_kickoffnumeric
snap_counts_kickoff_returnnumeric
snap_counts_punt_coveragenumeric
snap_counts_punt_returnnumeric
tacklesnumericTeam tackles.
teamcharacterNFL team. Uses official abbreviations as per NFL.com
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
grades_fgep_defensenumeric
grades_fgep_offensenumeric
grades_long_snapnumeric
grades_punternumeric
grades_kick_returnnumeric
grades_punt_returnnumeric

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

Example

pff_facet_special_teams_summary()

Last validated n/a.

pff_facet_receiving_depth

Facet report /receiving/depth (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/receiving/depth

Valid URL: https://premium.pff.com/api/v1/facet/receiving/depth

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

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

col_nametypedescription
left_deep_route_ratenumeric
center_short_first_downsnumeric
center_short_routesnumeric
right_behind_los_positive_epa_percentnumeric
left_behind_los_yards_after_catchnumeric
center_behind_los_contested_targetsnumeric
right_short_routesnumeric
right_deep_pass_block_ratenumeric
medium_interceptionsnumeric
right_short_targets_percentnumeric
left_deep_contested_catch_ratenumeric
right_medium_grades_hands_dropnumeric
left_short_targeted_qb_ratingnumeric
right_medium_contested_catch_ratenumeric
short_targetsnumeric
deep_contested_catch_ratenumeric
center_behind_los_dropsnumeric
center_behind_los_interceptionsnumeric
left_behind_los_interceptionsnumeric
left_deep_first_downsnumeric
left_behind_los_contested_targetsnumeric
center_deep_avg_depth_of_targetnumeric
center_short_dropsnumeric
right_behind_los_targetsnumeric
right_behind_los_yards_after_catch_per_receptionnumeric
center_deep_first_downsnumeric
behind_los_yards_after_catch_per_receptionnumeric
right_deep_grades_pass_routenumeric
left_short_fumblesnumeric
right_short_positive_epa_percentnumeric
center_deep_pass_block_ratenumeric
left_behind_los_avoided_tacklesnumeric
center_short_longestnumeric
left_deep_drop_ratenumeric
center_short_contested_receptionsnumeric
left_deep_routesnumeric
deep_dropsnumeric
deep_contested_receptionsnumeric
center_behind_los_touchdownsnumeric
center_medium_targeted_qb_ratingnumeric
left_short_yards_per_receptionnumeric
deep_touchdownsnumeric
left_short_yprrnumeric
center_deep_drop_ratenumeric
center_behind_los_pass_playsnumeric
right_short_first_downsnumeric
right_behind_los_first_downsnumeric
right_behind_los_grades_pass_routenumeric
short_interceptionsnumeric
behind_los_routesnumeric
right_behind_los_contested_targetsnumeric
left_medium_grades_pass_routenumeric
right_short_contested_catch_ratenumeric
draft_seasonnumeric
center_short_grades_hands_dropnumeric
deep_receptionsnumeric
center_deep_pass_blocksnumeric
left_short_yards_after_catch_per_receptionnumeric
center_medium_avoided_tacklesnumeric
center_medium_grades_pass_routenumeric
center_behind_los_positive_epa_percentnumeric
medium_yards_after_catch_per_receptionnumeric
medium_receptionsnumeric
deep_pass_blocksnumeric
right_deep_yards_per_receptionnumeric
center_medium_longestnumeric
center_deep_contested_catch_ratenumeric
medium_epanumeric
left_short_route_ratenumeric
right_deep_grades_hands_dropnumeric
center_deep_targetsnumeric
short_contested_receptionsnumeric
center_deep_pass_playsnumeric
left_medium_routesnumeric
deep_yards_after_catch_per_receptionnumeric
center_deep_contested_receptionsnumeric
center_short_pass_blocksnumeric
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
deep_pass_block_ratenumeric
short_touchdownsnumeric
center_medium_dropsnumeric
left_short_pass_blocksnumeric
right_short_grades_pass_routenumeric
center_short_positive_epa_percentnumeric
deep_avg_depth_of_targetnumeric
deep_grades_hands_dropnumeric
center_behind_los_avg_depth_of_targetnumeric
left_deep_caught_percentnumeric
right_behind_los_contested_catch_ratenumeric
center_medium_route_ratenumeric
short_grades_pass_routenumeric
center_behind_los_contested_receptionsnumeric
center_short_receptionsnumeric
center_short_yprrnumeric
medium_pass_blocksnumeric
medium_yards_per_receptionnumeric
center_deep_yprrnumeric
right_deep_drop_ratenumeric
center_short_targetsnumeric
center_medium_pass_block_ratenumeric
left_behind_los_drop_ratenumeric
right_behind_los_targets_percentnumeric
short_contested_catch_ratenumeric
behind_los_fumblesnumeric
left_medium_drop_ratenumeric
left_medium_longestnumeric
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
medium_yprrnumeric
left_short_positive_epa_percentnumeric
center_behind_los_pass_block_ratenumeric
right_short_fumblesnumeric
right_deep_route_ratenumeric
right_short_pass_blocksnumeric
left_short_longestnumeric
medium_contested_targetsnumeric
behind_los_interceptionsnumeric
right_medium_targeted_qb_ratingnumeric
right_deep_dropsnumeric
right_short_route_ratenumeric
medium_grades_pass_routenumeric
right_deep_yardsnumeric
right_medium_contested_targetsnumeric
center_medium_targetsnumeric
right_short_avg_depth_of_targetnumeric
center_deep_longestnumeric
right_behind_los_yards_per_receptionnumeric
left_medium_pass_block_ratenumeric
right_deep_yards_after_catchnumeric
right_medium_receptionsnumeric
right_short_targeted_qb_ratingnumeric
left_deep_targets_percentnumeric
behind_los_pass_blocksnumeric
right_behind_los_touchdownsnumeric
right_medium_targetsnumeric
deep_routesnumeric
left_medium_yprrnumeric
deep_yards_per_receptionnumeric
center_behind_los_avoided_tacklesnumeric
left_deep_contested_targetsnumeric
medium_avg_depth_of_targetnumeric
short_route_ratenumeric
left_behind_los_positive_epa_percentnumeric
left_medium_touchdownsnumeric
deep_targets_percentnumeric
behind_los_targetsnumeric
center_short_yardsnumeric
center_medium_routesnumeric
center_behind_los_grades_pass_routenumeric
right_deep_yprrnumeric
center_deep_targeted_qb_ratingnumeric
left_deep_targeted_qb_ratingnumeric
deep_pass_playsnumeric
center_short_avg_depth_of_targetnumeric
right_short_yardsnumeric
left_medium_first_downsnumeric
right_medium_positive_epa_percentnumeric
left_medium_targeted_qb_ratingnumeric
right_short_contested_receptionsnumeric
right_deep_avoided_tacklesnumeric
right_medium_fumblesnumeric
right_behind_los_fumblesnumeric
center_deep_dropsnumeric
center_medium_avg_depth_of_targetnumeric
right_behind_los_pass_block_ratenumeric
left_short_yards_after_catchnumeric
right_behind_los_pass_blocksnumeric
left_behind_los_avg_depth_of_targetnumeric
center_medium_epanumeric
left_medium_targets_percentnumeric
left_behind_los_grades_pass_routenumeric
center_behind_los_yards_per_receptionnumeric
left_deep_targetsnumeric
short_contested_targetsnumeric
left_medium_contested_catch_ratenumeric
left_deep_yprrnumeric
right_medium_yards_after_catch_per_receptionnumeric
right_medium_longestnumeric
behind_los_drop_ratenumeric
right_behind_los_epanumeric
player_game_countnumeric
left_short_pass_playsnumeric
right_short_touchdownsnumeric
behind_los_first_downsnumeric
right_deep_receptionsnumeric
left_medium_pass_playsnumeric
eligible_seasonnumeric
center_behind_los_yardsnumeric
right_medium_pass_blocksnumeric
left_short_grades_pass_routenumeric
left_behind_los_targets_percentnumeric
behind_los_longestnumeric
right_medium_first_downsnumeric
center_deep_yards_after_catch_per_receptionnumeric
deep_contested_targetsnumeric
behind_los_avoided_tacklesnumeric
left_behind_los_receptionsnumeric
right_short_yards_after_catchnumeric
right_behind_los_yards_after_catchnumeric
right_short_pass_playsnumeric
right_deep_epanumeric
left_short_caught_percentnumeric
center_behind_los_contested_catch_ratenumeric
right_short_yards_after_catch_per_receptionnumeric
right_short_drop_ratenumeric
left_short_yardsnumeric
right_behind_los_avg_depth_of_targetnumeric
right_deep_first_downsnumeric
left_deep_positive_epa_percentnumeric
short_yards_after_catchnumeric
center_medium_yprrnumeric
short_pass_blocksnumeric
left_short_contested_receptionsnumeric
short_fumblesnumeric
left_short_pass_block_ratenumeric
center_deep_routesnumeric
left_medium_avoided_tacklesnumeric
left_behind_los_pass_playsnumeric
right_deep_touchdownsnumeric
center_medium_receptionsnumeric
left_behind_los_dropsnumeric
center_short_targets_percentnumeric
deep_epanumeric
medium_touchdownsnumeric
left_medium_route_ratenumeric
left_behind_los_grades_hands_dropnumeric
left_deep_fumblesnumeric
medium_avoided_tacklesnumeric
center_medium_contested_catch_ratenumeric
right_behind_los_routesnumeric
short_targets_percentnumeric
left_behind_los_yprrnumeric
medium_route_ratenumeric
left_short_first_downsnumeric
short_longestnumeric
right_behind_los_grades_hands_dropnumeric
behind_los_contested_targetsnumeric
right_behind_los_avoided_tacklesnumeric
right_deep_longestnumeric
right_deep_contested_targetsnumeric
right_deep_positive_epa_percentnumeric
right_behind_los_pass_playsnumeric
medium_contested_receptionsnumeric
short_targeted_qb_ratingnumeric
right_behind_los_interceptionsnumeric
behind_los_targets_percentnumeric
center_deep_yards_after_catchnumeric
behind_los_yardsnumeric
right_deep_targets_percentnumeric
left_medium_fumblesnumeric
short_receptionsnumeric
left_short_interceptionsnumeric
right_medium_interceptionsnumeric
left_behind_los_yardsnumeric
medium_first_downsnumeric
left_short_avg_depth_of_targetnumeric
right_medium_pass_block_ratenumeric
right_medium_targets_percentnumeric
left_behind_los_touchdownsnumeric
right_behind_los_drop_ratenumeric
right_deep_fumblesnumeric
left_deep_contested_receptionsnumeric
behind_los_dropsnumeric
short_yards_after_catch_per_receptionnumeric
medium_pass_playsnumeric
behind_los_pass_playsnumeric
left_deep_yardsnumeric
center_behind_los_longestnumeric
center_medium_grades_hands_dropnumeric
left_behind_los_longestnumeric
center_short_interceptionsnumeric
short_avg_depth_of_targetnumeric
deep_yprrnumeric
left_deep_touchdownsnumeric
base_targetsnumeric
deep_yardsnumeric
center_medium_yards_after_catchnumeric
left_medium_epanumeric
left_deep_avg_depth_of_targetnumeric
deep_first_downsnumeric
short_drop_ratenumeric
left_medium_positive_epa_percentnumeric
center_deep_touchdownsnumeric
right_behind_los_yprrnumeric
center_medium_pass_blocksnumeric
short_positive_epa_percentnumeric
medium_fumblesnumeric
center_medium_yards_after_catch_per_receptionnumeric
left_short_routesnumeric
behind_los_route_ratenumeric
behind_los_epanumeric
right_behind_los_contested_receptionsnumeric
right_medium_yards_after_catchnumeric
center_short_touchdownsnumeric
right_medium_dropsnumeric
left_behind_los_routesnumeric
left_deep_epanumeric
left_short_targetsnumeric
left_deep_pass_block_ratenumeric
right_deep_caught_percentnumeric
center_short_grades_pass_routenumeric
left_behind_los_fumblesnumeric
right_medium_touchdownsnumeric
center_short_fumblesnumeric
center_behind_los_routesnumeric
behind_los_receptionsnumeric
medium_targets_percentnumeric
left_medium_yardsnumeric
center_medium_touchdownsnumeric
medium_targeted_qb_ratingnumeric
center_short_drop_ratenumeric
penaltiesnumericTotal number of penalties.
short_pass_block_ratenumeric
right_deep_avg_depth_of_targetnumeric
center_deep_yardsnumeric
center_short_yards_after_catch_per_receptionnumeric
right_short_targetsnumeric
behind_los_avg_depth_of_targetnumeric
left_behind_los_contested_catch_ratenumeric
center_short_targeted_qb_ratingnumeric
left_behind_los_epanumeric
deep_route_ratenumeric
short_yprrnumeric
deep_caught_percentnumeric
center_medium_drop_ratenumeric
center_behind_los_yards_after_catchnumeric
medium_yardsnumeric
center_deep_avoided_tacklesnumeric
left_short_contested_targetsnumeric
center_behind_los_first_downsnumeric
center_medium_interceptionsnumeric
center_deep_yards_per_receptionnumeric
center_deep_contested_targetsnumeric
left_short_targets_percentnumeric
short_grades_hands_dropnumeric
right_deep_yards_after_catch_per_receptionnumeric
left_medium_contested_receptionsnumeric
center_short_yards_per_receptionnumeric
center_deep_grades_hands_dropnumeric
deep_longestnumeric
left_medium_yards_after_catch_per_receptionnumeric
right_short_interceptionsnumeric
center_short_caught_percentnumeric
left_deep_interceptionsnumeric
short_yards_per_receptionnumeric
teamcharacterNFL team. Uses official abbreviations as per NFL.com
center_short_avoided_tacklesnumeric
behind_los_yards_per_receptionnumeric
short_epanumeric
deep_drop_ratenumeric
left_deep_yards_per_receptionnumeric
right_short_yprrnumeric
declined_penaltiesnumeric
medium_longestnumeric
left_short_contested_catch_ratenumeric
right_medium_routesnumeric
left_short_receptionsnumeric
left_deep_yards_after_catch_per_receptionnumeric
deep_targetsnumeric
left_short_grades_hands_dropnumeric
right_short_epanumeric
left_behind_los_contested_receptionsnumeric
medium_targetsnumeric
behind_los_targeted_qb_ratingnumeric
center_short_contested_targetsnumeric
center_short_route_ratenumeric
right_medium_route_ratenumeric
left_short_epanumeric
left_deep_avoided_tacklesnumeric
center_behind_los_pass_blocksnumeric
deep_interceptionsnumeric
right_short_caught_percentnumeric
center_deep_caught_percentnumeric
center_medium_fumblesnumeric
behind_los_grades_hands_dropnumeric
left_behind_los_targetsnumeric
right_medium_yprrnumeric
right_short_receptionsnumeric
positioncharacterPrimary position as reported by NFL.com
right_short_contested_targetsnumeric
center_medium_yards_per_receptionnumeric
right_behind_los_yardsnumeric
center_behind_los_grades_hands_dropnumeric
right_behind_los_receptionsnumeric
left_medium_caught_percentnumeric
left_medium_dropsnumeric
short_avoided_tacklesnumeric
center_short_epanumeric
center_behind_los_targetsnumeric
left_deep_pass_blocksnumeric
left_short_dropsnumeric
medium_positive_epa_percentnumeric
center_deep_receptionsnumeric
right_medium_epanumeric
right_short_pass_block_ratenumeric
center_deep_route_ratenumeric
center_short_pass_playsnumeric
center_deep_interceptionsnumeric
left_medium_yards_after_catchnumeric
left_behind_los_pass_blocksnumeric
right_behind_los_longestnumeric
short_yardsnumeric
left_deep_receptionsnumeric
deep_grades_pass_routenumeric
left_medium_targetsnumeric
behind_los_grades_pass_routenumeric
right_deep_targeted_qb_ratingnumeric
behind_los_pass_block_ratenumeric
left_medium_pass_blocksnumeric
playercharacterPlayer name
left_medium_avg_depth_of_targetnumeric
deep_avoided_tacklesnumeric
center_behind_los_yprrnumeric
center_behind_los_epanumeric
right_behind_los_route_ratenumeric
center_deep_fumblesnumeric
left_medium_grades_hands_dropnumeric
right_medium_yardsnumeric
left_deep_yards_after_catchnumeric
left_deep_pass_playsnumeric
center_short_yards_after_catchnumeric
center_behind_los_route_ratenumeric
right_medium_drop_ratenumeric
medium_grades_hands_dropnumeric
right_deep_pass_blocksnumeric
medium_contested_catch_ratenumeric
franchise_idnumericESPN franchise identifier.
center_behind_los_caught_percentnumeric
right_behind_los_caught_percentnumeric
short_pass_playsnumeric
center_behind_los_targeted_qb_ratingnumeric
deep_targeted_qb_ratingnumeric
center_short_pass_block_ratenumeric
right_short_avoided_tacklesnumeric
left_short_drop_ratenumeric
left_medium_yards_per_receptionnumeric
left_medium_receptionsnumeric
right_medium_pass_playsnumeric
center_medium_contested_targetsnumeric
short_first_downsnumeric
center_medium_targets_percentnumeric
right_short_longestnumeric
left_deep_longestnumeric
right_short_dropsnumeric
right_medium_contested_receptionsnumeric
right_deep_contested_catch_ratenumeric
center_behind_los_receptionsnumeric
right_medium_caught_percentnumeric
right_deep_targetsnumeric
center_medium_positive_epa_percentnumeric
medium_dropsnumeric
left_deep_grades_hands_dropnumeric
behind_los_positive_epa_percentnumeric
left_short_avoided_tacklesnumeric
right_medium_grades_pass_routenumeric
right_short_grades_hands_dropnumeric
left_behind_los_yards_per_receptionnumeric
medium_yards_after_catchnumeric
center_medium_pass_playsnumeric
left_behind_los_caught_percentnumeric
left_medium_contested_targetsnumeric
center_medium_contested_receptionsnumeric
behind_los_contested_catch_ratenumeric
behind_los_yards_after_catchnumeric
left_deep_dropsnumeric
center_deep_positive_epa_percentnumeric
left_behind_los_yards_after_catch_per_receptionnumeric
right_deep_routesnumeric
center_deep_grades_pass_routenumeric
deep_yards_after_catchnumeric
center_behind_los_drop_ratenumeric
short_dropsnumeric
right_deep_contested_receptionsnumeric
left_behind_los_targeted_qb_ratingnumeric
right_medium_avg_depth_of_targetnumeric
right_medium_avoided_tacklesnumeric
center_medium_caught_percentnumeric
center_behind_los_fumblesnumeric
center_medium_first_downsnumeric
behind_los_caught_percentnumeric
short_routesnumeric
left_deep_grades_pass_routenumeric
medium_routesnumeric
medium_caught_percentnumeric
behind_los_contested_receptionsnumeric
behind_los_yprrnumeric
left_short_touchdownsnumeric
medium_drop_ratenumeric
player_idnumericPlayer ID (aka GSIS ID) as defined by nflreadr::load_rosters
left_behind_los_pass_block_ratenumeric
right_deep_pass_playsnumeric
short_caught_percentnumeric
right_medium_yards_per_receptionnumeric
center_medium_yardsnumeric
center_deep_epanumeric
left_medium_interceptionsnumeric
right_deep_interceptionsnumeric
deep_positive_epa_percentnumeric
deep_fumblesnumeric
center_short_contested_catch_ratenumeric
center_behind_los_targets_percentnumeric
right_short_yards_per_receptionnumeric
center_deep_targets_percentnumeric
center_behind_los_yards_after_catch_per_receptionnumeric
behind_los_touchdownsnumeric
medium_pass_block_ratenumeric
left_behind_los_route_ratenumeric
right_behind_los_targeted_qb_ratingnumeric
right_behind_los_dropsnumeric
left_behind_los_first_downsnumeric

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

Example

pff_facet_receiving_depth()

Last validated n/a.

pff_facet_receiving_coverage

Facet report /receiving/coverage (By Position leaderboard; add franchiseId for By Team, gameId for By Game)

Endpoint URL: GET https://premium.pff.com/api/v1/facet/receiving/coverage

Valid URL: https://premium.pff.com/api/v1/facet/receiving/coverage

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
franchiseIdfranchise_idYPFF franchise (team) id; filters a report 'By Team'.
gameIdgame_idYPFF game id; filters a report 'By Game'.
divisiondivisionYDivision filter (NCAA).

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_pff_report); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

pff_facet_receiving_coverage()

Last validated n/a.

pff_player_passing_summary

Player-detail report /passing/summary (per-week + totals for one player)

Endpoint URL: GET https://premium.pff.com/api/v1/player/passing/summary

Valid URL: https://premium.pff.com/api/v1/player/passing/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
player_idplayer_idYPFF player id (snake_case on the wire; matches the /players id).
careercareerYCareer-rollup flag ("true"/"false"); player-detail views only.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_pff_player_detail); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

pff_player_passing_summary()

Last validated n/a.

pff_player_rushing_summary

Player-detail report /rushing/summary (per-week + totals for one player)

Endpoint URL: GET https://premium.pff.com/api/v1/player/rushing/summary

Valid URL: https://premium.pff.com/api/v1/player/rushing/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
player_idplayer_idYPFF player id (snake_case on the wire; matches the /players id).
careercareerYCareer-rollup flag ("true"/"false"); player-detail views only.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_pff_player_detail); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

pff_player_rushing_summary()

Last validated n/a.

pff_player_receiving_summary

Player-detail report /receiving/summary (per-week + totals for one player)

Endpoint URL: GET https://premium.pff.com/api/v1/player/receiving/summary

Valid URL: https://premium.pff.com/api/v1/player/receiving/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
player_idplayer_idYPFF player id (snake_case on the wire; matches the /players id).
careercareerYCareer-rollup flag ("true"/"false"); player-detail views only.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_pff_player_detail); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

pff_player_receiving_summary()

Last validated n/a.

pff_player_defense_summary

Player-detail report /defense/summary (per-week + totals for one player)

Endpoint URL: GET https://premium.pff.com/api/v1/player/defense/summary

Valid URL: https://premium.pff.com/api/v1/player/defense/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
player_idplayer_idYPFF player id (snake_case on the wire; matches the /players id).
careercareerYCareer-rollup flag ("true"/"false"); player-detail views only.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_pff_player_detail); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

pff_player_defense_summary()

Last validated n/a.

pff_player_offense_summary

Player-detail report /offense/summary (per-week + totals for one player)

Endpoint URL: GET https://premium.pff.com/api/v1/player/offense/summary

Valid URL: https://premium.pff.com/api/v1/player/offense/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
player_idplayer_idYPFF player id (snake_case on the wire; matches the /players id).
careercareerYCareer-rollup flag ("true"/"false"); player-detail views only.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_pff_player_detail); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

pff_player_offense_summary()

Last validated n/a.

pff_player_snaps_summary

Player-detail report /snaps/summary (per-week + totals for one player)

Endpoint URL: GET https://premium.pff.com/api/v1/player/snaps/summary

Valid URL: https://premium.pff.com/api/v1/player/snaps/summary

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
player_idplayer_idYPFF player id (snake_case on the wire; matches the /players id).
careercareerYCareer-rollup flag ("true"/"false"); player-detail views only.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_pff_player_detail); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

pff_player_snaps_summary()

Last validated n/a.

pff_player_offense_blocking

Player-detail report /offense/blocking (per-week + totals for one player)

Endpoint URL: GET https://premium.pff.com/api/v1/player/offense/blocking

Valid URL: https://premium.pff.com/api/v1/player/offense/blocking

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
player_idplayer_idYPFF player id (snake_case on the wire; matches the /players id).
careercareerYCareer-rollup flag ("true"/"false"); player-detail views only.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_pff_player_detail); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

pff_player_offense_blocking()

Last validated n/a.

pff_leagues

Leagues + seasons + week groups (bootstrap)

Endpoint URL: GET https://premium.pff.com/api/v1/leagues

Valid URL: https://premium.pff.com/api/v1/leagues

API ParameterPythonPatternRequiredNullableDescription

Returns

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

col_nametypedescription
abbreviationcharacterShort abbreviation.
default_seasonnumeric
default_weeknumeric
default_week_groupcharacter
idnumericID of the player in the 'name' column.
namecharacterName, as reported by MFL but reordered into FirstName LastName instead of Last, First
seasonslistNBA seasons played.
slugcharacterURL-safe identifier.
week_groupslist
weekslist

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

Example

pff_leagues()

Last validated n/a.

pff_teams

Teams / franchise groups + games for a league-season

Endpoint URL: GET https://premium.pff.com/api/v1/teams

Valid URL: https://premium.pff.com/api/v1/teams

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).

Returns

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

col_nametypedescription
heirarchylist
idnumericID of the player in the 'name' column.
namecharacterName, as reported by MFL but reordered into FirstName LastName instead of Last, First
slugcharacterURL-safe identifier.

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

Example

pff_teams()

Last validated n/a.

pff_teams_overview

Team overview table (By Team landing)

Endpoint URL: GET https://premium.pff.com/api/v1/teams/overview

Valid URL: https://premium.pff.com/api/v1/teams/overview

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).

Returns

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

col_nametypedescription
abbreviationcharacterTeam abbreviation.
franchise_idnumericPFF franchise (team) id (integer join key).
grades_coverage_defensenumericPFF team coverage grade (0-100).
grades_defensenumericPFF team defense grade (0-100).
grades_misc_stnumeric
grades_offensenumericPFF team offense grade (0-100).
grades_overallnumeric
grades_passnumeric
grades_pass_blocknumeric
grades_pass_routenumeric
grades_pass_rush_defensenumeric
grades_runnumeric
grades_run_blocknumeric
grades_run_defensenumeric
grades_tacklenumeric
lossesnumericTotal losses.
namecharacterName, as reported by MFL but reordered into FirstName LastName instead of Last, First
points_allowednumericPoints for the opponent.
points_scorednumeric
tiesnumericNumber of ties in the series.
winsnumericTotal wins.

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

Example

pff_teams_overview()

Last validated n/a.

pff_games

Games list for league-season(-week)

Endpoint URL: GET https://premium.pff.com/api/v1/games

Valid URL: https://premium.pff.com/api/v1/games

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYSingle week number.

Returns

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

col_nametypedescription
away_franchise_idnumericPFF franchise id of the away team.
away_teamlistAway team object (JSON-stringified in the tidy frame).
has_statslogicalWhether PFF has published stats for the game.
home_franchise_idnumericPFF franchise id of the home team.
home_teamlistHome team object (JSON-stringified in the tidy frame).
idnumericPFF game id (integer join key).
leaguelistLeague slug.
league_idnumericPFF league id (integer).
lock_statuscharacterData lock/publish status for the game.
scorelistFinal score string.
seasonnumericSeason (starting year) of the game.
stadium_idnumericPFF stadium identifier for the game venue.
startcharacterKickoff timestamp (ISO 8601 string).
weeknumericWeek number of the game.

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

Example

pff_games()

Last validated n/a.

pff_players

Player search (name=) or lookup (id=)

Endpoint URL: GET https://premium.pff.com/api/v1/players

Valid URL: https://premium.pff.com/api/v1/players

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
namenameYPlayer-name search prefix.
ididYEntity id (player lookup).

Returns

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

col_nametypedescription
collegecharacterOfficial college (usually the last one attended)
current_classcharacter
current_eligible_yearnumeric
dobcharacterPlayer date of birth.
draftlist
first_namecharacterFirst name of player
heightnumericOfficial height, in inches
idnumericID of the player in the 'name' column.
jersey_numbercharacterJersey number. Often useful for joins by name/team/jersey.
last_namecharacterLast name of player
positioncharacterPrimary position as reported by NFL.com
speednumericSpeed.
teamlistNFL team. Uses official abbreviations as per NFL.com
weightnumericOfficial weight, in pounds

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

Example

pff_players()

Last validated n/a.

pff_player_seasons

Seasons a player has data for

Endpoint URL: GET https://premium.pff.com/api/v1/player/seasons

Valid URL: https://premium.pff.com/api/v1/player/seasons

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
player_idplayer_idYPFF player id (snake_case on the wire; matches the /players id).

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_pff_report); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

pff_player_seasons()

Last validated n/a.

pff_player_position_pivot

Positional-pivot export (JSON; UI also uses this for CSV download)

Endpoint URL: GET https://premium.pff.com/api/v1/player/position/pivot

Valid URL: https://premium.pff.com/api/v1/player/position/pivot

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules.
seasonseasonYSeason (starting year).
weekweekYWeek or week-group key (e.g. 'REG', a week number, or a range).
player_idplayer_idYPFF player id (snake_case on the wire; matches the /players id).

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_pff_report); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

pff_player_position_pivot()

Last validated n/a.