Skip to main content

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

pff_api_facet_receiving_scheme​

League-wide receiving-by-scheme leaderboard

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

Valid URL: https://api.pff.com/v1/facet/receiving/scheme?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
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 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_scheme(league='nfl', season='2022')

pff_api_facet_receiving_summary​

League-wide receiving summary leaderboard

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

Valid URL: https://api.pff.com/v1/facet/receiving/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
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 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_summary(league='nfl', season='2022')

pff_api_facet_rushing_direction​

League-wide rushing-by-direction leaderboard

Endpoint URL: GET https://api.pff.com/v1/facet/rushing/direction

Valid URL: https://api.pff.com/v1/facet/rushing/direction?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
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 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_rushing_direction(league='nfl', season='2022')

pff_api_facet_rushing_summary​

League-wide rushing summary leaderboard

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

Valid URL: https://api.pff.com/v1/facet/rushing/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
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 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_rushing_summary(league='nfl', season='2022')

pff_api_facet_defense_coverage​

League-wide coverage leaderboard

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

Valid URL: https://api.pff.com/v1/facet/defense/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 tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
targetsFloat64Passes thrown into the player's coverage (targets allowed).
yards_per_coverage_snapFloat64Receiving yards allowed per coverage snap.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
missed_tacklesFloat64Missed tackles.
catch_rateFloat64Completion percentage allowed on targets into the player's coverage.
team_nameStringTeam abbreviation the player is credited to for the range.
tacklesFloat64Tackles made by the player, as charted by PFF.
coverage_percentFloat64Share of pass-play snaps spent in coverage.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
dropped_intsFloat64Interception chances PFF charted as dropped.
player_game_countFloat64Number of games the player appeared in over the covered span.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
grades_tackleFloat64PFF tackling grade, 0-100.
yardsFloat64Receiving yards allowed in the player's coverage.
receptionsFloat64Receptions allowed in the player's coverage.
forced_incompletion_rateFloat64Share of targets into the player's coverage with a PFF-charted forced incompletion.
grades_coverage_defenseFloat64PFF coverage grade, 0-100.
interceptionsFloat64Interceptions made by the player in coverage.
snap_counts_coverageFloat64Coverage snaps played.
grades_run_defenseFloat64PFF run-defense grade, 0-100.
snap_counts_pass_playFloat64Pass-play snaps.
penaltiesFloat64Penalties charged to the player over the covered span.
forced_incompletesFloat64Incompletions forced by the player's coverage, per PFF charting.
teamStringTeam abbreviation the player is credited to for the range.
coverage_snaps_per_targetFloat64Coverage snaps played per target into the player's coverage.
stopsFloat64Stops, PFF's tackles that constitute a failed play for the offense.
declined_penaltiesFloat64Penalties committed by the player that were declined.
positionStringPFF position code the player is listed at (e.g. QB, HB, FB, WR, TE, T, G, C, ED, DI, LB, CB, S, K, P).
longestFloat64Longest completion allowed, in yards.
missed_tackle_rateFloat64Share of tackle attempts the player missed.
grades_defenseFloat64PFF overall defense grade, 0-100.
yards_per_receptionFloat64Average yards allowed per reception.
grades_defense_penaltyFloat64PFF defensive penalty grade, 0-100.
playerStringPlayer's display name as PFF lists it.
franchise_idFloat64PFF franchise (team) id (integer join key).
yards_after_catchFloat64Yards after the catch allowed in the player's coverage.
avg_depth_of_targetFloat64Average depth of targets into the player's coverage, in yards downfield.
pass_break_upsFloat64Passes broken up.
qb_rating_againstFloat64NFL passer rating allowed on targets into the player's coverage.
coverage_snaps_per_receptionFloat64Coverage snaps played per reception allowed.
assistsFloat64Assisted tackles credited to the player.
grades_pass_rush_defenseFloat64PFF pass-rush grade, 0-100.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
touchdownsFloat64Touchdowns allowed into the player's coverage.

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

