Skip to main content

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

pff_api_facet_offense_summary​

League-wide offense summary leaderboard

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

Valid URL: https://api.pff.com/v1/facet/offense/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
declined_penaltiesFloat64Penalties committed by the player that were declined.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
franchise_idFloat64PFF franchise (team) id (integer join key).
grades_hands_fumbleFloat64PFF ball-security (hands/fumble) grade, 0-100.
grades_offenseFloat64PFF overall offense grade (0-100).
grades_offense_penaltyFloat64PFF offensive penalty grade, 0-100.
grades_passFloat64PFF passing grade (0-100).
grades_runFloat64PFF rushing grade (0-100).
grades_run_blockFloat64PFF run-blocking grade (0-100).
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
penaltiesFloat64Penalties charged to the player over the covered span.
playerStringPlayer's display name as PFF lists it.
player_game_countFloat64Games with at least one qualifying snap in the requested range.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
positionStringPFF position code the player is listed at (e.g. QB, HB, FB, WR, TE, T, G, C, ED, DI, LB, CB, S, K, P).
snap_counts_passFloat64Pass-play snaps spent as the passer, rather than blocking or running a route.
snap_counts_pass_blockFloat64Pass-blocking snaps played.
snap_counts_pass_routeFloat64Snaps spent running a pass route.
snap_counts_runFloat64Run-play snaps spent as a runner, rather than run blocking.
snap_counts_run_blockFloat64Run-blocking snaps played.
snap_counts_totalFloat64Total offensive snaps played.
snap_counts_total_passFloat64Total pass-play snaps across passing, pass blocking, and route running.
snap_counts_total_runFloat64Total run-play snaps across rushing and run blocking.
teamStringTeam abbreviation the player is credited to for the range.
team_nameStringTeam abbreviation the player is credited to for the range.
grades_pass_blockFloat64PFF pass-blocking grade (0-100).
grades_pass_routeFloat64PFF receiving/route grade (0-100).

return_parsed=False — The 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_offense_summary(league='nfl', season='2022')

pff_api_facet_offense_blocking​

League-wide blocking leaderboard

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

Valid URL: https://api.pff.com/v1/facet/offense/blocking?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_pass_blockFloat64PFF pass-blocking grade, 0-100.
grades_offenseFloat64PFF overall offense grade, 0-100.
pbeFloat64PFF Pass Blocking Efficiency rating, pressures allowed per pass-blocking snap weighted toward sacks.
non_spike_pass_block_percentageFloat64Share of non-spike pass-play snaps spent pass blocking.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
snap_counts_rgFloat64Snaps aligned at right guard.
team_nameStringTeam abbreviation the player is credited to for the range.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
snap_counts_ceFloat64Snaps aligned at center.
hits_allowedFloat64Quarterback hits allowed.
block_percentFloat64Share of offensive snaps spent blocking.
snap_counts_offenseFloat64Offensive snaps played.
player_game_countFloat64Number of games the player appeared in over the covered span.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
snap_counts_blockFloat64Total blocking snaps played.
hurries_allowedFloat64Quarterback hurries allowed.
grades_run_blockFloat64PFF run-blocking grade, 0-100.
snap_counts_run_blockFloat64Run-blocking snaps played.
pressures_allowedFloat64Total pressures allowed (sacks, hits, and hurries).
snap_counts_pass_playFloat64Pass-play snaps.
penaltiesFloat64Penalties charged to the player over the covered span.
sacks_allowedFloat64Sacks allowed by the player in pass protection.
teamStringTeam abbreviation the player is credited to for the range.
declined_penaltiesFloat64Penalties committed by the player that were declined.
snap_counts_teFloat64Snaps aligned at tight end.
snap_counts_rtFloat64Snaps aligned at right tackle.
positionStringPFF position code the player is listed at (e.g. QB, HB, FB, WR, TE, T, G, C, ED, DI, LB, CB, S, K, P).
non_spike_pass_blockFloat64Pass-blocking snaps excluding spike plays.
snap_counts_ltFloat64Snaps aligned at left tackle.
playerStringPlayer's display name as PFF lists it.
franchise_idFloat64PFF franchise (team) id (integer join key).
snap_counts_pass_blockFloat64Pass-blocking snaps played.
pass_block_percentFloat64Share of pass-play snaps spent pass blocking.
snap_counts_lgFloat64Snaps aligned at left guard.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).

