Skip to main content

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

pff_facet_passing_pressure​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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_percentFloat64Percentage of pass attempts completed when not blitzed.
grades_offenseFloat64PFF overall offense grade for the player (0-100).
no_pressure_scramblesFloat64Number of scrambles from a clean pocket (no pressure).
blitz_touchdownsFloat64Number of passing touchdowns thrown when blitzed.
pressure_yardsFloat64Passing yards gained when under pressure.
no_pressure_spikesFloat64Number of clock-stopping spikes from a clean pocket (no pressure).
blitz_ypaFloat64Yards gained per pass attempt when blitzed.
no_blitz_grades_runFloat64PFF rushing grade for the player (0-100) when not blitzed.
blitz_qb_ratingFloat64Traditional NFL passer rating when blitzed.
no_pressure_thrown_awaysFloat64Number of intentional throwaways from a clean pocket (no pressure).
no_blitz_batsFloat64Number of pass attempts batted down at the line of scrimmage when not blitzed.
no_blitz_dropsFloat64Number of catchable passes dropped by receivers when not blitzed.
no_pressure_completion_percentFloat64Percentage of pass attempts completed from a clean pocket (no pressure).
blitz_aimed_passesFloat64Number of aimed passes (attempts excluding throwaways, spikes, batted passes and throws made while hit) when blitzed, as charted by PFF.
pressure_grades_runFloat64PFF rushing grade for the player (0-100) when under pressure.
no_blitz_sack_percentFloat64Percentage of dropbacks that ended in a sack when not blitzed.
no_pressure_batsFloat64Number of pass attempts batted down at the line of scrimmage from a clean pocket (no pressure).
pressure_completionsFloat64Number of completed passes when under pressure.
blitz_big_time_throwsFloat64Number of big-time throws when blitzed, per PFF's highest-value, highest-difficulty throw designation.
no_blitz_drop_rateFloat64Percentage of catchable passes dropped by receivers when not blitzed.
blitz_spikesFloat64Number of clock-stopping spikes when blitzed.
no_pressure_completionsFloat64Number of completed passes from a clean pocket (no pressure).
draft_seasonFloat64NFL season (year) in which the player was drafted, per PFF player metadata.
no_pressure_passing_snapsFloat64Number of passing snaps played from a clean pocket (no pressure).
no_blitz_first_downsFloat64Number of passing first downs gained when not blitzed.
blitz_avg_time_to_throwFloat64Average time to throw per dropback, in seconds from snap to release, when blitzed.
no_pressure_grades_hands_fumbleFloat64PFF hands (fumble) grade for the player, reflecting ball security (0-100) from a clean pocket (no pressure).
pressure_aimed_passesFloat64Number of aimed passes (attempts excluding throwaways, spikes, batted passes and throws made while hit) when under pressure, as charted by PFF.
blitz_sacksFloat64Number of sacks taken when blitzed.
no_pressure_interceptionsFloat64Number of passes intercepted from a clean pocket (no pressure).
team_nameStringTeam abbreviation the player is credited to for the range.
pressure_epaFloat64Total expected points added (EPA) on the player's dropbacks when under pressure.
blitz_completionsFloat64Number of completed passes when blitzed.
blitz_attemptsFloat64Number of pass attempts when blitzed.
pressure_twp_rateFloat64Turnover-worthy plays as a percentage of qualifying attempts when under pressure, per PFF charting.
pressure_sacksFloat64Number of sacks taken when under pressure.
no_blitz_pressure_to_sack_rateFloat64Percentage of pressured dropbacks that ended in a sack when not blitzed.
no_pressure_ypaFloat64Yards gained per pass attempt from a clean pocket (no pressure).
pressure_passing_snapsFloat64Number of passing snaps played when under pressure.
grades_passFloat64PFF passing grade (0-100).
pressure_batsFloat64Number of pass attempts batted down at the line of scrimmage when under pressure.
blitz_thrown_awaysFloat64Number of intentional throwaways when blitzed.
no_pressure_dropsFloat64Number of catchable passes dropped by receivers from a clean pocket (no pressure).
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
pressure_grades_offense_penaltyFloat64PFF offensive penalty grade for the player (0-100) when under pressure.
pressure_scramblesFloat64Number of scrambles when under pressure.
blitz_drop_rateFloat64Percentage of catchable passes dropped by receivers when blitzed.
pressure_grades_pass_routeFloat64PFF receiving (route) grade for the player (0-100) when under pressure.
blitz_completion_percentFloat64Percentage of pass attempts completed when blitzed.
no_pressure_first_downsFloat64Number of passing first downs gained from a clean pocket (no pressure).
blitz_grades_offense_penaltyFloat64PFF offensive penalty grade for the player (0-100) when blitzed.
no_blitz_epaFloat64Total expected points added (EPA) on the player's dropbacks when not blitzed.
blitz_interceptionsFloat64Number of passes intercepted when blitzed.
no_blitz_dropbacksFloat64Number of dropbacks when not blitzed.
no_blitz_grades_passFloat64PFF passing grade (0-100) when not blitzed.
no_blitz_scramblesFloat64Number of scrambles when not blitzed.
pressure_drop_rateFloat64Percentage of catchable passes dropped by receivers when under pressure.
no_blitz_yardsFloat64Passing yards gained when not blitzed.
base_dropbacksFloat64Number of dropbacks across all splits, the baseline total for this facet.
pressure_pressure_to_sack_rateFloat64Percentage of pressured dropbacks that ended in a sack, reported within the pressure split.
no_blitz_grades_hands_fumbleFloat64PFF hands (fumble) grade for the player, reflecting ball security (0-100) when not blitzed.
no_pressure_grades_offenseFloat64PFF overall offense grade for the player (0-100) from a clean pocket (no pressure).
no_pressure_avg_time_to_throwFloat64Average time to throw per dropback, in seconds from snap to release, from a clean pocket (no pressure).
pressure_dropbacksFloat64Number of dropbacks when under pressure.
no_blitz_grades_offense_penaltyFloat64PFF offensive penalty grade for the player (0-100) when not blitzed.
no_pressure_grades_runFloat64PFF rushing grade for the player (0-100) from a clean pocket (no pressure).
player_game_countFloat64Number of games the player appeared in during the period covered.
blitz_turnover_worthy_playsFloat64Number of turnover-worthy plays when blitzed, plays PFF charts as deserving of a turnover.
no_blitz_touchdownsFloat64Number of passing touchdowns thrown when not blitzed.
no_blitz_avg_depth_of_targetFloat64Average depth of target in air yards when not blitzed.
no_pressure_dropbacks_percentFloat64Share of the player's total dropbacks that came from a clean pocket (no pressure), expressed as a percentage.
blitz_grades_passFloat64PFF passing grade (0-100) when blitzed.
eligible_seasonFloat64Season (year) of the player's NFL draft eligibility, per PFF player metadata.
blitz_avg_depth_of_targetFloat64Average depth of target in air yards when blitzed.
no_blitz_spikesFloat64Number of clock-stopping spikes when not blitzed.
no_pressure_dropbacksFloat64Number of dropbacks from a clean pocket (no pressure).
blitz_btt_rateFloat64Big-time throws as a percentage of qualifying attempts when blitzed, per PFF charting.
blitz_positive_epa_percentFloat64Percentage of dropbacks with positive expected points added when blitzed.
no_pressure_btt_rateFloat64Big-time throws as a percentage of qualifying attempts from a clean pocket (no pressure), per PFF charting.
no_pressure_drop_rateFloat64Percentage of catchable passes dropped by receivers from a clean pocket (no pressure).
no_blitz_turnover_worthy_playsFloat64Number of turnover-worthy plays when not blitzed, plays PFF charts as deserving of a turnover.
pressure_positive_epa_percentFloat64Percentage of dropbacks with positive expected points added when under pressure.
blitz_first_downsFloat64Number of passing first downs gained when blitzed.
no_blitz_dropbacks_percentFloat64Share of the player's total dropbacks that came when not blitzed, expressed as a percentage.
pressure_turnover_worthy_playsFloat64Number of turnover-worthy plays when under pressure, plays PFF charts as deserving of a turnover.
no_pressure_epaFloat64Total expected points added (EPA) on the player's dropbacks from a clean pocket (no pressure).
no_blitz_avg_time_to_throwFloat64Average time to throw per dropback, in seconds from snap to release, when not blitzed.
no_blitz_positive_epa_percentFloat64Percentage of dropbacks with positive expected points added when not blitzed.
pressure_btt_rateFloat64Big-time throws as a percentage of qualifying attempts when under pressure, per PFF charting.
no_pressure_aimed_passesFloat64Number of aimed passes (attempts excluding throwaways, spikes, batted passes and throws made while hit) from a clean pocket (no pressure), as charted by PFF.
pressure_dropbacks_percentFloat64Share of the player's total dropbacks that came when under pressure, expressed as a percentage.
grades_runFloat64PFF rushing grade for the player (0-100).
no_pressure_def_gen_pressuresFloat64Number of defense-generated pressures on the player's dropbacks from a clean pocket (no pressure), as charted by PFF.
pressure_grades_offenseFloat64PFF overall offense grade for the player (0-100) when under pressure.
pressure_completion_percentFloat64Percentage of pass attempts completed when under pressure.
pressure_avg_depth_of_targetFloat64Average depth of target in air yards when under pressure.
blitz_epaFloat64Total expected points added (EPA) on the player's dropbacks when blitzed.
pressure_dropsFloat64Number of catchable passes dropped by receivers when under pressure.
no_blitz_def_gen_pressuresFloat64Number of defense-generated pressures on the player's dropbacks when not blitzed, as charted by PFF.
pressure_attemptsFloat64Number of pass attempts when under pressure.
pressure_big_time_throwsFloat64Number of big-time throws when under pressure, per PFF's highest-value, highest-difficulty throw designation.
no_blitz_thrown_awaysFloat64Number of intentional throwaways when not blitzed.
blitz_dropsFloat64Number of catchable passes dropped by receivers when blitzed.
no_pressure_touchdownsFloat64Number of passing touchdowns thrown from a clean pocket (no pressure).
no_pressure_sacksFloat64Number of sacks taken from a clean pocket (no pressure).
blitz_sack_percentFloat64Percentage of dropbacks that ended in a sack when blitzed.
pressure_sack_percentFloat64Percentage of dropbacks that ended in a sack when under pressure.
penaltiesFloat64Penalties charged to the player over the covered span.
no_pressure_attemptsFloat64Number of pass attempts from a clean pocket (no pressure).
no_blitz_grades_offenseFloat64PFF overall offense grade for the player (0-100) when not blitzed.
blitz_scramblesFloat64Number of scrambles when blitzed.
blitz_dropbacks_percentFloat64Share of the player's total dropbacks that came when blitzed, expressed as a percentage.
no_pressure_qb_ratingFloat64Traditional NFL passer rating from a clean pocket (no pressure).
no_blitz_passing_snapsFloat64Number of passing snaps played when not blitzed.
no_blitz_aimed_passesFloat64Number of aimed passes (attempts excluding throwaways, spikes, batted passes and throws made while hit) when not blitzed, as charted by PFF.
blitz_yardsFloat64Passing yards gained when blitzed.
teamStringTeam abbreviation the player is credited to for the range.
no_blitz_attemptsFloat64Number of pass attempts when not blitzed.
pressure_accuracy_percentFloat64Percentage of aimed passes charted as accurate by PFF when under pressure.
no_blitz_hit_as_threwFloat64Number of attempts on which the passer was hit as he threw when not blitzed, as charted by PFF.
pressure_hit_as_threwFloat64Number of attempts on which the passer was hit as he threw when under pressure, as charted by PFF.
blitz_pressure_to_sack_rateFloat64Percentage of pressured dropbacks that ended in a sack when blitzed.
declined_penaltiesFloat64Number of declined penalties committed by the player.
no_blitz_btt_rateFloat64Big-time throws as a percentage of qualifying attempts when not blitzed, per PFF charting.
no_blitz_ypaFloat64Yards gained per pass attempt when not blitzed.
blitz_grades_runFloat64PFF rushing grade for the player (0-100) when blitzed.
pressure_interceptionsFloat64Number of passes intercepted when under pressure.
blitz_grades_hands_fumbleFloat64PFF hands (fumble) grade for the player, reflecting ball security (0-100) when blitzed.
no_pressure_grades_offense_penaltyFloat64PFF offensive penalty grade for the player (0-100) from a clean pocket (no pressure).
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).
blitz_grades_offenseFloat64PFF overall offense grade for the player (0-100) when blitzed.
grades_hands_fumbleFloat64PFF hands (fumble) grade for the player, reflecting ball security (0-100).
pressure_def_gen_pressuresFloat64Number of defense-generated pressures on the player's dropbacks when under pressure, as charted by PFF.
pressure_grades_passFloat64PFF passing grade (0-100) when under pressure.
no_blitz_qb_ratingFloat64Traditional NFL passer rating when not blitzed.
blitz_hit_as_threwFloat64Number of attempts on which the passer was hit as he threw when blitzed, as charted by PFF.
pressure_ypaFloat64Yards gained per pass attempt when under pressure.
blitz_grades_pass_routeFloat64PFF receiving (route) grade for the player (0-100) when blitzed.
pressure_avg_time_to_throwFloat64Average time to throw per dropback, in seconds from snap to release, when under pressure.
no_blitz_completionsFloat64Number of completed passes when not blitzed.
no_pressure_grades_pass_routeFloat64PFF receiving (route) grade for the player (0-100) from a clean pocket (no pressure).
no_pressure_sack_percentFloat64Percentage of dropbacks that ended in a sack from a clean pocket (no pressure).
playerStringPlayer's display name as PFF lists it.
no_blitz_accuracy_percentFloat64Percentage of aimed passes charted as accurate by PFF when not blitzed.
no_pressure_pressure_to_sack_rateStringPressure-to-sack rate as reported within the no-pressure split of the PFF passing-pressure facet.
no_pressure_turnover_worthy_playsFloat64Number of turnover-worthy plays from a clean pocket (no pressure), plays PFF charts as deserving of a turnover.
pressure_first_downsFloat64Number of passing first downs gained when under pressure.
blitz_passing_snapsFloat64Number of passing snaps played when blitzed.
franchise_idFloat64PFF franchise (team) id (integer join key).
no_pressure_twp_rateFloat64Turnover-worthy plays as a percentage of qualifying attempts from a clean pocket (no pressure), per PFF charting.
no_blitz_sacksFloat64Number of sacks taken when not blitzed.
no_blitz_grades_pass_routeFloat64PFF receiving (route) grade for the player (0-100) when not blitzed.
no_pressure_accuracy_percentFloat64Percentage of aimed passes charted as accurate by PFF from a clean pocket (no pressure).
no_blitz_twp_rateFloat64Turnover-worthy plays as a percentage of qualifying attempts when not blitzed, per PFF charting.
no_pressure_hit_as_threwFloat64Number of attempts on which the passer was hit as he threw from a clean pocket (no pressure), as charted by PFF.
no_pressure_grades_passFloat64PFF passing grade (0-100) from a clean pocket (no pressure).
no_pressure_positive_epa_percentFloat64Percentage of dropbacks with positive expected points added from a clean pocket (no pressure).
pressure_spikesFloat64Number of clock-stopping spikes when under pressure.
pressure_grades_hands_fumbleFloat64PFF hands (fumble) grade for the player, reflecting ball security (0-100) when under pressure.
pressure_qb_ratingFloat64Traditional NFL passer rating when under pressure.
blitz_batsFloat64Number of pass attempts batted down at the line of scrimmage when blitzed.
pressure_touchdownsFloat64Number of passing touchdowns thrown when under pressure.
pressure_thrown_awaysFloat64Number of intentional throwaways when under pressure.
no_blitz_interceptionsFloat64Number of passes intercepted when not blitzed.
blitz_dropbacksFloat64Number of dropbacks when blitzed.
blitz_def_gen_pressuresFloat64Number of defense-generated pressures on the player's dropbacks when blitzed, as charted by PFF.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
no_blitz_big_time_throwsFloat64Number of big-time throws when not blitzed, per PFF's highest-value, highest-difficulty throw designation.
no_pressure_avg_depth_of_targetFloat64Average depth of target in air yards from a clean pocket (no pressure).
no_pressure_yardsFloat64Passing yards gained from a clean pocket (no pressure).
blitz_twp_rateFloat64Turnover-worthy plays as a percentage of qualifying attempts when blitzed, per PFF charting.
blitz_accuracy_percentFloat64Percentage of aimed passes charted as accurate by PFF when blitzed.
no_pressure_big_time_throwsFloat64Number of big-time throws from a clean pocket (no pressure), per PFF's highest-value, highest-difficulty throw designation.
no_blitz_grades_pass_blockFloat64PFF pass-blocking grade for the player (0-100) when not blitzed.
blitz_grades_pass_blockFloat64PFF pass-blocking grade for the player (0-100) when blitzed.
no_pressure_grades_pass_blockFloat64PFF pass-blocking grade for the player (0-100) from a clean pocket (no pressure).
pressure_grades_pass_blockFloat64PFF pass-blocking grade for the player (0-100) when under pressure.
no_pressure_grades_hands_dropFloat64PFF hands (drop) grade for the player (0-100) from a clean pocket (no pressure).
blitz_grades_hands_dropFloat64PFF hands (drop) grade for the player (0-100) when blitzed.
pressure_grades_hands_dropFloat64PFF hands (drop) grade for the player (0-100) when under pressure.
no_blitz_grades_hands_dropFloat64PFF hands (drop) grade for the player (0-100) when not blitzed.
blitz_grades_run_blockFloat64PFF run-blocking grade for the player (0-100) when blitzed.
no_pressure_grades_run_blockFloat64PFF run-blocking grade for the player (0-100) from a clean pocket (no pressure).
no_blitz_grades_run_blockFloat64PFF run-blocking grade for the player (0-100) when not blitzed.
blitz_grades_screen_blockFloat64PFF screen-blocking grade for the player (0-100) when blitzed.
pressure_grades_screen_blockFloat64PFF screen-blocking grade for the player (0-100) when under pressure.
no_blitz_grades_screen_blockFloat64PFF screen-blocking grade for the player (0-100) when not blitzed.
pressure_grades_run_blockFloat64PFF run-blocking grade for the player (0-100) when under pressure.
no_pressure_grades_screen_blockFloat64PFF screen-blocking grade for the player (0-100) from a clean pocket (no pressure).
pressure_grades_coverage_defenseFloat64PFF coverage grade for the player (0-100) when under pressure.
pressure_grades_defenseFloat64PFF overall defense grade for the player (0-100) when under pressure.
no_blitz_grades_defenseFloat64PFF overall defense grade for the player (0-100) when not blitzed.
no_blitz_grades_defense_penaltyFloat64PFF defensive penalty grade for the player (0-100) when not blitzed.
blitz_grades_coverage_defenseFloat64PFF coverage grade for the player (0-100) when blitzed.
no_pressure_grades_defenseFloat64PFF overall defense grade for the player (0-100) from a clean pocket (no pressure).
no_pressure_grades_defense_penaltyFloat64PFF defensive penalty grade for the player (0-100) from a clean pocket (no pressure).
no_blitz_grades_coverage_defenseFloat64PFF coverage grade for the player (0-100) when not blitzed.
blitz_grades_defenseFloat64PFF overall defense grade for the player (0-100) when blitzed.
blitz_grades_defense_penaltyFloat64PFF defensive penalty grade for the player (0-100) when blitzed.
no_pressure_grades_coverage_defenseFloat64PFF coverage grade for the player (0-100) from a clean pocket (no pressure).
pressure_grades_defense_penaltyFloat64PFF defensive penalty grade for the player (0-100) when under pressure.
pressure_grades_pass_rush_defenseFloat64PFF pass-rush grade for the player (0-100) when under pressure.
blitz_grades_pass_rush_defenseFloat64PFF pass-rush grade for the player (0-100) when blitzed.
no_pressure_grades_tackleFloat64PFF tackling grade for the player (0-100) from a clean pocket (no pressure).
blitz_grades_tackleFloat64PFF tackling grade for the player (0-100) when blitzed.
blitz_grades_overall_tackleFloat64PFF overall tackling grade for the player (0-100) when blitzed.
no_pressure_grades_pass_rush_defenseFloat64PFF pass-rush grade for the player (0-100) from a clean pocket (no pressure).
pressure_grades_overall_tackleFloat64PFF overall tackling grade for the player (0-100) when under pressure.
no_blitz_grades_overall_tackleFloat64PFF overall tackling grade for the player (0-100) when not blitzed.
pressure_grades_tackleFloat64PFF tackling grade for the player (0-100) when under pressure.
no_blitz_grades_pass_rush_defenseStringPFF pass-rush grade for the player (0-100) when not blitzed.
no_pressure_grades_overall_tackleFloat64PFF overall tackling grade for the player (0-100) from a clean pocket (no pressure).
no_blitz_grades_tackleFloat64PFF tackling grade for the player (0-100) when not blitzed.

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

