Skip to main content

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

pff_facet_run_defense_summary​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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
assistsFloat64Assisted tackles credited to the player.
avg_depth_of_tackleFloat64Average depth downfield, in yards, at which the player made his tackles on run plays.
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.
forced_fumblesFloat64Fumbles forced by the player.
franchise_idFloat64PFF franchise (team) id (integer join key).
grades_coverage_defenseFloat64PFF coverage grade, 0-100.
grades_defenseFloat64PFF overall defense grade, 0-100.
grades_defense_penaltyFloat64PFF defensive penalty grade, 0-100.
grades_pass_rush_defenseFloat64PFF pass-rush grade, 0-100.
grades_run_defenseFloat64PFF run-defense grade, 0-100.
grades_tackleFloat64PFF tackling grade, 0-100.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
missed_tackle_rateFloat64Share of tackle attempts the player missed.
missed_tacklesFloat64Missed tackles.
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_stop_oppFloat64Run-defense snaps PFF counts as run-stop opportunities.
snap_counts_runFloat64Run-defense snaps played.
stop_percentFloat64Percentage of run-stop opportunities converted into stops.
stopsFloat64Stops, PFF's tackles that constitute a failed play for the offense.
tacklesFloat64Tackles made by the player, as charted by PFF.
teamStringTeam abbreviation the player is credited to for the range.
team_nameStringTeam abbreviation the player is credited to for the range.

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_defense_summary()

pff_facet_field_goal_summary​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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_attemptsFloat64Field goals attempted from 20-29 yards.
pat_percentFloat64Extra-point percentage.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
forty_madeFloat64Field goals made from 40-49 yards.
team_nameStringTeam abbreviation the player is credited to for the range.
fifty_percentFloat64Field-goal percentage from 50 or more yards.
total_madeFloat64Total field goals made across all distances.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
one_madeFloat64Field goals made from 1-19 yards.
fifty_attemptsFloat64Field goals attempted from 50 or more yards.
forty_attemptsFloat64Field goals attempted from 40-49 yards.
player_game_countFloat64Number of games the player appeared in over the covered span.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
thirty_percentFloat64Field-goal percentage from 30-39 yards.
total_attemptsFloat64Total field goals attempted across all distances.
pat_attemptsFloat64Extra points attempted.
twenty_madeFloat64Field goals made from 20-29 yards.
one_attemptsFloat64Field goals attempted from 1-19 yards.
grades_fgep_kickerFloat64PFF field-goal and extra-point kicking grade, 0-100.
thirty_attemptsFloat64Field goals attempted from 30-39 yards.
penaltiesFloat64Penalties charged to the player over the covered span.
pat_madeFloat64Extra points made.
teamStringTeam abbreviation the player is credited to for the range.
declined_penaltiesFloat64Penalties committed by the player that were declined.
one_percentFloat64Field-goal percentage from 1-19 yards.
total_percentFloat64Overall field-goal percentage.
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).
twenty_percentFloat64Field-goal percentage from 20-29 yards.
forty_percentFloat64Field-goal percentage from 40-49 yards.
playerStringPlayer's display name as PFF lists it.
franchise_idFloat64PFF franchise (team) id (integer join key).
fifty_madeFloat64Field goals made from 50 or more yards.
thirty_madeFloat64Field goals made from 30-39 yards.
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_field_goal_summary()