return_parsed=False — The 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_offense_blocking(league='nfl', season='2022')

pff_api_facet_offense_pass_blocking​

League-wide pass-blocking leaderboard

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

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

return_parsed=False — The 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_offense_pass_blocking(league='nfl', season='2022')

pff_api_facet_offense_run_blocking​

League-wide run-blocking leaderboard

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

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

return_parsed=False — The 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_offense_run_blocking(league='nfl', season='2022')

pff_api_facet_passing_allowed_pressure​

League-wide pressure-allowed leaderboard

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

Valid URL: https://api.pff.com/v1/facet/passing/allowed_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
te_percentFloat64Share of allowed pressures attributed to tight ends, expressed as a percentage.
draft_seasonFloat64NFL season (year) in which the player was drafted, per PFF player metadata.
pressures_ltFloat64Number of allowed pressures PFF attributes to left tackle.
pressures_rgFloat64Number of allowed pressures PFF attributes to right guard.
team_nameStringTeam abbreviation the player is credited to for the range.
lt_percentFloat64Share of allowed pressures attributed to left tackle, expressed as a percentage.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
hits_allowedFloat64Number of quarterback hits allowed on the player's dropbacks, as charted by PFF.
pressures_lgFloat64Number of allowed pressures PFF attributes to left guard.
player_game_countFloat64Number of games the player appeared in during the period covered.
eligible_seasonFloat64Season (year) of the player's NFL draft eligibility, per PFF player metadata.
hurries_allowedFloat64Number of hurries allowed on the player's dropbacks, as charted by PFF.
self_percentFloat64Share of allowed pressures attributed to the quarterback himself, expressed as a percentage.
pressures_rtFloat64Number of allowed pressures PFF attributes to right tackle.
pressures_allowedFloat64Total pressures allowed on the quarterback's dropbacks, as attributed by PFF.
pressures_ol_teFloat64Number of allowed pressures PFF attributes to the offensive line and tight ends combined.
pressures_ceFloat64Number of allowed pressures PFF attributes to center.
penaltiesFloat64Penalties charged to the player over the covered span.
sacks_allowedFloat64Sacks allowed on the quarterback's dropbacks, as attributed by PFF.
ol_te_percentFloat64Share of allowed pressures attributed to the offensive line and tight ends combined, expressed as a percentage.
allowed_pressure_dropbacksFloat64Number of dropbacks over which allowed pressures are attributed, from the PFF allowed-pressure facet.
pressures_otherFloat64Number of allowed pressures PFF attributes to other players outside the listed blocking positions.
teamStringTeam abbreviation the player is credited to for the range.
declined_penaltiesFloat64Number of declined penalties committed by the player.
ce_percentFloat64Share of allowed pressures attributed to center, expressed as a percentage.
positionStringPFF position code the player is listed at (e.g. QB, HB, FB, WR, TE, T, G, C, ED, DI, LB, CB, S, K, P).
pressures_teFloat64Number of allowed pressures PFF attributes to tight ends.
pressures_selfFloat64Number of allowed pressures PFF attributes to the quarterback himself.
lg_percentFloat64Share of allowed pressures attributed to left guard, expressed as a percentage.
playerStringPlayer's display name as PFF lists it.
rt_percentFloat64Share of allowed pressures attributed to right tackle, expressed as a percentage.
franchise_idFloat64PFF franchise (team) id (integer join key).
other_percentFloat64Share of allowed pressures attributed to other players outside the listed blocking positions, expressed as a percentage.
pressures_offFloat64Number of allowed pressures PFF attributes to the offense without a specific blocker charged.
rg_percentFloat64Share of allowed pressures attributed to right guard, expressed as a percentage.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).

return_parsed=False — The 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_allowed_pressure(league='nfl', season='2022')

pff_api_facet_passing_concept​

League-wide passing-by-concept leaderboard

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

