Skip to main content

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

pff_api_player_seasons​

List the seasons a player has data for

Endpoint URL: GET https://api.pff.com/v1/player/seasons

Valid URL: https://api.pff.com/v1/player/seasons?league=nfl&season=2022&player_id=28022

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug, and the FIRST positional argument of every command that takes one — every command except the facet leaderboards, where --league stays a flag because --game alone is a complete request.
seasonseasonYSeason, as a four-digit year.
weekweekYWeek filter.
player_idplayer_idYPlayer id, taken as a positional argument.

Returns​

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

col_nametypedescription
valueInt64A season (starting year) PFF has data for the player in, newest first.

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

pff_api_player_snaps_summary​

Snap counts for a player, broken out by position

Endpoint URL: GET https://api.pff.com/v1/player/snaps/summary

Valid URL: https://api.pff.com/v1/player/snaps/summary?league=nfl&season=2022&player_id=28022

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug, and the FIRST positional argument of every command that takes one — every command except the facet leaderboards, where --league stays a flag because --game alone is a complete request.
seasonseasonYSeason, as a four-digit year, taken as a positional argument.
weekweekYWeek filter.
player_idplayer_idYPlayer id, taken as a positional argument.

Returns​

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

col_nametypedescription
seasonInt64Season (starting year) the snap totals cover.
snap_counts_coverageInt64Coverage snaps played.
snap_counts_defenseInt64Total defensive snaps played.
snap_counts_field_goalInt64Snaps on the field-goal and extra-point unit.
snap_counts_field_goal_blockingInt64Snaps on the field-goal and extra-point block unit.
snap_counts_field_goal_kickingInt64Field-goal and extra-point snaps spent kicking.
snap_counts_kickoff_coverageInt64Snaps on the kickoff coverage unit.
snap_counts_kickoff_kickingInt64Kickoff snaps spent kicking off.
snap_counts_kickoff_return_blockingInt64Kickoff-return snaps spent blocking.
snap_counts_kickoff_returningInt64Kickoff-return snaps spent as the returner.
snap_counts_offenseInt64Offensive snaps played.
snap_counts_passInt64Pass-play snaps spent as the passer, rather than blocking or running a route.
snap_counts_pass_blockInt64Pass-blocking snaps played.
snap_counts_pass_routeInt64Snaps spent running a pass route.
snap_counts_pass_rushInt64Pass-rush snaps played.
snap_counts_punt_coverageInt64Snaps on the punt coverage unit.
snap_counts_punt_puntingInt64Punt snaps spent punting.
snap_counts_punt_return_blockingInt64Punt-return snaps spent blocking.
snap_counts_punt_returningInt64Punt-return snaps spent as the returner.
snap_counts_runInt64Run-play snaps spent as a runner, rather than run blocking.
snap_counts_run_blockInt64Run-blocking snaps played.
snap_counts_run_defenseInt64Run-defense snaps played.
snap_counts_special_teamsInt64Total special-teams snaps played.

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

pff_api_player_position_pivot​

Player snap counts pivoted by position

Endpoint URL: GET https://api.pff.com/v1/player/position/pivot

Valid URL: https://api.pff.com/v1/player/position/pivot?league=nfl&season=2022&player_id=28022

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug, and the FIRST positional argument of every command that takes one — every command except the facet leaderboards, where --league stays a flag because --game alone is a complete request.
seasonseasonYSeason, as a four-digit year, taken as a positional argument.
weekweekYWeek filter.
player_idplayer_idYPlayer id, taken as a positional argument.

Returns​

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

col_nametypedescription
groupStringDisplay position group (e.g. "QB", "WR"); one row per group.
group_orderInt64Sort order of the group on PFF's page (0 = first).
positionsStringJSON-encoded list of the group's alignments, each with its per-week snap counts by snap type (PFF has no group rollup row: group totals are summed from these weeks).

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

pff_api_player_offense_summary​

Offense summary for one player

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

