Skip to main content

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

pff_api_player_passing_pressure​

Passing under pressure for one player

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

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

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

Raises​

ExceptionDescription
RuntimeErrorNo PFF API key (pass api_key= or set PFF_API_KEY).
NoDataErrorThe host answered 404 -- the requested resource does not exist. PFF answered 404 (no such route, report or team).
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. The request was refused or failed (401/403/429/5xx) -- the answer is unknown, never an empty frame.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help. PFF rejected the parameters (400 invalid_parameter / 422).

Example​

pff_api_player_passing_pressure(league='nfl', player_id=28022, season=2022)

pff_api_player_rushing_direction​

Rushing by direction for one player

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

Valid URL: https://api.pff.com/v1/player/rushing/direction?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
attemptsInt64Rushing attempts in this direction.
directionStringRun direction / gap of the split, PFF's own vocabulary (e.g. "LT", "LG", "ML", "RG", "RE", "QBSc").
explosiveInt64Runs in this direction PFF designates as explosive.
first_downsInt64Rushing first downs gained in this direction.
franchise_idInt64PFF franchise id of the runner's team.
fumblesInt64Fumbles on runs in this direction.
longInt64Longest run in this direction, in yards.
missed_tacklesInt64Missed tackles forced on runs in this direction.
player_idInt64PFF player id of the runner.
team_nameStringAbbreviation of the runner's team (e.g. "BUF").
touchdownsInt64Rushing touchdowns in this direction.
yardsInt64Rushing yards gained in this direction.
yards_after_contactInt64Yards after contact on runs in this direction.
yco_attemptFloat64Average yards after contact per attempt in this direction.
ypaFloat64Yards per rushing attempt in this direction.

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

pff_api_player_rushing_summary​

Rushing summary for one player

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

Valid URL: https://api.pff.com/v1/player/rushing/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
targetsInt64Passes thrown to the ball carrier (targets).
grades_offenseFloat64PFF overall offense grade (0-100).
game_idInt64PFF game id of the game (integer join key).
yards_after_contactInt64Yards after contact.
explosiveInt64Runs PFF designates as explosive.
weekInt64Week number of the game, as PFF numbers weeks.
elu_rush_mtfInt64Missed tackles forced as a rusher, an input to PFF's elusive rating.
breakaway_attemptsInt64Runs of 15 or more yards, PFF's breakaway designation.
statusString"S" when the player started the game; PFF owns the value set.
designed_yardsInt64Rushing yards gained on designed runs, excluding scrambles.
yprrFloat64Yards per route run.
breakaway_percentFloat64Share of rushing yards gained on breakaway runs of 15 or more yards.
fumblesInt64Fumbles by the ball carrier.
first_downsInt64Rushing first downs.
elusive_ratingFloat64PFF elusive rating.
jersey_numberStringJersey number the player wore in the game (string; zero-padded, e.g. "09").
breakaway_yardsInt64Breakaway (long-run) yards.
away_team_nameStringAbbreviation of the away team (e.g. "LV").
total_touchesInt64Combined carries and receptions.
scramble_yardsInt64Rushing yards gained on scrambles.
yco_attemptFloat64Average yards after contact per rushing attempt.
yardsInt64Total rushing yards gained.
player_franchise_idInt64PFF franchise id of the team the player played for in the game.
grades_run_blockFloat64PFF run-blocking grade, 0-100.
receptionsInt64Passes caught by the ball carrier.
zone_attemptsInt64Rushing attempts on zone-scheme runs.
scramblesInt64Quarterback scrambles.
grades_runFloat64PFF rushing grade (0-100).
penaltiesInt64Penalties charged to the player over the covered span.
attemptsInt64Rushing attempts (carries) by the runner.
elu_ycoInt64Yards-after-contact component used in PFF's elusive rating.
elu_recv_mtfInt64Missed tackles forced as a receiver, an input to PFF's elusive rating.
declined_penaltiesInt64Penalties committed by the player that were declined.
ypaFloat64Average yards per rushing attempt.
dropsInt64Passes dropped by the ball carrier.
positionStringPFF position code the player was charted at in the game (e.g. QB, HB, WR, T, LB, K).
grades_hands_fumbleFloat64PFF ball-security (hands/fumble) grade, 0-100.
longestInt64Longest run in yards.
away_franchise_idInt64PFF franchise id of the away team.
count_of_yardsInt64Rushing attempts counted toward the yardage figures (equal to attempts in the captured rows).
routesInt64Pass routes run by the player.
rec_yardsInt64Receiving yards gained by the ball carrier (the rushing report also carries his receiving line).
home_franchise_idInt64PFF franchise id of the home team.
gap_attemptsInt64Rushing attempts on gap-scheme runs.
run_playsInt64Run-play snaps.
home_team_nameStringAbbreviation of the home team (e.g. "NE").
avoided_tacklesInt64Missed tackles forced.
grades_offense_penaltyFloat64PFF offensive penalty grade, 0-100.
player_idInt64PFF player id (integer join key) of the player the report is about.
touchdownsInt64Rushing touchdowns.
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_rushing_summary(league='nfl', player_id=28022, season=2022)