pff_facet_coverage_summary​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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
targetsFloat64Passes thrown into the player's coverage (targets allowed).
yards_per_coverage_snapFloat64Receiving yards allowed per coverage snap.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
missed_tacklesFloat64Missed tackles.
catch_rateFloat64Completion percentage allowed on targets into the player's coverage.
team_nameStringTeam abbreviation the player is credited to for the range.
tacklesFloat64Tackles made by the player, as charted by PFF.
coverage_percentFloat64Share of pass-play snaps spent in coverage.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
dropped_intsFloat64Interception chances PFF charted as dropped.
player_game_countFloat64Number of games the player appeared in over the covered span.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
grades_tackleFloat64PFF tackling grade, 0-100.
yardsFloat64Receiving yards allowed in the player's coverage.
receptionsFloat64Receptions allowed in the player's coverage.
forced_incompletion_rateFloat64Share of targets into the player's coverage with a PFF-charted forced incompletion.
grades_coverage_defenseFloat64PFF coverage grade, 0-100.
interceptionsFloat64Interceptions made by the player in coverage.
snap_counts_coverageFloat64Coverage snaps played.
grades_run_defenseFloat64PFF run-defense grade, 0-100.
snap_counts_pass_playFloat64Pass-play snaps.
penaltiesFloat64Penalties charged to the player over the covered span.
forced_incompletesFloat64Incompletions forced by the player's coverage, per PFF charting.
teamStringTeam abbreviation the player is credited to for the range.
coverage_snaps_per_targetFloat64Coverage snaps played per target into the player's coverage.
stopsFloat64Stops, PFF's tackles that constitute a failed play for the offense.
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).
longestFloat64Longest completion allowed, in yards.
missed_tackle_rateFloat64Share of tackle attempts the player missed.
grades_defenseFloat64PFF overall defense grade, 0-100.
yards_per_receptionFloat64Average yards allowed per reception.
grades_defense_penaltyFloat64PFF defensive penalty grade, 0-100.
playerStringPlayer's display name as PFF lists it.
franchise_idFloat64PFF franchise (team) id (integer join key).
yards_after_catchFloat64Yards after the catch allowed in the player's coverage.
avg_depth_of_targetFloat64Average depth of targets into the player's coverage, in yards downfield.
pass_break_upsFloat64Passes broken up.
qb_rating_againstFloat64NFL passer rating allowed on targets into the player's coverage.
coverage_snaps_per_receptionFloat64Coverage snaps played per reception allowed.
assistsFloat64Assisted tackles credited to the player.
grades_pass_rush_defenseFloat64PFF pass-rush grade, 0-100.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
touchdownsFloat64Touchdowns allowed into the player's coverage.

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_coverage_summary()

pff_facet_kicking_summary​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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
attemptsFloat64Kickoffs by the player.
attempts_with_hangtimeFloat64Kickoffs with a PFF-recorded hangtime.
average_distanceFloat64Average kickoff distance in yards.
average_hangtimeFloat64Average kickoff hangtime in seconds.
average_starting_field_positionFloat64Average opponent starting field position following the player's kickoffs.
average_yards_per_returnFloat64Average return yards allowed per kickoff returned.
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.
fair_catchesFloat64Kickoffs fair-caught by the return team.
franchise_idFloat64PFF franchise (team) id (integer join key).
grades_kickoff_kickerFloat64PFF kickoff kicking grade, 0-100.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
kicked_yardsFloat64Total kickoff yards.
kicks_returnedFloat64Kickoffs returned by the opponent.
onside_kicksFloat64Onside kicks attempted.
penaltiesFloat64Penalties charged to the player over the covered span.
percent_returnedFloat64Percentage of the player's kickoffs that were returned.
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).
return_yardsFloat64Return yards gained by the return team on the player's kickoffs.
teamStringTeam abbreviation the player is credited to for the range.
team_nameStringTeam abbreviation the player is credited to for the range.
total_hangtimeFloat64Total kickoff hangtime in seconds.
touchbacksFloat64Kickoffs resulting in touchbacks.

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_kicking_summary()