Valid URL: https://api.pff.com/v1/player/offense/summary?league=nfl&season=2022&player_id=28022

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug, and the FIRST positional argument of every command that takes one — every command except the facet leaderboards, where --league stays a flag because --game alone is a complete request.
seasonseasonYSeason, as a four-digit year.
weekweekYWeek filter.
player_idplayer_idYPlayer id, taken as a positional argument.
careercareerYCareer-aggregate toggle, on the player report operations only.

Returns​

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

col_nametypedescription
away_franchise_idInt64PFF franchise id of the away team.
away_team_nameStringAbbreviation of the away team (e.g. "LV").
declined_penaltiesInt64Penalties committed by the player that were declined.
game_idInt64PFF game id of the game (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).
home_franchise_idInt64PFF franchise id of the home team.
home_team_nameStringAbbreviation of the home team (e.g. "NE").
jersey_numberStringJersey number the player wore in the game (string; zero-padded, e.g. "09").
penaltiesInt64Penalties charged to the player over the covered span.
player_franchise_idInt64PFF franchise id of the team the player played for in the game.
player_idInt64PFF player id (integer join key) of the player the report is about.
positionStringPFF position code the player was charted at in the game (e.g. QB, HB, WR, T, LB, K).
snap_counts_passInt64Pass-play snaps spent as the passer, rather than blocking or running a route.
snap_counts_pass_blockInt64Pass-blocking snaps played.
snap_counts_pass_routeInt64Snaps spent running a pass route.
snap_counts_runInt64Run-play snaps spent as a runner, rather than run blocking.
snap_counts_run_blockInt64Run-blocking snaps played.
snap_counts_totalInt64Total offensive snaps played.
snap_counts_total_passInt64Total pass-play snaps across passing, pass blocking, and route running.
snap_counts_total_runInt64Total run-play snaps across rushing and run blocking.
statusString"S" when the player started the game; PFF owns the value set.
weekInt64Week number of the game, as PFF numbers weeks.
grades_pass_routeFloat64PFF receiving/route grade (0-100).
game_away_franchise_idInt64Repeats away_franchise_id from the row's nested game object: PFF franchise id of the away team.
game_away_team_nameStringRepeats away_team_name from the row's nested game object: Abbreviation of the away team (e.g. "LV").
game_game_idInt64Repeats game_id from the row's nested game object: PFF game id of the game (integer join key).
game_home_franchise_idInt64Repeats home_franchise_id from the row's nested game object: PFF franchise id of the home team.
game_home_team_nameStringRepeats home_team_name from the row's nested game object: Abbreviation of the home team (e.g. "NE").
game_player_franchise_idInt64Repeats player_franchise_id from the row's nested game object: PFF franchise id of the team the player played for in the game.
game_positionStringRepeats position from the row's nested game object: PFF position code the player was charted at in the game (e.g. QB, HB, WR, T, LB, K).
game_statusStringRepeats status from the row's nested game object: "S" when the player started the game; PFF owns the value set.
game_weekInt64Repeats week from the row's nested game object: Week number of the game, as PFF numbers weeks.
league_idInt64PFF league id (1 = NFL, 2 = NCAA), filled from the report's subject.
seasonInt64Season (starting year) of the report, filled from the report's subject.

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

pff_api_player_offense_blocking​

Blocking report for one player

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