pff_facet_receiving_summary​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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
targetsFloat64Times targeted.
grades_pass_blockFloat64PFF pass-blocking grade, 0-100.
grades_offenseFloat64PFF overall offense grade (0-100).
yards_after_catch_per_receptionFloat64Average yards after the catch per reception.
grades_pass_routeFloat64PFF receiving/route grade (0-100).
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
team_nameStringTeam abbreviation the player is credited to for the range.
yprrFloat64Yards per route run.
wide_snapsFloat64Receiving snaps aligned out wide.
fumblesFloat64Fumbles by the player after the catch.
first_downsFloat64Receptions that converted a first down.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
inline_snapsFloat64Receiving snaps aligned inline, tight to the formation.
contested_targetsFloat64Contested targets.
player_game_countFloat64Games with at least one qualifying snap in the requested range.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
inline_rateFloat64Share of receiving snaps aligned inline, tight to the formation.
contested_catch_rateFloat64Percentage of PFF-charted contested targets caught.
yardsFloat64Receiving yards.
receptionsFloat64Passes caught by the receiver.
targeted_qb_ratingFloat64NFL passer rating on throws targeting the player.
interceptionsFloat64Interceptions on passes targeting the player.
caught_percentFloat64Percentage of targets caught.
drop_rateFloat64Share of catchable targets the player dropped.
grades_hands_dropFloat64PFF hands/drop grade (0-100).
slot_rateFloat64Share of receiving snaps aligned in the slot.
slot_snapsFloat64Receiving snaps aligned in the slot.
penaltiesFloat64Penalties charged to the player over the covered span.
wide_rateFloat64Share of receiving snaps aligned out wide.
pass_block_rateFloat64Share of pass-play snaps spent pass blocking.
teamStringTeam abbreviation the player is credited to for the range.
declined_penaltiesFloat64Penalties committed by the player that were declined.
route_rateFloat64Share of pass-play snaps on which the player ran a route.
dropsFloat64Dropped passes.
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 ball-security (hands/fumble) grade, 0-100.
longestFloat64Longest reception in yards.
pass_blocksFloat64Pass-play snaps spent pass blocking.
routesFloat64Pass routes run by the receiver.
pass_playsFloat64Pass-play snaps.
yards_per_receptionFloat64Average yards per reception.
playerStringPlayer's display name as PFF lists it.
positive_epa_percentFloat64Percentage of the receiver's plays with an EPA value (in practice their routes run) producing positive expected points added.
franchise_idFloat64PFF franchise (team) id (integer join key).
contested_receptionsFloat64Contested catches made.
yards_after_catchFloat64Yards after the catch.
avg_depth_of_targetFloat64Average depth of target in yards downfield.
epaFloat64Expected points added per target to the player, as computed by PFF (an average such as -0.27, not a total).
avoided_tacklesFloat64Tackles avoided after the catch.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
touchdownsFloat64Receiving touchdowns.

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