pff_api_facet_defense_coverage_scheme​

League-wide coverage-by-scheme leaderboard

Endpoint URL: GET https://api.pff.com/v1/facet/defense/coverage_scheme

Valid URL: https://api.pff.com/v1/facet/defense/coverage_scheme?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
man_touchdownsFloat64Touchdowns allowed into the player's coverage when in man coverage.
man_interceptionsFloat64Interceptions made in coverage when in man coverage.
zone_snap_counts_coverage_percentFloat64Share of the player's coverage snaps played when in zone coverage.
man_avg_depth_of_targetFloat64Average depth of targets into the player's coverage, in yards downfield when in man coverage.
man_dropped_intsFloat64Interception chances PFF charted as dropped when in man coverage.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
zone_coverage_snaps_per_targetFloat64Coverage snaps played per target into the player's coverage when in zone coverage.
man_yards_per_receptionFloat64Average yards allowed per reception when in man coverage.
team_nameStringTeam abbreviation the player is credited to for the range.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
man_snap_counts_coverageFloat64Coverage snaps played when in man coverage.
man_tacklesFloat64Tackles made when in man coverage.
zone_stopsFloat64Stops, PFF's tackles that constitute a failed play for the offense when in zone coverage.
zone_snap_counts_coverageFloat64Coverage snaps played when in zone coverage.
zone_yardsFloat64Receiving yards allowed when in zone coverage.
man_coverage_snaps_per_targetFloat64Coverage snaps played per target into the player's coverage when in man coverage.
zone_coverage_percentFloat64Share of pass-play snaps spent in coverage when in zone 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_receptionsFloat64Receptions allowed into the player's coverage when in zone coverage.
zone_forced_incompletion_rateFloat64Share of targets into the player's coverage with a PFF-charted forced incompletion when in zone coverage.
man_snap_counts_pass_playFloat64Pass-play snaps when in man coverage.
zone_yards_per_receptionFloat64Average yards allowed per reception when in zone coverage.
man_longestFloat64Longest completion allowed, in yards when in man coverage.
man_assistsFloat64Assisted tackles when in man coverage.
zone_yards_after_catchFloat64Yards after the catch allowed when in zone coverage.
man_stopsFloat64Stops, PFF's tackles that constitute a failed play for the offense when in man coverage.
man_receptionsFloat64Receptions allowed into the player's coverage when in man coverage.
zone_tacklesFloat64Tackles made when in zone coverage.
man_coverage_percentFloat64Share of pass-play snaps spent in coverage when in man coverage.
penaltiesFloat64Penalties charged to the player over the covered span.
zone_yards_per_coverage_snapFloat64Receiving yards allowed per coverage snap when in zone coverage.
teamStringTeam abbreviation the player is credited to for the range.
man_catch_rateFloat64Completion percentage allowed on targets into the player's coverage when in man coverage.
man_grades_coverage_defenseFloat64PFF coverage grade when in man coverage, 0-100.
declined_penaltiesFloat64Penalties committed by the player that were declined.
man_yards_after_catchFloat64Yards after the catch allowed when in man coverage.
man_pass_break_upsFloat64Passes broken up when in man coverage.
man_yardsFloat64Receiving yards allowed when in man 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_targetsFloat64Targets into the player's coverage when in man coverage.
man_missed_tackle_rateFloat64Share of tackle attempts the player missed when in man coverage.
zone_assistsFloat64Assisted tackles when in zone coverage.
zone_snap_counts_pass_playFloat64Pass-play snaps when in zone coverage.
zone_missed_tackle_rateFloat64Share of tackle attempts the player missed when in zone coverage.
zone_touchdownsFloat64Touchdowns allowed into the player's coverage when in zone coverage.
zone_coverage_snaps_per_receptionFloat64Coverage snaps played per reception allowed when in zone coverage.
man_coverage_snaps_per_receptionFloat64Coverage snaps played per reception allowed when in man coverage.
zone_avg_depth_of_targetFloat64Average depth of targets into the player's coverage, in yards downfield when in zone coverage.
man_snap_counts_coverage_percentFloat64Share of the player's coverage snaps played when in man coverage.
playerStringPlayer's display name as PFF lists it.
franchise_idFloat64PFF franchise (team) id (integer join key).
zone_forced_incompletesFloat64Incompletions forced by the player's coverage, per PFF charting when in zone coverage.
man_forced_incompletion_rateFloat64Share of targets into the player's coverage with a PFF-charted forced incompletion when in man coverage.
zone_targetsFloat64Targets into the player's coverage when in zone coverage.
zone_longestFloat64Longest completion allowed, in yards when in zone coverage.
zone_dropped_intsFloat64Interception chances PFF charted as dropped when in zone coverage.
zone_interceptionsFloat64Interceptions made in coverage when in zone coverage.
man_forced_incompletesFloat64Incompletions forced by the player's coverage, per PFF charting when in man coverage.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
zone_missed_tacklesFloat64Missed tackles when in zone coverage.
base_snap_counts_coverageFloat64Coverage snaps from the facet's unsplit base row, covering all coverage schemes.
man_missed_tacklesFloat64Missed tackles when in man coverage.
zone_grades_coverage_defenseFloat64PFF coverage grade when in zone coverage, 0-100.
man_qb_rating_againstFloat64NFL passer rating allowed on targets into the player's coverage when in man coverage.
zone_pass_break_upsFloat64Passes broken up when in zone coverage.
zone_qb_rating_againstFloat64NFL passer rating allowed on targets into the player's coverage when in zone coverage.
man_yards_per_coverage_snapFloat64Receiving yards allowed per coverage snap when in man coverage.
zone_catch_rateFloat64Completion percentage allowed on targets into the player's coverage when in zone coverage.

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

