Skip to main content

NFL — PFF Premium Stats -- LEGACY (premium.pff.com, cookie auth; use the PFF Developer API) — Facet: run–punting

pff_facet_run_blocking​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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_penaltiesFloat64Penalties committed by the player that were declined.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
franchise_idFloat64PFF franchise (team) id (integer join key).
gap_grades_run_blockFloat64PFF run-blocking grade on gap-scheme runs, 0-100.
gap_run_block_percentFloat64Share of run-play snaps spent run blocking on gap-scheme runs.
gap_snap_counts_run_blockFloat64Run-blocking snaps played on gap-scheme runs.
gap_snap_counts_run_block_percentFloat64Share of the player's run-blocking snaps on gap-scheme runs.
gap_snap_counts_run_playFloat64Run-play snaps on gap-scheme runs.
grades_run_blockFloat64PFF run-blocking grade, 0-100.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
penaltiesFloat64Penalties charged to the player over the covered span.
playerStringPlayer's display name as PFF lists it.
player_game_countFloat64Number of games the player appeared in over the covered span.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
positionStringPFF position code the player is listed at (e.g. QB, HB, FB, WR, TE, T, G, C, ED, DI, LB, CB, S, K, P).
run_block_percentFloat64Share of run-play snaps spent run blocking.
snap_counts_run_blockFloat64Run-blocking snaps played.
snap_counts_run_playFloat64Run-play snaps.
teamStringTeam abbreviation the player is credited to for the range.
team_nameStringTeam abbreviation the player is credited to for the range.
zone_grades_run_blockFloat64PFF run-blocking grade on zone-scheme runs, 0-100.
zone_run_block_percentFloat64Share of run-play snaps spent run blocking on zone-scheme runs.
zone_snap_counts_run_blockFloat64Run-blocking snaps played on zone-scheme runs.
zone_snap_counts_run_block_percentFloat64Share of the player's run-blocking snaps on zone-scheme runs.
zone_snap_counts_run_playFloat64Run-play snaps on zone-scheme runs.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

pff_facet_run_blocking()

pff_facet_pass_blocking​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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_percentageFloat64Share of non-spike pass-play snaps spent pass blocking on PFF-designated true pass sets.
true_pass_set_pressures_allowedFloat64Total pressures allowed (sacks, hits, and hurries) on PFF-designated true pass sets.
grades_pass_blockFloat64PFF pass-blocking grade, 0-100.
true_pass_set_pass_block_percentFloat64Share of pass-play snaps spent pass blocking on PFF-designated true pass sets.
pbeFloat64PFF Pass Blocking Efficiency rating, pressures allowed per pass-blocking snap weighted toward sacks.
non_spike_pass_block_percentageFloat64Share of non-spike pass-play snaps spent pass blocking.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
team_nameStringTeam abbreviation the player is credited to for the range.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
hits_allowedFloat64Quarterback hits allowed.
true_pass_set_non_spike_pass_blockFloat64Pass-blocking snaps excluding spike plays on PFF-designated true pass sets.
player_game_countFloat64Number of games the player appeared in over the covered span.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
hurries_allowedFloat64Quarterback hurries allowed.
true_pass_set_hurries_allowedFloat64Quarterback hurries allowed on PFF-designated true pass sets.
true_pass_set_snap_counts_pass_playFloat64Pass-play snaps on PFF-designated true pass sets.
true_pass_set_hits_allowedFloat64Quarterback hits allowed on PFF-designated true pass sets.
pressures_allowedFloat64Total pressures allowed (sacks, hits, and hurries).
true_pass_set_pbeFloat64PFF Pass Blocking Efficiency rating, pressures allowed per pass-blocking snap weighted toward sacks on PFF-designated true pass sets.
snap_counts_pass_playFloat64Pass-play snaps.
penaltiesFloat64Penalties charged to the player over the covered span.
sacks_allowedFloat64Sacks allowed by the player in pass protection.
teamStringTeam abbreviation the player is credited to for the range.
declined_penaltiesFloat64Penalties committed by the player that were declined.
positionStringPFF position code the player is listed at (e.g. QB, HB, FB, WR, TE, T, G, C, ED, DI, LB, CB, S, K, P).
true_pass_set_grades_pass_blockFloat64PFF pass-blocking grade on PFF-designated true pass sets, 0-100.
non_spike_pass_blockFloat64Pass-blocking snaps excluding spike plays.
true_pass_set_snap_counts_pass_blockFloat64Pass-blocking snaps played on PFF-designated true pass sets.
playerStringPlayer's display name as PFF lists it.
true_pass_set_sacks_allowedFloat64Sacks allowed on PFF-designated true pass sets.
franchise_idFloat64PFF franchise (team) id (integer join key).
snap_counts_pass_blockFloat64Pass-blocking snaps played.
pass_block_percentFloat64Share of pass-play snaps spent pass blocking.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

pff_facet_pass_blocking()