Valid URL: https://api.pff.com/v1/facet/passing/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
comp_pct_diffFloat64Difference in completion percentage between play-action and non-play-action attempts (PA minus non-PA), from the PFF passing-concept split.
pa_grades_passFloat64PFF passing grade (0-100) on play-action dropbacks.
no_screen_grades_offenseFloat64PFF overall offense grade for the player (0-100) excluding screen passes.
pa_qb_ratingFloat64Traditional NFL passer rating on play-action dropbacks.
no_screen_qb_ratingFloat64Traditional NFL passer rating excluding screen passes.
pa_completionsFloat64Number of completed passes on play-action dropbacks.
pa_thrown_awaysFloat64Number of intentional throwaways on play-action dropbacks.
pa_dropbacks_percentFloat64Share of the player's total dropbacks that came on play-action dropbacks, expressed as a percentage.
ypa_diffFloat64Difference in yards per attempt between play-action and non-play-action attempts (PA minus non-PA), from the PFF passing-concept split.
no_screen_dropsFloat64Number of catchable passes dropped by receivers excluding screen passes.
screen_completion_percentFloat64Percentage of pass attempts completed on screen passes.
npa_batsFloat64Number of pass attempts batted down at the line of scrimmage on non-play-action dropbacks.
no_screen_thrown_awaysFloat64Number of intentional throwaways excluding screen passes.
pa_grades_runFloat64PFF rushing grade for the player (0-100) on play-action dropbacks.
screen_pressure_to_sack_rateFloat64Percentage of pressured dropbacks that ended in a sack on screen passes.
pa_drop_rateFloat64Percentage of catchable passes dropped by receivers on play-action dropbacks.
screen_grades_offenseFloat64PFF overall offense grade for the player (0-100) on screen passes.
dropbacksFloat64Number of dropbacks.
npa_thrown_awaysFloat64Number of intentional throwaways on non-play-action dropbacks.
no_screen_def_gen_pressuresFloat64Number of defense-generated pressures on the player's dropbacks excluding screen passes, as charted by PFF.
screen_grades_hands_fumbleFloat64PFF hands (fumble) grade for the player, reflecting ball security (0-100) on screen passes.
pa_touchdownsFloat64Number of passing touchdowns thrown on play-action dropbacks.
npa_ypaFloat64Yards gained per pass attempt on non-play-action dropbacks.
draft_seasonFloat64NFL season (year) in which the player was drafted, per PFF player metadata.
screen_avg_time_to_throwFloat64Average time to throw per dropback, in seconds from snap to release, on screen passes.
screen_thrown_awaysFloat64Number of intentional throwaways on screen passes.
npa_sacksFloat64Number of sacks taken on non-play-action dropbacks.
npa_aimed_passesFloat64Number of aimed passes (attempts excluding throwaways, spikes, batted passes and throws made while hit) on non-play-action dropbacks, as charted by PFF.
no_screen_completionsFloat64Number of completed passes excluding screen passes.
no_screen_positive_epa_percentFloat64Percentage of dropbacks with positive expected points added excluding screen passes.
screen_spikesFloat64Number of clock-stopping spikes on screen passes.
pa_first_downsFloat64Number of passing first downs gained on play-action dropbacks.
pa_big_time_throwsFloat64Number of big-time throws on play-action dropbacks, per PFF's highest-value, highest-difficulty throw designation.
team_nameStringTeam abbreviation the player is credited to for the range.
pa_spikesFloat64Number of clock-stopping spikes on play-action dropbacks.
pa_sack_percentFloat64Percentage of dropbacks that ended in a sack on play-action dropbacks.
screen_dropbacks_percentFloat64Share of the player's total dropbacks that came on screen passes, expressed as a percentage.
no_screen_epaFloat64Total expected points added (EPA) on the player's dropbacks excluding screen passes.
npa_avg_time_to_throwFloat64Average time to throw per dropback, in seconds from snap to release, on non-play-action dropbacks.
screen_batsFloat64Number of pass attempts batted down at the line of scrimmage on screen passes.
screen_grades_run_blockFloat64PFF run-blocking grade for the player (0-100) on screen passes.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
no_screen_batsFloat64Number of pass attempts batted down at the line of scrimmage excluding screen passes.
npa_grades_offenseFloat64PFF overall offense grade for the player (0-100) on non-play-action dropbacks.
no_screen_grades_pass_routeFloat64PFF receiving (route) grade for the player (0-100) excluding screen passes.
screen_def_gen_pressuresFloat64Number of defense-generated pressures on the player's dropbacks on screen passes, as charted by PFF.
pa_pressure_to_sack_rateFloat64Percentage of pressured dropbacks that ended in a sack on play-action dropbacks.
screen_sack_percentFloat64Percentage of dropbacks that ended in a sack on screen passes.
no_screen_btt_rateFloat64Big-time throws as a percentage of qualifying attempts excluding screen passes, per PFF charting.
npa_btt_rateFloat64Big-time throws as a percentage of qualifying attempts on non-play-action dropbacks, per PFF charting.
screen_interceptionsFloat64Number of passes intercepted on screen passes.
no_screen_passing_snapsFloat64Number of passing snaps played excluding screen passes.
no_screen_grades_hands_fumbleFloat64PFF hands (fumble) grade for the player, reflecting ball security (0-100) excluding screen passes.
screen_scramblesFloat64Number of scrambles on screen passes.
screen_grades_passFloat64PFF passing grade (0-100) on screen passes.
npa_qb_ratingFloat64Traditional NFL passer rating on non-play-action dropbacks.
no_screen_grades_passFloat64PFF passing grade (0-100) excluding screen passes.
pa_avg_time_to_throwFloat64Average time to throw per dropback, in seconds from snap to release, on play-action dropbacks.
screen_twp_rateFloat64Turnover-worthy plays as a percentage of qualifying attempts on screen passes, per PFF charting.
player_game_countFloat64Number of games the player appeared in during the period covered.
npa_accuracy_percentFloat64Percentage of aimed passes charted as accurate by PFF on non-play-action dropbacks.
eligible_seasonFloat64Season (year) of the player's NFL draft eligibility, per PFF player metadata.
npa_dropsFloat64Number of catchable passes dropped by receivers on non-play-action dropbacks.
screen_yardsFloat64Passing yards gained on screen passes.
no_screen_drop_rateFloat64Percentage of catchable passes dropped by receivers excluding screen passes.
no_screen_grades_offense_penaltyFloat64PFF offensive penalty grade for the player (0-100) excluding screen passes.
npa_passing_snapsFloat64Number of passing snaps played on non-play-action dropbacks.
screen_drop_rateFloat64Percentage of catchable passes dropped by receivers on screen passes.
screen_epaFloat64Total expected points added (EPA) on the player's dropbacks on screen passes.
screen_grades_pass_routeFloat64PFF receiving (route) grade for the player (0-100) on screen passes.
screen_grades_offense_penaltyFloat64PFF offensive penalty grade for the player (0-100) on screen passes.
npa_spikesFloat64Number of clock-stopping spikes on non-play-action dropbacks.
screen_hit_as_threwFloat64Number of attempts on which the passer was hit as he threw on screen passes, as charted by PFF.
no_screen_aimed_passesFloat64Number of aimed passes (attempts excluding throwaways, spikes, batted passes and throws made while hit) excluding screen passes, as charted by PFF.
screen_dropsFloat64Number of catchable passes dropped by receivers on screen passes.
screen_ypaFloat64Yards gained per pass attempt on screen passes.
npa_twp_rateFloat64Turnover-worthy plays as a percentage of qualifying attempts on non-play-action dropbacks, per PFF charting.
screen_accuracy_percentFloat64Percentage of aimed passes charted as accurate by PFF on screen passes.
npa_hit_as_threwFloat64Number of attempts on which the passer was hit as he threw on non-play-action dropbacks, as charted by PFF.
pa_accuracy_percentFloat64Percentage of aimed passes charted as accurate by PFF on play-action dropbacks.
pa_def_gen_pressuresFloat64Number of defense-generated pressures on the player's dropbacks on play-action dropbacks, as charted by PFF.
screen_avg_depth_of_targetFloat64Average depth of target in air yards on screen passes.
pa_sacksFloat64Number of sacks taken on play-action dropbacks.
screen_passing_snapsFloat64Number of passing snaps played on screen passes.
no_screen_grades_runFloat64PFF rushing grade for the player (0-100) excluding screen passes.
no_screen_first_downsFloat64Number of passing first downs gained excluding screen passes.
pa_ypaFloat64Yards gained per pass attempt on play-action dropbacks.
npa_scramblesFloat64Number of scrambles on non-play-action dropbacks.
npa_pressure_to_sack_rateFloat64Percentage of pressured dropbacks that ended in a sack on non-play-action dropbacks.
pa_twp_rateFloat64Turnover-worthy plays as a percentage of qualifying attempts on play-action dropbacks, per PFF charting.
no_screen_twp_rateFloat64Turnover-worthy plays as a percentage of qualifying attempts excluding screen passes, per PFF charting.
npa_grades_hands_fumbleFloat64PFF hands (fumble) grade for the player, reflecting ball security (0-100) on non-play-action dropbacks.
screen_completionsFloat64Number of completed passes on screen passes.
screen_btt_rateFloat64Big-time throws as a percentage of qualifying attempts on screen passes, per PFF charting.
npa_grades_runFloat64PFF rushing grade for the player (0-100) on non-play-action dropbacks.
no_screen_interceptionsFloat64Number of passes intercepted excluding screen passes.
npa_grades_run_blockFloat64PFF run-blocking grade for the player (0-100) on non-play-action dropbacks.
no_screen_sacksFloat64Number of sacks taken excluding screen passes.
penaltiesFloat64Penalties charged to the player over the covered span.
no_screen_big_time_throwsFloat64Number of big-time throws excluding screen passes, per PFF's highest-value, highest-difficulty throw designation.
npa_drop_rateFloat64Percentage of catchable passes dropped by receivers on non-play-action dropbacks.
npa_attemptsFloat64Number of pass attempts on non-play-action dropbacks.
screen_qb_ratingFloat64Traditional NFL passer rating on screen passes.
npa_grades_offense_penaltyFloat64PFF offensive penalty grade for the player (0-100) on non-play-action dropbacks.
pa_batsFloat64Number of pass attempts batted down at the line of scrimmage on play-action dropbacks.
pa_attemptsFloat64Number of pass attempts on play-action dropbacks.
npa_def_gen_pressuresFloat64Number of defense-generated pressures on the player's dropbacks on non-play-action dropbacks, as charted by PFF.
no_screen_avg_time_to_throwFloat64Average time to throw per dropback, in seconds from snap to release, excluding screen passes.
pa_yardsFloat64Passing yards gained on play-action dropbacks.
npa_positive_epa_percentFloat64Percentage of dropbacks with positive expected points added on non-play-action dropbacks.
teamStringTeam abbreviation the player is credited to for the range.
no_screen_scramblesFloat64Number of scrambles excluding screen passes.
pa_turnover_worthy_playsFloat64Number of turnover-worthy plays on play-action dropbacks, plays PFF charts as deserving of a turnover.
pa_aimed_passesFloat64Number of aimed passes (attempts excluding throwaways, spikes, batted passes and throws made while hit) on play-action dropbacks, as charted by PFF.
declined_penaltiesFloat64Number of declined penalties committed by the player.
pa_grades_offenseFloat64PFF overall offense grade for the player (0-100) on play-action dropbacks.
screen_positive_epa_percentFloat64Percentage of dropbacks with positive expected points added on screen passes.
no_screen_dropbacksFloat64Number of dropbacks excluding screen passes.
no_screen_dropbacks_percentFloat64Share of the player's total dropbacks that came excluding screen passes, expressed as a percentage.
npa_grades_pass_routeFloat64PFF receiving (route) grade for the player (0-100) on non-play-action dropbacks.
npa_sack_percentFloat64Percentage of dropbacks that ended in a sack on non-play-action dropbacks.
pa_positive_epa_percentFloat64Percentage of dropbacks with positive expected points added on play-action dropbacks.
pa_grades_run_blockFloat64PFF run-blocking grade for the player (0-100) on play-action dropbacks.
no_screen_turnover_worthy_playsFloat64Number of turnover-worthy plays excluding screen passes, plays PFF charts as deserving of a turnover.
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).
pa_grades_pass_routeFloat64PFF receiving (route) grade for the player (0-100) on play-action dropbacks.
npa_epaFloat64Total expected points added (EPA) on the player's dropbacks on non-play-action dropbacks.
no_screen_avg_depth_of_targetFloat64Average depth of target in air yards excluding screen passes.
pa_grades_hands_fumbleFloat64PFF hands (fumble) grade for the player, reflecting ball security (0-100) on play-action dropbacks.
no_screen_completion_percentFloat64Percentage of pass attempts completed excluding screen passes.
pa_hit_as_threwFloat64Number of attempts on which the passer was hit as he threw on play-action dropbacks, as charted by PFF.
pa_grades_offense_penaltyFloat64PFF offensive penalty grade for the player (0-100) on play-action dropbacks.
npa_dropbacks_percentFloat64Share of the player's total dropbacks that came on non-play-action dropbacks, expressed as a percentage.
npa_grades_passFloat64PFF passing grade (0-100) on non-play-action dropbacks.
screen_grades_runFloat64PFF rushing grade for the player (0-100) on screen passes.
screen_first_downsFloat64Number of passing first downs gained on screen passes.
npa_completion_percentFloat64Percentage of pass attempts completed on non-play-action dropbacks.
no_screen_grades_run_blockFloat64PFF run-blocking grade for the player (0-100) excluding screen passes.
no_screen_hit_as_threwFloat64Number of attempts on which the passer was hit as he threw excluding screen passes, as charted by PFF.
screen_turnover_worthy_playsFloat64Number of turnover-worthy plays on screen passes, plays PFF charts as deserving of a turnover.
npa_avg_depth_of_targetFloat64Average depth of target in air yards on non-play-action dropbacks.
npa_dropbacksFloat64Number of dropbacks on non-play-action dropbacks.
playerStringPlayer's display name as PFF lists it.
pa_dropsFloat64Number of catchable passes dropped by receivers on play-action dropbacks.
pa_btt_rateFloat64Big-time throws as a percentage of qualifying attempts on play-action dropbacks, per PFF charting.
franchise_idFloat64PFF franchise (team) id (integer join key).
screen_big_time_throwsFloat64Number of big-time throws on screen passes, per PFF's highest-value, highest-difficulty throw designation.
screen_aimed_passesFloat64Number of aimed passes (attempts excluding throwaways, spikes, batted passes and throws made while hit) on screen passes, as charted by PFF.
npa_touchdownsFloat64Number of passing touchdowns thrown on non-play-action dropbacks.
screen_attemptsFloat64Number of pass attempts on screen passes.
screen_dropbacksFloat64Number of dropbacks on screen passes.
no_screen_yardsFloat64Passing yards gained excluding screen passes.
pa_scramblesFloat64Number of scrambles on play-action dropbacks.
pa_completion_percentFloat64Percentage of pass attempts completed on play-action dropbacks.
pa_avg_depth_of_targetFloat64Average depth of target in air yards on play-action dropbacks.
pa_interceptionsFloat64Number of passes intercepted on play-action dropbacks.
no_screen_accuracy_percentFloat64Percentage of aimed passes charted as accurate by PFF excluding screen passes.
no_screen_spikesFloat64Number of clock-stopping spikes excluding screen passes.
pa_dropbacksFloat64Number of dropbacks on play-action dropbacks.
npa_big_time_throwsFloat64Number of big-time throws on non-play-action dropbacks, per PFF's highest-value, highest-difficulty throw designation.
no_screen_sack_percentFloat64Percentage of dropbacks that ended in a sack excluding screen passes.
pa_epaFloat64Total expected points added (EPA) on the player's dropbacks on play-action dropbacks.
no_screen_attemptsFloat64Number of pass attempts excluding screen passes.
pa_passing_snapsFloat64Number of passing snaps played on play-action dropbacks.
npa_completionsFloat64Number of completed passes on non-play-action dropbacks.
screen_touchdownsFloat64Number of passing touchdowns thrown on screen passes.
npa_first_downsFloat64Number of passing first downs gained on non-play-action dropbacks.
no_screen_touchdownsFloat64Number of passing touchdowns thrown excluding screen passes.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
npa_yardsFloat64Passing yards gained on non-play-action dropbacks.
no_screen_ypaFloat64Yards gained per pass attempt excluding screen passes.
npa_turnover_worthy_playsFloat64Number of turnover-worthy plays on non-play-action dropbacks, plays PFF charts as deserving of a turnover.
npa_interceptionsFloat64Number of passes intercepted on non-play-action dropbacks.
no_screen_pressure_to_sack_rateFloat64Percentage of pressured dropbacks that ended in a sack excluding screen passes.
screen_sacksFloat64Number of sacks taken on screen passes.
screen_grades_hands_dropFloat64PFF hands (drop) grade for the player (0-100) on screen passes.
screen_grades_pass_blockFloat64PFF pass-blocking grade for the player (0-100) on screen passes.
no_screen_grades_pass_blockFloat64PFF pass-blocking grade for the player (0-100) excluding screen passes.
pa_grades_hands_dropFloat64PFF hands (drop) grade for the player (0-100) on play-action dropbacks.
npa_grades_pass_blockFloat64PFF pass-blocking grade for the player (0-100) on non-play-action dropbacks.
pa_grades_pass_blockFloat64PFF pass-blocking grade for the player (0-100) on play-action dropbacks.
npa_grades_hands_dropFloat64PFF hands (drop) grade for the player (0-100) on non-play-action dropbacks.
no_screen_grades_hands_dropFloat64PFF hands (drop) grade for the player (0-100) excluding screen passes.
pa_grades_screen_blockFloat64PFF screen-blocking grade for the player (0-100) on play-action dropbacks.
screen_grades_screen_blockFloat64PFF screen-blocking grade for the player (0-100) on screen passes.
no_screen_grades_screen_blockFloat64PFF screen-blocking grade for the player (0-100) excluding screen passes.
npa_grades_screen_blockFloat64PFF screen-blocking grade for the player (0-100) on non-play-action dropbacks.
pa_grades_defense_penaltyFloat64PFF defensive penalty grade for the player (0-100) on play-action dropbacks.
npa_grades_defense_penaltyFloat64PFF defensive penalty grade for the player (0-100) on non-play-action dropbacks.
npa_grades_coverage_defenseFloat64PFF coverage grade for the player (0-100) on non-play-action dropbacks.
pa_grades_defenseFloat64PFF overall defense grade for the player (0-100) on play-action dropbacks.
screen_grades_coverage_defenseFloat64PFF coverage grade for the player (0-100) on screen passes.
npa_grades_defenseFloat64PFF overall defense grade for the player (0-100) on non-play-action dropbacks.
screen_grades_defenseFloat64PFF overall defense grade for the player (0-100) on screen passes.
screen_grades_defense_penaltyFloat64PFF defensive penalty grade for the player (0-100) on screen passes.
no_screen_grades_defenseFloat64PFF overall defense grade for the player (0-100) excluding screen passes.
pa_grades_coverage_defenseFloat64PFF coverage grade for the player (0-100) on play-action dropbacks.
no_screen_grades_defense_penaltyFloat64PFF defensive penalty grade for the player (0-100) excluding screen passes.
no_screen_grades_coverage_defenseFloat64PFF coverage grade for the player (0-100) excluding screen passes.
no_screen_grades_overall_tackleFloat64PFF overall tackling grade for the player (0-100) excluding screen passes.
pa_grades_overall_tackleFloat64PFF overall tackling grade for the player (0-100) on play-action dropbacks.
pa_grades_tackleFloat64PFF tackling grade for the player (0-100) on play-action dropbacks.
pa_grades_pass_rush_defenseStringPFF pass-rush grade for the player (0-100) on play-action dropbacks.
screen_grades_run_defenseStringPFF run-defense grade for the player (0-100) on screen passes.
pa_grades_run_defenseStringPFF run-defense grade for the player (0-100) on play-action dropbacks.
npa_grades_overall_tackleFloat64PFF overall tackling grade for the player (0-100) on non-play-action dropbacks.
no_screen_grades_pass_rush_defenseFloat64PFF pass-rush grade for the player (0-100) excluding screen passes.
npa_grades_tackleFloat64PFF tackling grade for the player (0-100) on non-play-action dropbacks.
screen_grades_tackleStringPFF tackling grade for the player (0-100) on screen passes.
no_screen_grades_tackleFloat64PFF tackling grade for the player (0-100) excluding screen passes.
npa_grades_pass_rush_defenseFloat64PFF pass-rush grade for the player (0-100) on non-play-action dropbacks.
no_screen_grades_run_defenseFloat64PFF run-defense grade for the player (0-100) excluding screen passes.
screen_grades_overall_tackleStringPFF overall tackling grade for the player (0-100) on screen passes.
npa_grades_run_defenseFloat64PFF run-defense grade for the player (0-100) on non-play-action dropbacks.
screen_grades_pass_rush_defenseFloat64PFF pass-rush grade for the player (0-100) on screen passes.

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_concept(league='nfl', season='2022')