pff_facet_return_summary​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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_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_kick_returnFloat64PFF kickoff-return grade, 0-100.
grades_returnFloat64PFF overall return grade, 0-100.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
kickoff_attemptsFloat64Kickoff returns attempted.
kickoff_fair_catchesFloat64Kickoffs fair-caught by the player.
kickoff_longFloat64Longest kickoff return in yards.
kickoff_muffed_returnsFloat64Kickoff returns the player muffed.
kickoff_touchdownsFloat64Kickoff returns scoring a touchdown.
kickoff_yardsFloat64Total kickoff-return yards.
kickoff_ypaFloat64Average yards per kickoff return.
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).
punt_attemptsFloat64Punt returns attempted.
punt_fair_catchesFloat64Punts fair-caught by the player.
punt_longFloat64Longest punt return in yards.
punt_muffed_returnsFloat64Punt returns the player muffed.
punt_touchdownsFloat64Punt returns scoring a touchdown.
punt_yardsFloat64Total punt-return yards.
punt_ypaFloat64Average yards per punt return.
teamStringTeam abbreviation the player is credited to for the range.
team_nameStringTeam abbreviation the player is credited to for the range.
total_attemptsFloat64Total return attempts, kickoffs and punts combined.
grades_punt_returnFloat64PFF punt-return 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_return_summary()