pff_facet_blocking_summary​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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_blockFloat64PFF pass-blocking grade, 0-100.
grades_offenseFloat64PFF overall offense grade, 0-100.
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.
snap_counts_rgFloat64Snaps aligned at right guard.
team_nameStringTeam abbreviation the player is credited to for the range.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
snap_counts_ceFloat64Snaps aligned at center.
hits_allowedFloat64Quarterback hits allowed.
block_percentFloat64Share of offensive snaps spent blocking.
snap_counts_offenseFloat64Offensive snaps played.
player_game_countFloat64Number of games the player appeared in over the covered span.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
snap_counts_blockFloat64Total blocking snaps played.
hurries_allowedFloat64Quarterback hurries allowed.
grades_run_blockFloat64PFF run-blocking grade, 0-100.
snap_counts_run_blockFloat64Run-blocking snaps played.
pressures_allowedFloat64Total pressures allowed (sacks, hits, and hurries).
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.
snap_counts_teFloat64Snaps aligned at tight end.
snap_counts_rtFloat64Snaps aligned at right tackle.
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).
non_spike_pass_blockFloat64Pass-blocking snaps excluding spike plays.
snap_counts_ltFloat64Snaps aligned at left tackle.
playerStringPlayer's display name as PFF lists it.
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.
snap_counts_lgFloat64Snaps aligned at left guard.
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_blocking_summary()

pff_facet_defense_summary​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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
targetsFloat64Passes thrown into the player's coverage (targets allowed).
interception_touchdownsFloat64Touchdowns scored on interception returns.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
forced_fumblesFloat64Forced fumbles.
missed_tacklesFloat64Missed tackles.
catch_rateFloat64Completion percentage allowed on targets into the player's coverage.
team_nameStringTeam abbreviation the player is credited to for the range.
tacklesFloat64Total tackles made by the defender.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
snap_counts_offballFloat64Snaps aligned as an off-ball linebacker.
snap_counts_boxFloat64Snaps aligned in the box.
sacksFloat64Sacks credited.
snap_counts_pass_rushFloat64Pass-rush snaps played.
player_game_countFloat64Games with at least one qualifying snap in the requested range.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
snap_counts_dlFloat64Snaps aligned on the defensive line.
grades_tackleFloat64PFF tackling grade, 0-100.
yardsFloat64Receiving yards allowed in the player's coverage.
receptionsFloat64Receptions allowed in the player's coverage.
grades_coverage_defenseFloat64PFF coverage grade (0-100).
hurriesFloat64Quarterback hurries recorded.
interceptionsFloat64Interceptions made in coverage.
snap_counts_coverageFloat64Coverage snaps played.
snap_counts_dl_over_tFloat64Defensive-line snaps aligned head-up over the offensive tackle.
snap_counts_dl_a_gapFloat64Defensive-line snaps aligned in the A gap.
fumble_recoveriesFloat64Opponent fumbles recovered by the player.
grades_run_defenseFloat64PFF run-defense grade (0-100).
snap_counts_cornerFloat64Snaps aligned at outside cornerback.
hitsFloat64Quarterback hits recorded by the player.
penaltiesFloat64Penalties charged to the player over the covered span.
batted_passesFloat64Passes batted down at the line of scrimmage.
teamStringTeam abbreviation the player is credited to for the range.
stopsFloat64Tackles that constitute an offensive failure ("stops").
declined_penaltiesFloat64Penalties committed by the player that were declined.
total_pressuresFloat64Total quarterback pressures (sacks + hits + hurries).
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).
fumble_recovery_touchdownsFloat64Touchdowns scored on fumble recoveries.
longestFloat64Longest completion allowed, in yards.
snap_counts_slotFloat64Snaps aligned in the slot.
missed_tackle_rateFloat64Share of tackle attempts the player missed.
grades_defenseFloat64PFF overall defense grade (0-100).
yards_per_receptionFloat64Average yards allowed per reception.
grades_defense_penaltyFloat64PFF defensive penalty grade, 0-100.
safetiesFloat64Safeties recorded by the player.
playerStringPlayer's display name as PFF lists it.
franchise_idFloat64PFF franchise (team) id (integer join key).
snap_counts_defenseFloat64Total defensive snaps played.
yards_after_catchFloat64Yards after the catch allowed in the player's coverage.
snap_counts_dl_b_gapFloat64Defensive-line snaps aligned in the B gap.
pass_break_upsFloat64Passes broken up.
qb_rating_againstFloat64NFL passer rating allowed on targets into the player's coverage.
snap_counts_run_defenseFloat64Run-defense snaps played.
tackles_for_lossFloat64Tackles for loss made by the player.
assistsFloat64Assisted tackles.
grades_pass_rush_defenseFloat64PFF pass-rush grade, 0-100.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
snap_counts_fsFloat64Snaps aligned at free safety.
touchdownsFloat64Touchdowns allowed into the player's coverage.
snap_counts_dl_outside_tFloat64Defensive-line snaps aligned outside the offensive tackle.

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_defense_summary()

