Skip to main content

NFL — PFF Developer API (api.pff.com, API key) — Facet: passing–receiving

pff_api_facet_passing_pressure​

League-wide passing-under-pressure leaderboard

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

Valid URL: https://api.pff.com/v1/facet/passing/pressure?league=nfl&season=2022

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug for the leaderboard commands — exactly nfl, ncaa, hs, aaf and ufl are recognised; anything else is rejected.
seasonseasonYSeason for the leaderboard commands.
weekweekYWeek filter.
franchise_idfranchise_idYFranchise (team) id.
game_idgame_idYSingle-game filter, facet family only, forwarded uncoerced.
divisiondivisionYNCAA division fan-out, facet family only, and only honoured when league=ncaa — for any other league it is ignored entirely.

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 decoded JSON body. /v1 routes return the Premium Stats envelope ({report_slug: rows}); /v2 routes return {..meta.., columns, rows}..

Raises​

ExceptionDescription
RuntimeErrorNo PFF API key (pass api_key= or set PFF_API_KEY).
NoDataErrorThe host answered 404 -- the requested resource does not exist. PFF answered 404 (no such route, report or team).
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. The request was refused or failed (401/403/429/5xx) -- the answer is unknown, never an empty frame.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help. PFF rejected the parameters (400 invalid_parameter / 422).

Example​

pff_api_facet_passing_pressure(league='nfl', season='2022')

pff_api_facet_passing_summary​

League-wide passing summary leaderboard

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

Valid URL: https://api.pff.com/v1/facet/passing/summary?league=nfl&season=2022

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug for the leaderboard commands — exactly nfl, ncaa, hs, aaf and ufl are recognised; anything else is rejected.
seasonseasonYSeason for the leaderboard commands.
weekweekYWeek filter.
franchise_idfranchise_idYFranchise (team) id.
game_idgame_idYSingle-game filter, facet family only, forwarded uncoerced.
divisiondivisionYNCAA division fan-out, facet family only, and only honoured when league=ncaa — for any other league it is ignored entirely.

Returns​

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

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

return_parsed=False — The decoded JSON body. /v1 routes return the Premium Stats envelope ({report_slug: rows}); /v2 routes return {..meta.., columns, rows}..

Raises​

ExceptionDescription
RuntimeErrorNo PFF API key (pass api_key= or set PFF_API_KEY).
NoDataErrorThe host answered 404 -- the requested resource does not exist. PFF answered 404 (no such route, report or team).
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. The request was refused or failed (401/403/429/5xx) -- the answer is unknown, never an empty frame.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help. PFF rejected the parameters (400 invalid_parameter / 422).

Example​

pff_api_facet_passing_summary(league='nfl', season='2022')

pff_api_facet_receiving_concept​

League-wide receiving-by-concept leaderboard

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

Valid URL: https://api.pff.com/v1/facet/receiving/concept?league=nfl&season=2022

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug for the leaderboard commands — exactly nfl, ncaa, hs, aaf and ufl are recognised; anything else is rejected.
seasonseasonYSeason for the leaderboard commands.
weekweekYWeek filter.
franchise_idfranchise_idYFranchise (team) id.
game_idgame_idYSingle-game filter, facet family only, forwarded uncoerced.
divisiondivisionYNCAA division fan-out, facet family only, and only honoured when league=ncaa — for any other league it is ignored entirely.

Returns​

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