pff_facet_passing_summary​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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_offenseFloat64PFF overall offense grade (0-100).
twp_rateFloat64Turnover-worthy-play rate.
btt_rateFloat64Big-time-throw rate.
spikesFloat64Clock-stopping spike plays.
dropbacksFloat64Total quarterback dropbacks.
thrown_awaysFloat64Passes intentionally thrown away.
draft_seasonFloat64Draft class (year) of the player.
team_nameStringTeam name/abbreviation the player is credited to for the range.
grades_passFloat64PFF passing grade (0-100).
hit_as_threwFloat64Plays where the quarterback was hit as he threw.
first_downsFloat64Passing first downs.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
sack_percentFloat64Sack rate (sacks per dropback).
batsFloat64Passes batted at the line.
sacksFloat64Times the passer was sacked.
player_game_countFloat64Games with at least one qualifying dropback in the requested range.
eligible_seasonFloat64First eligible season for the player.
completionsFloat64Completed passes by the passer.
yardsFloat64Total passing yards gained.
accuracy_percentFloat64Charted accuracy percentage.
scramblesFloat64Scramble plays.
interceptionsFloat64Interceptions thrown.
drop_rateFloat64Receiver drop rate on the quarterback's throws.
grades_runFloat64PFF rushing grade (0-100).
qb_ratingFloat64NFL passer rating.
completion_percentFloat64Completion percentage.
penaltiesFloat64Penalties charged.
attemptsFloat64Pass attempts thrown by the passer.
teamStringTeam abbreviation the player is credited to for the range.
declined_penaltiesFloat64Declined penalties.
passing_snapsFloat64Number of passing snaps played.
pressure_to_sack_rateFloat64Percentage of pressured dropbacks that ended in a sack.
ypaFloat64Yards gained per pass attempt.
dropsFloat64Passes dropped by the passer's receivers.
positionStringPFF position code the player is listed at (e.g. QB, HB, FB, WR, TE, T, G, C, ED, DI, LB, CB, S, K, P).
grades_hands_fumbleFloat64PFF hands (fumble) grade for the player, reflecting ball security (0-100).
avg_time_to_throwFloat64Average time to throw per dropback, in seconds from snap to release.
big_time_throwsFloat64Number of big-time throws, per PFF's highest-value, highest-difficulty throw designation.
playerStringPlayer's display name as PFF lists it.
positive_epa_percentFloat64Percentage of dropbacks with positive expected points added.
franchise_idFloat64PFF franchise (team) id (integer join key).
avg_depth_of_targetFloat64Average depth of target in air yards.
turnover_worthy_playsFloat64Number of turnover-worthy plays, plays PFF charts as deserving of a turnover.
epaFloat64Expected points added per play on the passer's dropbacks, as computed by PFF (an average such as 0.14, not a total).
aimed_passesFloat64Aimed passes: attempts excluding throwaways, spikes, batted passes and throws made while hit (the accuracy_percent denominator).
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
touchdownsFloat64Number of passing touchdowns thrown.
def_gen_pressuresFloat64Number of defense-generated pressures on the player's dropbacks, as charted by PFF.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

pff_facet_passing_summary()

pff_facet_punting_summary​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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
touchbacksFloat64Punts resulting in touchbacks.
attempts_with_hangtimeFloat64Punts with a PFF-recorded hangtime.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
percent_returnedFloat64Percentage of the player's punts that were returned.
fair_catchesFloat64Punts fair-caught by the return team.
team_nameStringTeam abbreviation the player is credited to for the range.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
player_game_countFloat64Number of games the player appeared in over the covered span.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
average_net_yardsFloat64Average net punting yards per attempt.
yardsFloat64Gross punt yards: the summed distance of the player's punts, before any return.
average_hangtimeFloat64Average punt hangtime in seconds.
total_net_yardsFloat64Total net punting yards.
penaltiesFloat64Penalties charged to the player over the covered span.
attemptsFloat64Punts by the player.
inside_twentiesFloat64Punts downed inside the opponent 20-yard line.
out_of_boundsFloat64Punts that went out of bounds.
teamStringTeam abbreviation the player is credited to for the range.
average_yards_per_returnFloat64Average return yards allowed per punt returned.
total_hangtimeFloat64Total punt hangtime in seconds.
declined_penaltiesFloat64Penalties committed by the player that were declined.
returnsFloat64Punts returned by the opponent.
positionStringPFF position code the player is listed at (e.g. QB, HB, FB, WR, TE, T, G, C, ED, DI, LB, CB, S, K, P).
longFloat64Longest punt in yards.
blocksFloat64Punts that were blocked.
average_yards_per_attemptFloat64Average gross punting yards per attempt.
playerStringPlayer's display name as PFF lists it.
franchise_idFloat64PFF franchise (team) id (integer join key).
grades_punterFloat64PFF punting grade, 0-100.
return_yardsFloat64Return yards gained by the return team on the player's punts.
downedsFloat64Punts downed by the coverage unit.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
snapsFloat64Punting snaps played.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

pff_facet_punting_summary()