Valid URL: https://api.pff.com/v1/player/offense/blocking?league=nfl&season=2022&player_id=28022

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug, and the FIRST positional argument of every command that takes one — every command except the facet leaderboards, where --league stays a flag because --game alone is a complete request.
seasonseasonYSeason, as a four-digit year.
weekweekYWeek filter.
player_idplayer_idYPlayer id, taken as a positional argument.
careercareerYCareer-aggregate toggle, on the player report operations only.

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.
game_idInt64PFF game id of the game (integer join key).
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.
weekInt64Week number of the game, as PFF numbers weeks.
snap_counts_rgInt64Snaps aligned at right guard.
statusString"S" when the player started the game; PFF owns the value set.
jersey_numberStringJersey number the player wore in the game (string; zero-padded, e.g. "09").
snap_counts_ceInt64Snaps aligned at center.
hits_allowedInt64Quarterback hits allowed.
block_percentFloat64Share of offensive snaps spent blocking.
snap_counts_offenseInt64Offensive snaps played.
away_team_nameStringAbbreviation of the away team (e.g. "LV").
snap_counts_blockInt64Total blocking snaps played.
hurries_allowedInt64Quarterback hurries allowed.
player_franchise_idInt64PFF franchise id of the team the player played for in the game.
grades_run_blockFloat64PFF run-blocking grade, 0-100.
snap_counts_run_blockInt64Run-blocking snaps played.
pressures_allowedInt64Total pressures allowed (sacks, hits, and hurries).
snap_counts_pass_playInt64Pass-play snaps.
penaltiesInt64Penalties charged to the player over the covered span.
sacks_allowedInt64Sacks allowed by the player in pass protection.
declined_penaltiesInt64Penalties committed by the player that were declined.
snap_counts_teInt64Snaps aligned at tight end.
snap_counts_rtInt64Snaps aligned at right tackle.
positionStringPFF position code the player was charted at in the game (e.g. QB, HB, WR, T, LB, K).
away_franchise_idInt64PFF franchise id of the away team.
non_spike_pass_blockInt64Pass-blocking snaps excluding spike plays.
snap_counts_ltInt64Snaps aligned at left tackle.
snap_counts_pass_blockInt64Pass-blocking snaps played.
pass_block_percentFloat64Share of pass-play snaps spent pass blocking.
home_franchise_idInt64PFF franchise id of the home team.
home_team_nameStringAbbreviation of the home team (e.g. "NE").
snap_counts_lgInt64Snaps aligned at left guard.
non_spike_passingInt64Non-spike pass-play snaps, the denominator of non_spike_pass_block_percentage.
player_idInt64PFF player id (integer join key) of the player the report is about.
game_away_franchise_idInt64Repeats away_franchise_id from the row's nested game object: PFF franchise id of the away team.
game_away_team_nameStringRepeats away_team_name from the row's nested game object: Abbreviation of the away team (e.g. "LV").
game_game_idInt64Repeats game_id from the row's nested game object: PFF game id of the game (integer join key).
game_home_franchise_idInt64Repeats home_franchise_id from the row's nested game object: PFF franchise id of the home team.
game_home_team_nameStringRepeats home_team_name from the row's nested game object: Abbreviation of the home team (e.g. "NE").
game_player_franchise_idInt64Repeats player_franchise_id from the row's nested game object: PFF franchise id of the team the player played for in the game.
game_positionStringRepeats position from the row's nested game object: PFF position code the player was charted at in the game (e.g. QB, HB, WR, T, LB, K).
game_statusStringRepeats status from the row's nested game object: "S" when the player started the game; PFF owns the value set.
game_weekInt64Repeats week from the row's nested game object: Week number of the game, as PFF numbers weeks.
league_idInt64PFF league id (1 = NFL, 2 = NCAA), filled from the report's subject.
seasonInt64Season (starting year) of the report, filled from the report's subject.

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

pff_api_player_offense_pass_blocking​

Pass-blocking report for one player

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