pff_facet_rushing_direction_stats​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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
directionsListNested per-direction rushing splits (attempts and results by run direction) as returned by the PFF API.
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).
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
playerStringPlayer's display name as PFF lists it.
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).
teamStringTeam abbreviation the player is credited to for the range.
team_nameStringTeam abbreviation the player is credited to for the range.
total_attemptsFloat64Total rushing attempts across all run directions.

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

pff_facet_receiving_coverage_stats​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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.

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

pff_facet_rushing_summary​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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
targetsFloat64Passes thrown to the ball carrier (targets).
grades_pass_blockFloat64PFF pass-blocking grade, 0-100.
grades_offenseFloat64PFF overall offense grade (0-100).
yards_after_contactFloat64Yards after contact.
explosiveFloat64Runs PFF designates as explosive.
grades_pass_routeFloat64PFF route-running (receiving) grade, 0-100.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
elu_rush_mtfFloat64Missed tackles forced as a rusher, an input to PFF's elusive rating.
breakaway_attemptsFloat64Runs of 15 or more yards, PFF's breakaway designation.
designed_yardsFloat64Rushing yards gained on designed runs, excluding scrambles.
team_nameStringTeam abbreviation the player is credited to for the range.
yprrFloat64Yards per route run.
breakaway_percentFloat64Share of rushing yards gained on breakaway runs of 15 or more yards.
fumblesFloat64Fumbles by the ball carrier.
first_downsFloat64Rushing first downs.
elusive_ratingFloat64PFF elusive rating.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
breakaway_yardsFloat64Breakaway (long-run) yards.
player_game_countFloat64Games with at least one qualifying snap in the requested range.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
total_touchesFloat64Combined carries and receptions.
scramble_yardsFloat64Rushing yards gained on scrambles.
yco_attemptFloat64Average yards after contact per rushing attempt.
yardsFloat64Total rushing yards gained.
grades_run_blockFloat64PFF run-blocking grade, 0-100.
receptionsFloat64Passes caught by the ball carrier.
zone_attemptsFloat64Rushing attempts on zone-scheme runs.
scramblesFloat64Quarterback scrambles.
grades_runFloat64PFF rushing grade (0-100).
penaltiesFloat64Penalties charged to the player over the covered span.
attemptsFloat64Rushing attempts (carries) by the runner.
elu_ycoFloat64Yards-after-contact component used in PFF's elusive rating.
elu_recv_mtfFloat64Missed tackles forced as a receiver, an input to PFF's elusive rating.
teamStringTeam abbreviation the player is credited to for the range.
declined_penaltiesFloat64Penalties committed by the player that were declined.
ypaFloat64Average yards per rushing attempt.
dropsFloat64Passes dropped by the ball carrier.
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 ball-security (hands/fumble) grade, 0-100.
longestFloat64Longest run in yards.
routesFloat64Pass routes run by the player.
playerStringPlayer's display name as PFF lists it.
franchise_idFloat64PFF franchise (team) id (integer join key).
rec_yardsFloat64Receiving yards gained by the ball carrier (the rushing report also carries his receiving line).
gap_attemptsFloat64Rushing attempts on gap-scheme runs.
run_playsFloat64Run-play snaps.
avoided_tacklesFloat64Missed tackles forced.
grades_offense_penaltyFloat64PFF offensive penalty grade, 0-100.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
touchdownsFloat64Rushing touchdowns.
grades_passFloat64PFF passing 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_rushing_summary()