col_nametypedescription
screen_caught_percentFloat64Percentage of targets caught on screen concepts.
screen_targeted_qb_ratingFloat64NFL passer rating on throws targeting the player on screen concepts.
slot_grades_pass_routeFloat64PFF route-running (receiving) grade when aligned in the slot, 0-100.
slot_avg_depth_of_targetFloat64Average depth of target in yards downfield when aligned in the slot.
slot_positive_epa_percentFloat64Percentage of the receiver's plays with an EPA value (in practice their routes run) producing positive expected points added when aligned in the slot.
screen_yprrFloat64Yards per route run on screen concepts.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
slot_routesFloat64Pass routes run by the player when aligned in the slot.
team_nameStringTeam abbreviation the player is credited to for the range.
screen_grades_hands_dropFloat64PFF hands/drop grade on screen concepts, 0-100.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
screen_contested_catch_rateFloat64Percentage of PFF-charted contested targets caught on screen concepts.
slot_yards_per_receptionFloat64Average yards per reception when aligned in the slot.
screen_interceptionsFloat64Interceptions thrown on passes targeting the player on screen concepts.
slot_targets_percentFloat64Share of the team's targets thrown to the player when aligned in the slot.
screen_longestFloat64Longest reception in yards on screen concepts.
slot_avoided_tacklesFloat64Tackles avoided after the catch when aligned in the slot.
slot_yards_after_catchFloat64Yards gained after the catch when aligned in the slot.
slot_grades_hands_dropFloat64PFF hands/drop grade when aligned in the slot, 0-100.
player_game_countFloat64Number of games the player appeared in over the covered span.
screen_contested_targetsFloat64PFF-charted contested targets on screen concepts.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
screen_yards_after_catch_per_receptionFloat64Average yards after the catch per reception on screen concepts.
screen_yardsFloat64Receiving yards gained on screen concepts.
slot_route_rateFloat64Share of pass-play snaps on which the player ran a route when aligned in the slot.
screen_drop_rateFloat64Share of catchable targets the player dropped on screen concepts.
screen_epaFloat64Total expected points added on targets to the player on screen concepts.
screen_grades_pass_routeFloat64PFF route-running (receiving) grade on screen concepts, 0-100.
screen_dropsFloat64PFF-charted drops on screen concepts.
screen_fumblesFloat64Fumbles by the player after the catch on screen concepts.
slot_interceptionsFloat64Interceptions thrown on passes targeting the player when aligned in the slot.
screen_yards_after_catchFloat64Yards gained after the catch on screen concepts.
screen_avg_depth_of_targetFloat64Average depth of target in yards downfield on screen concepts.
screen_pass_block_rateFloat64Share of pass-play snaps spent pass blocking on screen concepts.
slot_pass_block_rateFloat64Share of pass-play snaps spent pass blocking when aligned in the slot.
slot_yprrFloat64Yards per route run when aligned in the slot.
base_targetsFloat64Total targets from the facet's unsplit base row, across all concepts.
slot_longestFloat64Longest reception in yards when aligned in the slot.
slot_dropsFloat64PFF-charted drops when aligned in the slot.
screen_routesFloat64Pass routes run by the player on screen concepts.
slot_fumblesFloat64Fumbles by the player after the catch when aligned in the slot.
penaltiesFloat64Penalties charged to the player over the covered span.
slot_contested_catch_rateFloat64Percentage of PFF-charted contested targets caught when aligned in the slot.
slot_pass_playsFloat64Pass-play snaps when aligned in the slot.
teamStringTeam abbreviation the player is credited to for the range.
declined_penaltiesFloat64Penalties committed by the player that were declined.
screen_positive_epa_percentFloat64Percentage of the receiver's plays with an EPA value (in practice their routes run) producing positive expected points added on screen concepts.
slot_first_downsFloat64Receptions that converted a first down when aligned in the slot.
screen_route_rateFloat64Share of pass-play snaps on which the player ran a route on screen concepts.
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).
screen_pass_blocksFloat64Pass-play snaps spent pass blocking on screen concepts.
slot_targetsFloat64Pass targets to the player when aligned in the slot.
slot_pass_blocksFloat64Pass-play snaps spent pass blocking when aligned in the slot.
slot_receptionsFloat64Receptions made when aligned in the slot.
screen_first_downsFloat64Receptions that converted a first down on screen concepts.
slot_caught_percentFloat64Percentage of targets caught when aligned in the slot.
screen_avoided_tacklesFloat64Tackles avoided after the catch on screen concepts.
playerStringPlayer's display name as PFF lists it.
slot_epaFloat64Total expected points added on targets to the player when aligned in the slot.
slot_drop_rateFloat64Share of catchable targets the player dropped when aligned in the slot.
franchise_idFloat64PFF franchise (team) id (integer join key).
slot_touchdownsFloat64Receiving touchdowns scored when aligned in the slot.
slot_yards_after_catch_per_receptionFloat64Average yards after the catch per reception when aligned in the slot.
screen_receptionsFloat64Receptions made on screen concepts.
slot_targeted_qb_ratingFloat64NFL passer rating on throws targeting the player when aligned in the slot.
slot_contested_targetsFloat64PFF-charted contested targets when aligned in the slot.
screen_yards_per_receptionFloat64Average yards per reception on screen concepts.
slot_contested_receptionsFloat64Catches made on PFF-charted contested targets when aligned in the slot.
screen_pass_playsFloat64Pass-play snaps on screen concepts.
screen_contested_receptionsFloat64Catches made on PFF-charted contested targets on screen concepts.
screen_touchdownsFloat64Receiving touchdowns scored on screen concepts.
screen_targetsFloat64Pass targets to the player on screen concepts.
screen_targets_percentFloat64Share of the team's targets thrown to the player on screen concepts.
slot_yardsFloat64Receiving yards gained when aligned in the slot.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).