Valid URL: https://api.pff.com/v1/player/offense/pass_blocking?league=nfl&season=2022&player_id=28022

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug, and the FIRST positional argument of every command that takes one — every command except the facet leaderboards, where --league stays a flag because --game alone is a complete request.
seasonseasonYSeason, as a four-digit year.
weekweekYWeek filter.
player_idplayer_idYPlayer id, taken as a positional argument.
careercareerYCareer-aggregate toggle, on the player report operations only.

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_allowedInt64Total 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.
game_idInt64PFF game id of the game (integer join key).
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.
weekInt64Week number of the game, as PFF numbers weeks.
statusString"S" when the player started the game; PFF owns the value set.
jersey_numberStringJersey number the player wore in the game (string; zero-padded, e.g. "09").
true_pass_set_non_spike_passingInt64Non-spike pass-play snaps on PFF-designated true pass sets, the denominator of true_pass_set_non_spike_pass_block_percentage.
hits_allowedInt64Quarterback hits allowed.
true_pass_set_non_spike_pass_blockInt64Pass-blocking snaps excluding spike plays on PFF-designated true pass sets.
away_team_nameStringAbbreviation of the away team (e.g. "LV").
hurries_allowedInt64Quarterback hurries allowed.
true_pass_set_hurries_allowedInt64Quarterback hurries allowed on PFF-designated true pass sets.
player_franchise_idInt64PFF franchise id of the team the player played for in the game.
true_pass_set_snap_counts_pass_playInt64Pass-play snaps on PFF-designated true pass sets.
true_pass_set_hits_allowedInt64Quarterback hits allowed on PFF-designated true pass sets.
pressures_allowedInt64Total 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_playInt64Pass-play snaps.
penaltiesInt64Penalties charged to the player over the covered span.
sacks_allowedInt64Sacks allowed by the player in pass protection.
declined_penaltiesInt64Penalties committed by the player that were declined.
positionStringPFF position code the player was charted at in the game (e.g. QB, HB, WR, T, LB, K).
away_franchise_idInt64PFF franchise id of the away team.
non_spike_pass_blockInt64Pass-blocking snaps excluding spike plays.
true_pass_set_snap_counts_pass_blockInt64Pass-blocking snaps played on PFF-designated true pass sets.
true_pass_set_sacks_allowedInt64Sacks allowed on PFF-designated true pass sets.
snap_counts_pass_blockInt64Pass-blocking snaps played.
pass_block_percentFloat64Share of pass-play snaps spent pass blocking.
home_franchise_idInt64PFF franchise id of the home team.
home_team_nameStringAbbreviation of the home team (e.g. "NE").
non_spike_passingInt64Non-spike pass-play snaps, the denominator of non_spike_pass_block_percentage.
player_idInt64PFF player id (integer join key) of the player the report is about.
game_away_franchise_idInt64Repeats away_franchise_id from the row's nested game object: PFF franchise id of the away team.
game_away_team_nameStringRepeats away_team_name from the row's nested game object: Abbreviation of the away team (e.g. "LV").
game_game_idInt64Repeats game_id from the row's nested game object: PFF game id of the game (integer join key).
game_home_franchise_idInt64Repeats home_franchise_id from the row's nested game object: PFF franchise id of the home team.
game_home_team_nameStringRepeats home_team_name from the row's nested game object: Abbreviation of the home team (e.g. "NE").
game_player_franchise_idInt64Repeats player_franchise_id from the row's nested game object: PFF franchise id of the team the player played for in the game.
game_positionStringRepeats position from the row's nested game object: PFF position code the player was charted at in the game (e.g. QB, HB, WR, T, LB, K).
game_statusStringRepeats status from the row's nested game object: "S" when the player started the game; PFF owns the value set.
game_weekInt64Repeats week from the row's nested game object: Week number of the game, as PFF numbers weeks.
league_idInt64PFF league id (1 = NFL, 2 = NCAA), filled from the report's subject.
seasonInt64Season (starting year) of the report, filled from the report's subject.

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

pff_api_player_offense_run_blocking​

Run-blocking report for one player

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

Valid URL: https://api.pff.com/v1/player/offense/run_blocking?league=nfl&season=2022&player_id=28022

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug, and the FIRST positional argument of every command that takes one — every command except the facet leaderboards, where --league stays a flag because --game alone is a complete request.
seasonseasonYSeason, as a four-digit year.
weekweekYWeek filter.
player_idplayer_idYPlayer id, taken as a positional argument.
careercareerYCareer-aggregate toggle, on the player report operations only.

Returns​

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