pff_facet_slot_coverages​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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_snapsFloat64Coverage snaps played while covering the slot.
coverage_snaps_per_receptionFloat64Coverage snaps played per reception allowed while covering the slot.
coverage_snaps_per_targetFloat64Coverage snaps played per target into the player's coverage while covering the slot.
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).
interceptionsFloat64Interceptions made by the player while covering the slot.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
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).
qb_rating_againstFloat64NFL passer rating allowed on targets into the player's coverage while covering the slot.
receptionsFloat64Receptions allowed in the player's coverage while covering the slot.
targetsFloat64Passes thrown into the player's coverage (targets allowed) while covering the slot.
teamStringTeam abbreviation the player is credited to for the range.
team_nameStringTeam abbreviation the player is credited to for the range.
touchdownsFloat64Touchdowns allowed into the player's coverage while covering the slot.
yardsFloat64Receiving yards allowed in the player's coverage while covering the slot.
yards_after_catchFloat64Yards after the catch allowed in the player's coverage while covering the slot.
yards_per_coverage_snapFloat64Receiving yards allowed per coverage snap while covering the slot.

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

pff_facet_pbes​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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
attemptsFloat64Pass plays the team's offensive line blocked on over the covered span, as counted by PFF (equal to pass_snaps in the captured rows).
franchise_idFloat64PFF franchise (team) id of the team whose offensive line the row describes (integer join key).
hits_allowedFloat64Quarterback hits allowed.
hurries_allowedFloat64Quarterback hurries allowed.
pass_snapsFloat64Pass-play snaps.
pbeFloat64PFF Pass Blocking Efficiency rating, pressures allowed per pass-blocking snap weighted toward sacks.
player_game_countFloat64Number of games the player appeared in over the covered span.
pressures_allowedFloat64Total pressures allowed (sacks, hits, and hurries).
sacks_allowedFloat64Sacks allowed by the team's offensive line over the covered span.
season_idFloat64Season (year) the row covers (e.g. 2022).
team_nameStringAbbreviation of the team whose offensive line the row describes (e.g. "ATL").

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