pff_api_facet_defense_coverage_matchup​

League-wide coverage matchup leaderboard

Endpoint URL: GET https://api.pff.com/v1/facet/defense/coverage_matchup

Valid URL: https://api.pff.com/v1/facet/defense/coverage_matchup?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_defense_coverage_matchup(league='nfl', season='2022')

pff_api_facet_defense_pass_rush​

League-wide pass-rush leaderboard

Endpoint URL: GET https://api.pff.com/v1/facet/defense/pass_rush

Valid URL: https://api.pff.com/v1/facet/defense/pass_rush?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_total_pressuresFloat64Total pressures generated (sacks, hits, and hurries) on PFF-designated true pass sets.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
true_pass_set_prpFloat64PFF Pass Rush Productivity rating, pressure generated per pass-rush snap weighted toward sacks on PFF-designated true pass sets.
true_pass_set_hurriesFloat64Quarterback hurries recorded on PFF-designated true pass sets.
team_nameStringTeam abbreviation the player is credited to for the range.
prpFloat64PFF Pass Rush Productivity rating, pressure generated per pass-rush snap weighted toward sacks.
true_pass_set_sacksFloat64Sacks recorded on PFF-designated true pass sets.
pass_rush_win_rateFloat64Percentage of pass-rush snaps with a PFF-charted pass-rush win.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
sacksFloat64Sacks recorded by the pass rusher.
snap_counts_pass_rushFloat64Pass-rush snaps played.
player_game_countFloat64Number of games the player appeared in over the covered span.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
true_pass_set_snap_counts_pass_playFloat64Pass-play snaps on PFF-designated true pass sets.
pass_rush_winsFloat64PFF-charted pass-rush wins.
hurriesFloat64Quarterback hurries recorded.
pass_rush_oppFloat64Pass-rush snaps PFF counts as pressure opportunities.
snap_counts_pass_playFloat64Pass-play snaps.
hitsFloat64Quarterback hits recorded by the pass rusher.
true_pass_set_pass_rush_win_rateFloat64Percentage of pass-rush snaps with a PFF-charted pass-rush win on PFF-designated true pass sets.
penaltiesFloat64Penalties charged to the player over the covered span.
batted_passesFloat64Passes batted down at the line of scrimmage.
true_pass_set_hitsFloat64Quarterback hits recorded on PFF-designated true pass sets.
true_pass_set_snap_counts_pass_rushFloat64Pass-rush snaps played on PFF-designated true pass sets.
teamStringTeam abbreviation the player is credited to for the range.
declined_penaltiesFloat64Penalties committed by the player that were declined.
true_pass_set_pass_rush_winsFloat64PFF-charted pass-rush wins on PFF-designated true pass sets.
total_pressuresFloat64Total pressures generated (sacks, hits, and hurries).
positionStringPFF position code the player is listed at (e.g. QB, HB, FB, WR, TE, T, G, C, ED, DI, LB, CB, S, K, P).
true_pass_set_grades_pass_rush_defenseFloat64PFF pass-rush grade on PFF-designated true pass sets, 0-100.
true_pass_set_batted_passesFloat64Passes batted down at the line of scrimmage on PFF-designated true pass sets.
playerStringPlayer's display name as PFF lists it.
franchise_idFloat64PFF franchise (team) id (integer join key).
pass_rush_percentFloat64Share of pass-play snaps spent rushing the passer.
true_pass_set_pass_rush_oppFloat64Pass-rush snaps PFF counts as pressure opportunities on PFF-designated true pass sets.
true_pass_set_pass_rush_percentFloat64Share of pass-play snaps spent rushing the passer on PFF-designated true pass sets.
grades_pass_rush_defenseFloat64PFF pass-rush grade, 0-100.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).

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