col_nametypedescription
away_franchise_idInt64PFF franchise id of the away team.
away_team_nameStringAbbreviation of the away team (e.g. "LV").
declined_penaltiesInt64Penalties committed by the player that were declined.
game_idInt64PFF game id of the game (integer join key).
gap_run_block_percentFloat64Share of run-play snaps spent run blocking on gap-scheme runs.
gap_snap_counts_run_blockInt64Run-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_playInt64Run-play snaps on gap-scheme runs.
grades_run_blockFloat64PFF run-blocking grade, 0-100.
home_franchise_idInt64PFF franchise id of the home team.
home_team_nameStringAbbreviation of the home team (e.g. "NE").
jersey_numberStringJersey number the player wore in the game (string; zero-padded, e.g. "09").
penaltiesInt64Penalties charged to the player over the covered span.
player_franchise_idInt64PFF franchise id of the team the player played for in the game.
player_idInt64PFF player id (integer join key) of the player the report is about.
positionStringPFF position code the player was charted at in the game (e.g. QB, HB, WR, T, LB, K).
run_block_percentFloat64Share of run-play snaps spent run blocking.
snap_counts_run_blockInt64Run-blocking snaps played.
snap_counts_run_playInt64Run-play snaps.
statusString"S" when the player started the game; PFF owns the value set.
weekInt64Week number of the game, as PFF numbers weeks.
zone_run_block_percentFloat64Share of run-play snaps spent run blocking on zone-scheme runs.
zone_snap_counts_run_blockInt64Run-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_playInt64Run-play snaps on zone-scheme runs.
game_away_franchise_idInt64Repeats away_franchise_id from the row's nested game object: PFF franchise id of the away team.
game_away_team_nameStringRepeats away_team_name from the row's nested game object: Abbreviation of the away team (e.g. "LV").
game_game_idInt64Repeats game_id from the row's nested game object: PFF game id of the game (integer join key).
game_home_franchise_idInt64Repeats home_franchise_id from the row's nested game object: PFF franchise id of the home team.
game_home_team_nameStringRepeats home_team_name from the row's nested game object: Abbreviation of the home team (e.g. "NE").
game_player_franchise_idInt64Repeats player_franchise_id from the row's nested game object: PFF franchise id of the team the player played for in the game.
game_positionStringRepeats position from the row's nested game object: PFF position code the player was charted at in the game (e.g. QB, HB, WR, T, LB, K).
game_statusStringRepeats status from the row's nested game object: "S" when the player started the game; PFF owns the value set.
game_weekInt64Repeats week from the row's nested game object: Week number of the game, as PFF numbers weeks.
league_idInt64PFF league id (1 = NFL, 2 = NCAA), filled from the report's subject.
seasonInt64Season (starting year) of the report, filled from the report's subject.

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

pff_api_player_passing_summary​

Passing summary for one player

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

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

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug, and the FIRST positional argument of every command that takes one — every command except the facet leaderboards, where --league stays a flag because --game alone is a complete request.
seasonseasonYSeason, as a four-digit year.
weekweekYWeek filter.
player_idplayer_idYPlayer id, taken as a positional argument.
careercareerYCareer-aggregate toggle, on the player report operations only.

Returns​

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