return_parsed=False — The decoded JSON body. /v1 routes return the Premium Stats envelope ({report_slug: rows}); /v2 routes return {..meta.., columns, rows}..

Raises​

ExceptionDescription
RuntimeErrorNo PFF API key (pass api_key= or set PFF_API_KEY).
NoDataErrorThe host answered 404 -- the requested resource does not exist. PFF answered 404 (no such route, report or team).
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. The request was refused or failed (401/403/429/5xx) -- the answer is unknown, never an empty frame.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help. PFF rejected the parameters (400 invalid_parameter / 422).

Example​

pff_api_facet_receiving_concept(league='nfl', season='2022')

pff_api_facet_receiving_coverage​

League-wide receiving-versus-coverage leaderboard

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

Valid URL: https://api.pff.com/v1/facet/receiving/coverage?league=nfl&season=2022

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug for the leaderboard commands — exactly nfl, ncaa, hs, aaf and ufl are recognised; anything else is rejected.
seasonseasonYSeason for the leaderboard commands.
weekweekYWeek filter.
franchise_idfranchise_idYFranchise (team) id.
game_idgame_idYSingle-game filter, facet family only, forwarded uncoerced.
divisiondivisionYNCAA division fan-out, facet family only, and only honoured when league=ncaa — for any other league it is ignored entirely.

Returns​