pff_facet_offense_summary​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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_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).
grades_hands_fumbleFloat64PFF ball-security (hands/fumble) grade, 0-100.
grades_offenseFloat64PFF overall offense grade (0-100).
grades_offense_penaltyFloat64PFF offensive penalty grade, 0-100.
grades_passFloat64PFF passing grade (0-100).
grades_runFloat64PFF rushing grade (0-100).
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_countFloat64Games with at least one qualifying snap in the requested range.
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).
snap_counts_passFloat64Pass-play snaps spent as the passer, rather than blocking or running a route.
snap_counts_pass_blockFloat64Pass-blocking snaps played.
snap_counts_pass_routeFloat64Snaps spent running a pass route.
snap_counts_runFloat64Run-play snaps spent as a runner, rather than run blocking.
snap_counts_run_blockFloat64Run-blocking snaps played.
snap_counts_totalFloat64Total offensive snaps played.
snap_counts_total_passFloat64Total pass-play snaps across passing, pass blocking, and route running.
snap_counts_total_runFloat64Total run-play snaps across rushing and run blocking.
teamStringTeam abbreviation the player is credited to for the range.
team_nameStringTeam abbreviation the player is credited to for the range.
grades_pass_blockFloat64PFF pass-blocking grade (0-100).
grades_pass_routeFloat64PFF receiving/route grade (0-100).

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_offense_summary()

pff_facet_passing_allowed_pressure​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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_percentFloat64Share of allowed pressures attributed to tight ends, expressed as a percentage.
draft_seasonFloat64NFL season (year) in which the player was drafted, per PFF player metadata.
pressures_ltFloat64Number of allowed pressures PFF attributes to left tackle.
pressures_rgFloat64Number of allowed pressures PFF attributes to right guard.
team_nameStringTeam abbreviation the player is credited to for the range.
lt_percentFloat64Share of allowed pressures attributed to left tackle, expressed as a percentage.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
hits_allowedFloat64Number of quarterback hits allowed on the player's dropbacks, as charted by PFF.
pressures_lgFloat64Number of allowed pressures PFF attributes to left guard.
player_game_countFloat64Number of games the player appeared in during the period covered.
eligible_seasonFloat64Season (year) of the player's NFL draft eligibility, per PFF player metadata.
hurries_allowedFloat64Number of hurries allowed on the player's dropbacks, as charted by PFF.
self_percentFloat64Share of allowed pressures attributed to the quarterback himself, expressed as a percentage.
pressures_rtFloat64Number of allowed pressures PFF attributes to right tackle.
pressures_allowedFloat64Total pressures allowed on the quarterback's dropbacks, as attributed by PFF.
pressures_ol_teFloat64Number of allowed pressures PFF attributes to the offensive line and tight ends combined.
pressures_ceFloat64Number of allowed pressures PFF attributes to center.
penaltiesFloat64Penalties charged to the player over the covered span.
sacks_allowedFloat64Sacks allowed on the quarterback's dropbacks, as attributed by PFF.
ol_te_percentFloat64Share of allowed pressures attributed to the offensive line and tight ends combined, expressed as a percentage.
allowed_pressure_dropbacksFloat64Number of dropbacks over which allowed pressures are attributed, from the PFF allowed-pressure facet.
pressures_otherFloat64Number of allowed pressures PFF attributes to other players outside the listed blocking positions.
teamStringTeam abbreviation the player is credited to for the range.
declined_penaltiesFloat64Number of declined penalties committed by the player.
ce_percentFloat64Share of allowed pressures attributed to center, expressed as a percentage.
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).
pressures_teFloat64Number of allowed pressures PFF attributes to tight ends.
pressures_selfFloat64Number of allowed pressures PFF attributes to the quarterback himself.
lg_percentFloat64Share of allowed pressures attributed to left guard, expressed as a percentage.
playerStringPlayer's display name as PFF lists it.
rt_percentFloat64Share of allowed pressures attributed to right tackle, expressed as a percentage.
franchise_idFloat64PFF franchise (team) id (integer join key).
other_percentFloat64Share of allowed pressures attributed to other players outside the listed blocking positions, expressed as a percentage.
pressures_offFloat64Number of allowed pressures PFF attributes to the offense without a specific blocker charged.
rg_percentFloat64Share of allowed pressures attributed to right guard, expressed as a percentage.
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_passing_allowed_pressure()