col_nametypedescription
grades_offenseFloat64PFF overall offense grade (0-100).
twp_rateFloat64Turnover-worthy-play rate.
game_idInt64PFF game id of the game (integer join key).
btt_rateFloat64Big-time-throw rate.
spikesInt64Clock-stopping spike plays.
dropbacksInt64Total quarterback dropbacks.
all_attemptsInt64All pass attempts on the player's passing snaps; attempts counts a subset of these.
thrown_awaysInt64Passes intentionally thrown away.
weekInt64Week number of the game, as PFF numbers weeks.
statusString"S" when the player started the game; PFF owns the value set.
all_dropbacksInt64All dropbacks, equal to passing_snaps; dropbacks counts a subset of these.
grades_passFloat64PFF passing grade (0-100).
ttt_total_timeFloat64Time to throw summed over the passer's dropbacks, in seconds (avg_time_to_throw = ttt_total_time / dropbacks).
hit_as_threwInt64Plays where the quarterback was hit as he threw.
first_downsInt64Passing first downs.
jersey_numberStringJersey number the player wore in the game (string; zero-padded, e.g. "09").
sack_percentFloat64Sack rate (sacks per dropback).
batsInt64Passes batted at the line.
away_team_nameStringAbbreviation of the away team (e.g. "LV").
sacksInt64Times the passer was sacked.
completionsInt64Completed passes by the passer.
yardsInt64Total passing yards gained.
player_franchise_idInt64PFF franchise id of the team the player played for in the game.
accuracy_percentFloat64Charted accuracy percentage.
scramblesInt64Scramble plays.
interceptionsInt64Interceptions thrown.
positive_epa_playsInt64Plays with positive expected points added (positive_epa_percent = positive_epa_plays / plays_with_epa x 100).
drop_rateFloat64Receiver drop rate on the quarterback's throws.
grades_runFloat64PFF rushing grade (0-100).
qb_ratingFloat64NFL passer rating.
completion_percentFloat64Completion percentage.
plays_with_epaInt64Plays with an expected-points-added value, the denominator of positive_epa_percent.
penaltiesInt64Penalties charged.
attemptsInt64Pass attempts thrown by the passer.
declined_penaltiesInt64Declined penalties.
passing_snapsInt64Number of passing snaps played.
pressure_to_sack_rateFloat64Percentage of pressured dropbacks that ended in a sack.
ypaFloat64Yards gained per pass attempt.
dropsInt64Passes dropped by the passer's receivers.
positionStringPFF position code the player was charted at in the game (e.g. QB, HB, WR, T, LB, K).
grades_hands_fumbleFloat64PFF hands (fumble) grade for the player, reflecting ball security (0-100).
avg_time_to_throwFloat64Average time to throw per dropback, in seconds from snap to release (ttt_total_time / dropbacks).
away_franchise_idInt64PFF franchise id of the away team.
big_time_throwsInt64Number of big-time throws, per PFF's highest-value, highest-difficulty throw designation.
positive_epa_percentFloat64Percentage of dropbacks with positive expected points added.
home_franchise_idInt64PFF franchise id of the home team.
home_team_nameStringAbbreviation of the home team (e.g. "NE").
avg_depth_of_targetFloat64Average depth of target in air yards.
turnover_worthy_playsInt64Number of turnover-worthy plays, plays PFF charts as deserving of a turnover.
epaFloat64Expected points added per play on the passer's dropbacks, as computed by PFF (an average such as 0.14, not a total).
aimed_passesInt64Aimed passes: attempts excluding throwaways, spikes, batted passes and throws made while hit (the accuracy_percent denominator).
player_idInt64PFF player id (integer join key) of the player the report is about.
touchdownsInt64Number of passing touchdowns thrown.
def_gen_pressuresInt64Number of defense-generated pressures on the player's dropbacks, as charted by PFF.
game_away_franchise_idInt64Repeats away_franchise_id from the row's nested game object: PFF franchise id of the away team.
game_away_team_nameStringRepeats away_team_name from the row's nested game object: Abbreviation of the away team (e.g. "LV").
game_game_idInt64Repeats game_id from the row's nested game object: PFF game id of the game (integer join key).
game_home_franchise_idInt64Repeats home_franchise_id from the row's nested game object: PFF franchise id of the home team.
game_home_team_nameStringRepeats home_team_name from the row's nested game object: Abbreviation of the home team (e.g. "NE").
game_player_franchise_idInt64Repeats player_franchise_id from the row's nested game object: PFF franchise id of the team the player played for in the game.
game_positionStringRepeats position from the row's nested game object: PFF position code the player was charted at in the game (e.g. QB, HB, WR, T, LB, K).
game_statusStringRepeats status from the row's nested game object: "S" when the player started the game; PFF owns the value set.
game_weekInt64Repeats week from the row's nested game object: Week number of the game, as PFF numbers weeks.
league_idInt64PFF league id (1 = NFL, 2 = NCAA), filled from the report's subject.
seasonInt64Season (starting year) of the report, filled from the report's subject.

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

pff_api_player_passing_concept​

Passing by play concept for one player

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

Valid URL: https://api.pff.com/v1/player/passing/concept?league=nfl&season=2022&player_id=28022

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug, and the FIRST positional argument of every command that takes one — every command except the facet leaderboards, where --league stays a flag because --game alone is a complete request.
seasonseasonYSeason, as a four-digit year, taken as a positional argument.
weekweekYWeek filter.
player_idplayer_idYPlayer id, taken as a positional argument.
careercareerYCareer-aggregate toggle, on the player report operations only.

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