pff_facet_prps​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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_sacksFloat64Sacks recorded when rushing from the left side.
rhs_hitsFloat64Quarterback hits recorded when rushing from the right side.
rhs_prpFloat64PFF Pass Rush Productivity rating, pressure generated per pass-rush snap weighted toward sacks when rushing from the right side.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
pass_snapsFloat64Pass-play snaps.
lhs_hurriesFloat64Quarterback hurries recorded when rushing from the left side.
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.
tacklesFloat64Tackles made by the player, as charted by PFF.
rhs_pressuresFloat64Total pressures generated (sacks, hits, and hurries) when rushing from the right side.
rhs_pass_rush_percentFloat64Share of pass-play snaps spent rushing the passer when rushing from the right side.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
lhs_pass_rush_percentFloat64Share of pass-play snaps spent rushing the passer when rushing from the left side.
lhs_pass_rush_snapsFloat64Pass-rush snaps played when rushing from the left side.
sacksFloat64Sacks recorded by the pass rusher.
lhs_assistsFloat64Assisted tackles when rushing from the left side.
player_game_countFloat64Number of games the player appeared in over the covered span.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
lhs_pressuresFloat64Total pressures generated (sacks, hits, and hurries) when rushing from the left side.
pass_rush_snapsFloat64Pass-rush snaps played.
hurriesFloat64Quarterback hurries recorded.
rhs_pass_rush_snapsFloat64Pass-rush snaps played when rushing from the right side.
lhs_prpFloat64PFF Pass Rush Productivity rating, pressure generated per pass-rush snap weighted toward sacks when rushing from the left side.
hitsFloat64Quarterback hits recorded by the pass rusher.
lhs_hitsFloat64Quarterback hits recorded when rushing from the left side.
rhs_tacklesFloat64Tackles made when rushing from the right side.
lhs_stopsFloat64Stops, PFF's tackles that constitute a failed play for the offense when rushing from the left side.
teamStringTeam abbreviation the player is credited to for the range.
stopsFloat64Stops, PFF's tackles that constitute a failed play for the offense.
rhs_missesFloat64Missed tackles when rushing from the right side.
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).
pressuresFloat64Total pressures generated (sacks, hits, and hurries).
missesFloat64Missed tackles.
playerStringPlayer's display name as PFF lists it.
rhs_sacksFloat64Sacks recorded when rushing from the right side.
franchise_idFloat64PFF franchise (team) id (integer join key).
pass_rush_percentFloat64Share of pass-play snaps spent rushing the passer.
rhs_hurriesFloat64Quarterback hurries recorded when rushing from the right side.
rhs_assistsFloat64Assisted tackles when rushing from the right side.
rhs_stopsFloat64Stops, PFF's tackles that constitute a failed play for the offense when rushing from the right side.
assistsFloat64Assisted tackles credited to the player.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
lhs_tacklesFloat64Tackles made when rushing from the left side.
lhs_missesFloat64Missed tackles when rushing from the left side.

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