pff_facet_pass_rush_summary​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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_pressuresFloat64Total pressures generated (sacks, hits, and hurries) on PFF-designated true pass sets.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
true_pass_set_prpFloat64PFF Pass Rush Productivity rating, pressure generated per pass-rush snap weighted toward sacks on PFF-designated true pass sets.
true_pass_set_hurriesFloat64Quarterback hurries recorded on PFF-designated true pass sets.
team_nameStringTeam abbreviation the player is credited to for the range.
prpFloat64PFF Pass Rush Productivity rating, pressure generated per pass-rush snap weighted toward sacks.
true_pass_set_sacksFloat64Sacks recorded on PFF-designated true pass sets.
pass_rush_win_rateFloat64Percentage of pass-rush snaps with a PFF-charted pass-rush win.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
sacksFloat64Sacks recorded by the pass rusher.
snap_counts_pass_rushFloat64Pass-rush snaps played.
player_game_countFloat64Number of games the player appeared in over the covered span.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
true_pass_set_snap_counts_pass_playFloat64Pass-play snaps on PFF-designated true pass sets.
pass_rush_winsFloat64PFF-charted pass-rush wins.
hurriesFloat64Quarterback hurries recorded.
pass_rush_oppFloat64Pass-rush snaps PFF counts as pressure opportunities.
snap_counts_pass_playFloat64Pass-play snaps.
hitsFloat64Quarterback hits recorded by the pass rusher.
true_pass_set_pass_rush_win_rateFloat64Percentage of pass-rush snaps with a PFF-charted pass-rush win on PFF-designated true pass sets.
penaltiesFloat64Penalties charged to the player over the covered span.
batted_passesFloat64Passes batted down at the line of scrimmage.
true_pass_set_hitsFloat64Quarterback hits recorded on PFF-designated true pass sets.
true_pass_set_snap_counts_pass_rushFloat64Pass-rush snaps played on PFF-designated true pass sets.
teamStringTeam abbreviation the player is credited to for the range.
declined_penaltiesFloat64Penalties committed by the player that were declined.
true_pass_set_pass_rush_winsFloat64PFF-charted pass-rush wins on PFF-designated true pass sets.
total_pressuresFloat64Total pressures generated (sacks, hits, and hurries).
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_rush_defenseFloat64PFF pass-rush grade on PFF-designated true pass sets, 0-100.
true_pass_set_batted_passesFloat64Passes batted down at the line of scrimmage on PFF-designated true pass sets.
playerStringPlayer's display name as PFF lists it.
franchise_idFloat64PFF franchise (team) id (integer join key).
pass_rush_percentFloat64Share of pass-play snaps spent rushing the passer.
true_pass_set_pass_rush_oppFloat64Pass-rush snaps PFF counts as pressure opportunities on PFF-designated true pass sets.
true_pass_set_pass_rush_percentFloat64Share of pass-play snaps spent rushing the passer on PFF-designated true pass sets.
grades_pass_rush_defenseFloat64PFF pass-rush grade, 0-100.
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_rush_summary()