pff_api_facet_defense_run​

League-wide run-defense leaderboard

Endpoint URL: GET https://api.pff.com/v1/facet/defense/run

Valid URL: https://api.pff.com/v1/facet/defense/run?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
assistsFloat64Assisted tackles credited to the player.
avg_depth_of_tackleFloat64Average depth downfield, in yards, at which the player made his tackles on run plays.
declined_penaltiesFloat64Penalties committed by the player that were declined.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
forced_fumblesFloat64Fumbles forced by the player.
franchise_idFloat64PFF franchise (team) id (integer join key).
grades_coverage_defenseFloat64PFF coverage grade, 0-100.
grades_defenseFloat64PFF overall defense grade, 0-100.
grades_defense_penaltyFloat64PFF defensive penalty grade, 0-100.
grades_pass_rush_defenseFloat64PFF pass-rush grade, 0-100.
grades_run_defenseFloat64PFF run-defense grade, 0-100.
grades_tackleFloat64PFF tackling grade, 0-100.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
missed_tackle_rateFloat64Share of tackle attempts the player missed.
missed_tacklesFloat64Missed tackles.
penaltiesFloat64Penalties charged to the player over the covered span.
playerStringPlayer's display name as PFF lists it.
player_game_countFloat64Number of games the player appeared in over the covered span.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
positionStringPFF position code the player is listed at (e.g. QB, HB, FB, WR, TE, T, G, C, ED, DI, LB, CB, S, K, P).
run_stop_oppFloat64Run-defense snaps PFF counts as run-stop opportunities.
snap_counts_runFloat64Run-defense snaps played.
stop_percentFloat64Percentage of run-stop opportunities converted into stops.
stopsFloat64Stops, PFF's tackles that constitute a failed play for the offense.
tacklesFloat64Tackles made by the player, as charted by PFF.
teamStringTeam abbreviation the player is credited to for the range.
team_nameStringTeam abbreviation the player is credited to for the range.

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

pff_api_facet_defense_summary​

League-wide defense summary leaderboard

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

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

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