pff_facet_receiving_scheme​

LEGACY (premium.pff.com cookie auth; prefer the pff_api_* Developer API wrappers). 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_rateFloat64Percentage of PFF-charted contested targets caught against man coverage.
man_touchdownsFloat64Receiving touchdowns scored against man coverage.
zone_targets_percentFloat64Share of the team's targets thrown to the player against zone coverage.
man_interceptionsFloat64Interceptions thrown on passes targeting the player against man coverage.
zone_epaFloat64Total expected points added on targets to the player against zone coverage.
man_avg_depth_of_targetFloat64Average depth of target in yards downfield against man coverage.
zone_pass_blocksFloat64Pass-play snaps spent pass blocking against zone coverage.
zone_avoided_tacklesFloat64Tackles avoided after the catch against zone coverage.
man_targeted_qb_ratingFloat64NFL passer rating on throws targeting the player against man coverage.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
zone_positive_epa_percentFloat64Percentage of the receiver's plays with an EPA value (in practice their routes run) producing positive expected points added against zone coverage.
man_targets_percentFloat64Share of the team's targets thrown to the player against man coverage.
man_yards_per_receptionFloat64Average yards per reception against man coverage.
team_nameStringTeam abbreviation the player is credited to for the range.
man_drop_rateFloat64Share of catchable targets the player dropped against man coverage.
zone_grades_pass_routeFloat64PFF route-running (receiving) grade against zone coverage, 0-100.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
zone_fumblesFloat64Fumbles by the player after the catch against zone coverage.
man_pass_block_rateFloat64Share of pass-play snaps spent pass blocking against man coverage.
zone_yardsFloat64Receiving yards gained against zone coverage.
man_yprrFloat64Yards per route run against man coverage.
player_game_countFloat64Number of games the player appeared in over the covered span.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
zone_dropsFloat64PFF-charted drops against zone coverage.
zone_receptionsFloat64Receptions made against zone coverage.
man_pass_playsFloat64Pass-play snaps against man coverage.
man_epaFloat64Total expected points added on targets to the player against man coverage.
zone_yards_per_receptionFloat64Average yards per reception against zone coverage.
man_contested_targetsFloat64PFF-charted contested targets against man coverage.
man_longestFloat64Longest reception in yards against man coverage.
zone_yards_after_catchFloat64Yards gained after the catch against zone coverage.
man_receptionsFloat64Receptions made against man coverage.
man_avoided_tacklesFloat64Tackles avoided after the catch against man coverage.
man_first_downsFloat64Receptions that converted a first down against man coverage.
base_targetsFloat64Total targets from the facet's unsplit base row, across all coverage schemes.
zone_contested_catch_rateFloat64Percentage of PFF-charted contested targets caught against zone coverage.
zone_targeted_qb_ratingFloat64NFL passer rating on throws targeting the player against zone coverage.
man_routesFloat64Pass routes run by the player against man coverage.
zone_grades_hands_dropFloat64PFF hands/drop grade against zone coverage, 0-100.
man_route_rateFloat64Share of pass-play snaps on which the player ran a route against man coverage.
zone_pass_block_rateFloat64Share of pass-play snaps spent pass blocking against zone coverage.
man_grades_pass_routeFloat64PFF route-running (receiving) grade against man coverage, 0-100.
penaltiesFloat64Penalties charged to the player over the covered span.
zone_first_downsFloat64Receptions that converted a first down against zone coverage.
zone_yprrFloat64Yards per route run against zone coverage.
man_dropsFloat64PFF-charted drops against man coverage.
zone_caught_percentFloat64Percentage of targets caught against zone coverage.
teamStringTeam abbreviation the player is credited to for the range.
man_fumblesFloat64Fumbles by the player after the catch against man coverage.
declined_penaltiesFloat64Penalties committed by the player that were declined.
man_yards_after_catchFloat64Yards gained after the catch against man coverage.
man_yardsFloat64Receiving yards gained against man coverage.
zone_pass_playsFloat64Pass-play snaps against zone coverage.
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).
man_targetsFloat64Pass targets to the player against man coverage.
man_grades_hands_dropFloat64PFF hands/drop grade against man coverage, 0-100.
man_pass_blocksFloat64Pass-play snaps spent pass blocking against man coverage.
zone_touchdownsFloat64Receiving touchdowns scored against zone coverage.
zone_route_rateFloat64Share of pass-play snaps on which the player ran a route against zone coverage.
zone_yards_after_catch_per_receptionFloat64Average yards after the catch per reception against zone coverage.
zone_avg_depth_of_targetFloat64Average depth of target in yards downfield against zone coverage.
playerStringPlayer's display name as PFF lists it.
franchise_idFloat64PFF franchise (team) id (integer join key).
zone_contested_targetsFloat64PFF-charted contested targets against zone coverage.
zone_contested_receptionsFloat64Catches made on PFF-charted contested targets against zone coverage.
man_contested_receptionsFloat64Catches made on PFF-charted contested targets against man coverage.
man_yards_after_catch_per_receptionFloat64Average yards after the catch per reception against man coverage.
zone_targetsFloat64Pass targets to the player against zone coverage.
zone_longestFloat64Longest reception in yards against zone coverage.
man_caught_percentFloat64Percentage of targets caught against man coverage.
zone_drop_rateFloat64Share of catchable targets the player dropped against zone coverage.
zone_interceptionsFloat64Interceptions thrown on passes targeting the player against zone coverage.
man_positive_epa_percentFloat64Percentage of the receiver's plays with an EPA value (in practice their routes run) producing positive expected points added against man coverage.
zone_routesFloat64Pass routes run by the player against zone coverage.
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_receiving_scheme()