return_parsed=True (default) — a dict of polars.DataFrames (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

defenders

col_nametypedescription
broken_up_passesInt64Passes broken up in the row's coverage matchups.
dropsInt64Dropped passes in the row's coverage matchups.
first_downsInt64Receiving first downs (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
grades_coverage_defenseFloat64The player's PFF coverage grade (0-100).
grades_defenseFloat64The player's PFF overall defense grade (0-100).
grades_defense_penaltyFloat64The player's PFF defensive penalty grade (0-100).
grades_overallFloat64The player's PFF overall grade (0-100) over the requested filters.
grades_overall_tackleFloat64The player's PFF overall tackling grade (0-100).
grades_pass_rush_defenseFloat64The player's PFF pass-rush grade (0-100).
grades_run_defenseFloat64The player's PFF run-defense grade (0-100).
grades_tackleFloat64The player's PFF tackling grade (0-100).
interceptionsInt64Interceptions on throws in the row's coverage matchups.
longestInt64Longest reception, in yards (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
player_game_countInt64Games the player appeared in over the requested filters.
player_idInt64PFF player id: the covering defender (defenders) or the receiver (receivers, versus).
receptionsInt64Receptions (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
targetsInt64Targets (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
touchdownsInt64Receiving touchdowns (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
yardsInt64Receiving yards (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
yards_after_catchInt64Yards after the catch (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
yards_per_receptionFloat64Yards per reception (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
grades_offenseFloat64The player's PFF overall offense grade (0-100).
grades_offense_penaltyFloat64The player's PFF offensive penalty grade (0-100).
grades_run_blockFloat64The player's PFF run-blocking grade (0-100).
grades_pass_blockFloat64The player's PFF pass-blocking grade (0-100).
grades_hands_dropFloat64The player's PFF hands (drop) grade (0-100).
grades_hands_fumbleFloat64The player's PFF ball-security (fumble) grade (0-100).
grades_pass_routeFloat64The player's PFF receiving (route-running) grade (0-100).
grades_passFloat64The player's PFF passing grade (0-100).
grades_runFloat64The player's PFF rushing grade (0-100).

receivers

col_nametypedescription
broken_up_passesInt64Passes broken up in the row's coverage matchups.
dropsInt64Dropped passes in the row's coverage matchups.
first_downsInt64Receiving first downs (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
grades_hands_dropFloat64The player's PFF hands (drop) grade (0-100).
grades_hands_fumbleFloat64The player's PFF ball-security (fumble) grade (0-100).
grades_offenseFloat64The player's PFF overall offense grade (0-100).
grades_offense_penaltyFloat64The player's PFF offensive penalty grade (0-100).
grades_overallFloat64The player's PFF overall grade (0-100) over the requested filters.
grades_pass_routeFloat64The player's PFF receiving (route-running) grade (0-100).
grades_run_blockFloat64The player's PFF run-blocking grade (0-100).
grades_screen_blockFloat64The player's PFF screen-blocking grade (0-100).
interceptionsInt64Interceptions on throws in the row's coverage matchups.
longestInt64Longest reception, in yards (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
player_game_countInt64Games the player appeared in over the requested filters.
player_idInt64PFF player id: the covering defender (defenders) or the receiver (receivers, versus).
receptionsInt64Receptions (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
targetsInt64Targets (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
touchdownsInt64Receiving touchdowns (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
yardsInt64Receiving yards (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
yards_after_catchInt64Yards after the catch (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
yards_per_receptionFloat64Yards per reception (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
grades_passFloat64The player's PFF passing grade (0-100).
grades_pass_blockFloat64The player's PFF pass-blocking grade (0-100).
grades_runFloat64The player's PFF rushing grade (0-100).
grades_defenseFloat64The player's PFF overall defense grade (0-100).
grades_defense_penaltyFloat64The player's PFF defensive penalty grade (0-100).
grades_pass_rush_defenseFloat64The player's PFF pass-rush grade (0-100).
grades_run_defenseFloat64The player's PFF run-defense grade (0-100).
grades_coverage_defenseFloat64The player's PFF coverage grade (0-100).
grades_overall_tackleFloat64The player's PFF overall tackling grade (0-100).
grades_tackleFloat64The player's PFF tackling grade (0-100).
grades_snapFloat64PFF grade reported as grades_snap (0-100); PFF does not document it, and the capture shows it only in the ncaa receivers frame.

versus

col_nametypedescription
broken_up_passesInt64Passes broken up in the row's coverage matchups.
coverage_player_idInt64PFF player id of the defender covering the receiver (versus only).
dropsInt64Dropped passes in the row's coverage matchups.
first_downsInt64Receiving first downs (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
interceptionsInt64Interceptions on throws in the row's coverage matchups.
longestInt64Longest reception, in yards (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
player_idInt64PFF player id: the covering defender (defenders) or the receiver (receivers, versus).
receptionsInt64Receptions (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
targetsInt64Targets (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
touchdownsInt64Receiving touchdowns (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
yardsInt64Receiving yards (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
yards_after_catchInt64Yards after the catch (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).
yards_per_receptionFloat64Yards per reception (defenders: allowed in the defender's coverage; receivers / versus: by the receiver).

return_parsed=False — The decoded JSON body. /v1 routes return the Premium Stats envelope ({report_slug: rows}); /v2 routes return {..meta.., columns, rows}..

Raises​

ExceptionDescription
RuntimeErrorNo PFF API key (pass api_key= or set PFF_API_KEY).
NoDataErrorThe host answered 404 -- the requested resource does not exist. PFF answered 404 (no such route, report or team).
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. The request was refused or failed (401/403/429/5xx) -- the answer is unknown, never an empty frame.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help. PFF rejected the parameters (400 invalid_parameter / 422).

Example​

pff_api_facet_receiving_coverage(league='nfl', season='2022')