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_percentnumericPercentage of pass attempts completed when not blitzed.
grades_offensenumericPFF overall offense grade for the player (0-100).
no_pressure_scramblesnumericNumber of scrambles from a clean pocket (no pressure).
blitz_touchdownsnumericNumber of passing touchdowns thrown when blitzed.
pressure_yardsnumericPassing yards gained when under pressure.
no_pressure_spikesnumericNumber of clock-stopping spikes from a clean pocket (no pressure).
blitz_ypanumericYards gained per pass attempt when blitzed.
no_blitz_grades_runnumericPFF rushing grade for the player (0-100) when not blitzed.
blitz_qb_ratingnumericTraditional NFL passer rating when blitzed.
no_pressure_thrown_awaysnumericNumber of intentional throwaways from a clean pocket (no pressure).
no_blitz_batsnumericNumber of pass attempts batted down at the line of scrimmage when not blitzed.
no_blitz_dropsnumericNumber of catchable passes dropped by receivers when not blitzed.
no_pressure_completion_percentnumericPercentage of pass attempts completed from a clean pocket (no pressure).
blitz_aimed_passesnumericNumber of aimed passes (attempts excluding spikes and throwaways) when blitzed, as charted by PFF.
pressure_grades_runnumericPFF rushing grade for the player (0-100) when under pressure.
no_blitz_sack_percentnumericPercentage of dropbacks that ended in a sack when not blitzed.
no_pressure_batsnumericNumber of pass attempts batted down at the line of scrimmage from a clean pocket (no pressure).
pressure_completionsnumericNumber of completed passes when under pressure.
blitz_big_time_throwsnumericNumber of big-time throws when blitzed, per PFF's highest-value, highest-difficulty throw designation.
no_blitz_drop_ratenumericPercentage of catchable passes dropped by receivers when not blitzed.
blitz_spikesnumericNumber of clock-stopping spikes when blitzed.
no_pressure_completionsnumericNumber of completed passes from a clean pocket (no pressure).
draft_seasonnumericNFL season (year) in which the player was drafted, per PFF player metadata.
no_pressure_passing_snapsnumericNumber of passing snaps played from a clean pocket (no pressure).
no_blitz_first_downsnumericNumber of passing first downs gained when not blitzed.
blitz_avg_time_to_thrownumericAverage time from snap to release in seconds when blitzed.
no_pressure_grades_hands_fumblenumericPFF hands (fumble) grade for the player, reflecting ball security (0-100) from a clean pocket (no pressure).
pressure_aimed_passesnumericNumber of aimed passes (attempts excluding spikes and throwaways) when under pressure, as charted by PFF.
blitz_sacksnumericNumber of sacks taken when blitzed.
no_pressure_interceptionsnumericNumber of passes intercepted from a clean pocket (no pressure).
team_namecharacterTeam abbreviation the player is credited to for the range.
pressure_epanumericTotal expected points added (EPA) on the player's dropbacks when under pressure.
blitz_completionsnumericNumber of completed passes when blitzed.
blitz_attemptsnumericNumber of pass attempts when blitzed.
pressure_twp_ratenumericTurnover-worthy plays as a percentage of qualifying attempts when under pressure, per PFF charting.
pressure_sacksnumericNumber of sacks taken when under pressure.
no_blitz_pressure_to_sack_ratenumericPercentage of pressured dropbacks that ended in a sack when not blitzed.
no_pressure_ypanumericYards gained per pass attempt from a clean pocket (no pressure).
pressure_passing_snapsnumericNumber of passing snaps played when under pressure.
grades_passnumericPFF passing grade (0-100).
pressure_batsnumericNumber of pass attempts batted down at the line of scrimmage when under pressure.
blitz_thrown_awaysnumericNumber of intentional throwaways when blitzed.
no_pressure_dropsnumericNumber of catchable passes dropped by receivers from a clean pocket (no pressure).
jersey_numbercharacterJersey number (string; zero-padded, e.g. "09").
pressure_grades_offense_penaltynumericPFF offensive penalty grade for the player (0-100) when under pressure.
pressure_scramblesnumericNumber of scrambles when under pressure.
blitz_drop_ratenumericPercentage of catchable passes dropped by receivers when blitzed.
pressure_grades_pass_routenumericPFF receiving (route) grade for the player (0-100) when under pressure.
blitz_completion_percentnumericPercentage of pass attempts completed when blitzed.
no_pressure_first_downsnumericNumber of passing first downs gained from a clean pocket (no pressure).
blitz_grades_offense_penaltynumericPFF offensive penalty grade for the player (0-100) when blitzed.
no_blitz_epanumericTotal expected points added (EPA) on the player's dropbacks when not blitzed.
blitz_interceptionsnumericNumber of passes intercepted when blitzed.
no_blitz_dropbacksnumericNumber of dropbacks when not blitzed.
no_blitz_grades_passnumericPFF passing grade (0-100) when not blitzed.
no_blitz_scramblesnumericNumber of scrambles when not blitzed.
pressure_drop_ratenumericPercentage of catchable passes dropped by receivers when under pressure.
no_blitz_yardsnumericPassing yards gained when not blitzed.
base_dropbacksnumericNumber of dropbacks across all splits, the baseline total for this facet.
pressure_pressure_to_sack_ratenumericPercentage of pressured dropbacks that ended in a sack, reported within the pressure split.
no_blitz_grades_hands_fumblenumericPFF hands (fumble) grade for the player, reflecting ball security (0-100) when not blitzed.
no_pressure_grades_offensenumericPFF overall offense grade for the player (0-100) from a clean pocket (no pressure).
no_pressure_avg_time_to_thrownumericAverage time from snap to release in seconds from a clean pocket (no pressure).
pressure_dropbacksnumericNumber of dropbacks when under pressure.
no_blitz_grades_offense_penaltynumericPFF offensive penalty grade for the player (0-100) when not blitzed.
no_pressure_grades_runnumericPFF rushing grade for the player (0-100) from a clean pocket (no pressure).
player_game_countnumericNumber of games the player appeared in during the period covered.
blitz_turnover_worthy_playsnumericNumber of turnover-worthy plays when blitzed, plays PFF charts as deserving of a turnover.
no_blitz_touchdownsnumericNumber of passing touchdowns thrown when not blitzed.
no_blitz_avg_depth_of_targetnumericAverage depth of target in air yards when not blitzed.
no_pressure_dropbacks_percentnumericShare of the player's total dropbacks that came from a clean pocket (no pressure), expressed as a percentage.
blitz_grades_passnumericPFF passing grade (0-100) when blitzed.
eligible_seasonnumericSeason (year) of the player's NFL draft eligibility, per PFF player metadata.
blitz_avg_depth_of_targetnumericAverage depth of target in air yards when blitzed.
no_blitz_spikesnumericNumber of clock-stopping spikes when not blitzed.
no_pressure_dropbacksnumericNumber of dropbacks from a clean pocket (no pressure).
blitz_btt_ratenumericBig-time throws as a percentage of qualifying attempts when blitzed, per PFF charting.
blitz_positive_epa_percentnumericPercentage of dropbacks with positive expected points added when blitzed.
no_pressure_btt_ratenumericBig-time throws as a percentage of qualifying attempts from a clean pocket (no pressure), per PFF charting.
no_pressure_drop_ratenumericPercentage of catchable passes dropped by receivers from a clean pocket (no pressure).
no_blitz_turnover_worthy_playsnumericNumber of turnover-worthy plays when not blitzed, plays PFF charts as deserving of a turnover.
pressure_positive_epa_percentnumericPercentage of dropbacks with positive expected points added when under pressure.
blitz_first_downsnumericNumber of passing first downs gained when blitzed.
no_blitz_dropbacks_percentnumericShare of the player's total dropbacks that came when not blitzed, expressed as a percentage.
pressure_turnover_worthy_playsnumericNumber of turnover-worthy plays when under pressure, plays PFF charts as deserving of a turnover.
no_pressure_epanumericTotal expected points added (EPA) on the player's dropbacks from a clean pocket (no pressure).
no_blitz_avg_time_to_thrownumericAverage time from snap to release in seconds when not blitzed.
no_blitz_positive_epa_percentnumericPercentage of dropbacks with positive expected points added when not blitzed.
pressure_btt_ratenumericBig-time throws as a percentage of qualifying attempts when under pressure, per PFF charting.
no_pressure_aimed_passesnumericNumber of aimed passes (attempts excluding spikes and throwaways) from a clean pocket (no pressure), as charted by PFF.
pressure_dropbacks_percentnumericShare of the player's total dropbacks that came when under pressure, expressed as a percentage.
grades_runnumericPFF rushing grade for the player (0-100).
no_pressure_def_gen_pressuresnumericNumber of defense-generated pressures on the player's dropbacks from a clean pocket (no pressure), as charted by PFF.
pressure_grades_offensenumericPFF overall offense grade for the player (0-100) when under pressure.
pressure_completion_percentnumericPercentage of pass attempts completed when under pressure.
pressure_avg_depth_of_targetnumericAverage depth of target in air yards when under pressure.
blitz_epanumericTotal expected points added (EPA) on the player's dropbacks when blitzed.
pressure_dropsnumericNumber of catchable passes dropped by receivers when under pressure.
no_blitz_def_gen_pressuresnumericNumber of defense-generated pressures on the player's dropbacks when not blitzed, as charted by PFF.
pressure_attemptsnumericNumber of pass attempts when under pressure.
pressure_big_time_throwsnumericNumber of big-time throws when under pressure, per PFF's highest-value, highest-difficulty throw designation.
no_blitz_thrown_awaysnumericNumber of intentional throwaways when not blitzed.
blitz_dropsnumericNumber of catchable passes dropped by receivers when blitzed.
no_pressure_touchdownsnumericNumber of passing touchdowns thrown from a clean pocket (no pressure).
no_pressure_sacksnumericNumber of sacks taken from a clean pocket (no pressure).
blitz_sack_percentnumericPercentage of dropbacks that ended in a sack when blitzed.
pressure_sack_percentnumericPercentage of dropbacks that ended in a sack when under pressure.
penaltiesnumericPenalties charged to the player over the covered span.
no_pressure_attemptsnumericNumber of pass attempts from a clean pocket (no pressure).
no_blitz_grades_offensenumericPFF overall offense grade for the player (0-100) when not blitzed.
blitz_scramblesnumericNumber of scrambles when blitzed.
blitz_dropbacks_percentnumericShare of the player's total dropbacks that came when blitzed, expressed as a percentage.
no_pressure_qb_ratingnumericTraditional NFL passer rating from a clean pocket (no pressure).
no_blitz_passing_snapsnumericNumber of passing snaps played when not blitzed.
no_blitz_aimed_passesnumericNumber of aimed passes (attempts excluding spikes and throwaways) when not blitzed, as charted by PFF.
blitz_yardsnumericPassing yards gained when blitzed.
teamcharacterTeam abbreviation the player is credited to for the range.
no_blitz_attemptsnumericNumber of pass attempts when not blitzed.
pressure_accuracy_percentnumericPercentage of aimed passes charted as accurate by PFF when under pressure.
no_blitz_hit_as_threwnumericNumber of attempts on which the passer was hit as he threw when not blitzed, as charted by PFF.
pressure_hit_as_threwnumericNumber of attempts on which the passer was hit as he threw when under pressure, as charted by PFF.
blitz_pressure_to_sack_ratenumericPercentage of pressured dropbacks that ended in a sack when blitzed.
declined_penaltiesnumericNumber of declined penalties committed by the player.
no_blitz_btt_ratenumericBig-time throws as a percentage of qualifying attempts when not blitzed, per PFF charting.
no_blitz_ypanumericYards gained per pass attempt when not blitzed.
blitz_grades_runnumericPFF rushing grade for the player (0-100) when blitzed.
pressure_interceptionsnumericNumber of passes intercepted when under pressure.
blitz_grades_hands_fumblenumericPFF hands (fumble) grade for the player, reflecting ball security (0-100) when blitzed.
no_pressure_grades_offense_penaltynumericPFF offensive penalty grade for the player (0-100) from a clean pocket (no pressure).
positioncharacterPFF 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_offensenumericPFF overall offense grade for the player (0-100) when blitzed.
grades_hands_fumblenumericPFF hands (fumble) grade for the player, reflecting ball security (0-100).
pressure_def_gen_pressuresnumericNumber of defense-generated pressures on the player's dropbacks when under pressure, as charted by PFF.
pressure_grades_passnumericPFF passing grade (0-100) when under pressure.
no_blitz_qb_ratingnumericTraditional NFL passer rating when not blitzed.
blitz_hit_as_threwnumericNumber of attempts on which the passer was hit as he threw when blitzed, as charted by PFF.
pressure_ypanumericYards gained per pass attempt when under pressure.
blitz_grades_pass_routenumericPFF receiving (route) grade for the player (0-100) when blitzed.
pressure_avg_time_to_thrownumericAverage time from snap to release in seconds when under pressure.
no_blitz_completionsnumericNumber of completed passes when not blitzed.
no_pressure_grades_pass_routenumericPFF receiving (route) grade for the player (0-100) from a clean pocket (no pressure).
no_pressure_sack_percentnumericPercentage of dropbacks that ended in a sack from a clean pocket (no pressure).
playercharacterPlayer's display name as PFF lists it.
no_blitz_accuracy_percentnumericPercentage of aimed passes charted as accurate by PFF when not blitzed.
no_pressure_pressure_to_sack_ratecharacterPressure-to-sack rate as reported within the no-pressure split of the PFF passing-pressure facet.
no_pressure_turnover_worthy_playsnumericNumber of turnover-worthy plays from a clean pocket (no pressure), plays PFF charts as deserving of a turnover.
pressure_first_downsnumericNumber of passing first downs gained when under pressure.
blitz_passing_snapsnumericNumber of passing snaps played when blitzed.
franchise_idnumericPFF franchise (team) id (integer join key).
no_pressure_twp_ratenumericTurnover-worthy plays as a percentage of qualifying attempts from a clean pocket (no pressure), per PFF charting.
no_blitz_sacksnumericNumber of sacks taken when not blitzed.
no_blitz_grades_pass_routenumericPFF receiving (route) grade for the player (0-100) when not blitzed.
no_pressure_accuracy_percentnumericPercentage of aimed passes charted as accurate by PFF from a clean pocket (no pressure).
no_blitz_twp_ratenumericTurnover-worthy plays as a percentage of qualifying attempts when not blitzed, per PFF charting.
no_pressure_hit_as_threwnumericNumber of attempts on which the passer was hit as he threw from a clean pocket (no pressure), as charted by PFF.
no_pressure_grades_passnumericPFF passing grade (0-100) from a clean pocket (no pressure).
no_pressure_positive_epa_percentnumericPercentage of dropbacks with positive expected points added from a clean pocket (no pressure).
pressure_spikesnumericNumber of clock-stopping spikes when under pressure.
pressure_grades_hands_fumblenumericPFF hands (fumble) grade for the player, reflecting ball security (0-100) when under pressure.
pressure_qb_ratingnumericTraditional NFL passer rating when under pressure.
blitz_batsnumericNumber of pass attempts batted down at the line of scrimmage when blitzed.
pressure_touchdownsnumericNumber of passing touchdowns thrown when under pressure.
pressure_thrown_awaysnumericNumber of intentional throwaways when under pressure.
no_blitz_interceptionsnumericNumber of passes intercepted when not blitzed.
blitz_dropbacksnumericNumber of dropbacks when blitzed.
blitz_def_gen_pressuresnumericNumber of defense-generated pressures on the player's dropbacks when blitzed, as charted by PFF.
player_idnumericPFF player id (integer; matches the /players id and every player_id join key).
no_blitz_big_time_throwsnumericNumber of big-time throws when not blitzed, per PFF's highest-value, highest-difficulty throw designation.
no_pressure_avg_depth_of_targetnumericAverage depth of target in air yards from a clean pocket (no pressure).
no_pressure_yardsnumericPassing yards gained from a clean pocket (no pressure).
blitz_twp_ratenumericTurnover-worthy plays as a percentage of qualifying attempts when blitzed, per PFF charting.
blitz_accuracy_percentnumericPercentage of aimed passes charted as accurate by PFF when blitzed.
no_pressure_big_time_throwsnumericNumber of big-time throws from a clean pocket (no pressure), per PFF's highest-value, highest-difficulty throw designation.
no_blitz_grades_pass_blocknumericPFF pass-blocking grade for the player (0-100) when not blitzed.
blitz_grades_pass_blocknumericPFF pass-blocking grade for the player (0-100) when blitzed.
no_pressure_grades_pass_blocknumericPFF pass-blocking grade for the player (0-100) from a clean pocket (no pressure).
pressure_grades_pass_blocknumericPFF pass-blocking grade for the player (0-100) when under pressure.
no_pressure_grades_hands_dropnumericPFF hands (drop) grade for the player (0-100) from a clean pocket (no pressure).
blitz_grades_hands_dropnumericPFF hands (drop) grade for the player (0-100) when blitzed.
pressure_grades_hands_dropnumericPFF hands (drop) grade for the player (0-100) when under pressure.
no_blitz_grades_hands_dropnumericPFF hands (drop) grade for the player (0-100) when not blitzed.
blitz_grades_run_blocknumericPFF run-blocking grade for the player (0-100) when blitzed.
no_pressure_grades_run_blocknumericPFF run-blocking grade for the player (0-100) from a clean pocket (no pressure).
no_blitz_grades_run_blocknumericPFF run-blocking grade for the player (0-100) when not blitzed.
blitz_grades_screen_blocknumericPFF screen-blocking grade for the player (0-100) when blitzed.
pressure_grades_screen_blocknumericPFF screen-blocking grade for the player (0-100) when under pressure.
no_blitz_grades_screen_blocknumericPFF screen-blocking grade for the player (0-100) when not blitzed.
pressure_grades_run_blocknumericPFF run-blocking grade for the player (0-100) when under pressure.
no_pressure_grades_screen_blocknumericPFF screen-blocking grade for the player (0-100) from a clean pocket (no pressure).
pressure_grades_coverage_defensenumericPFF coverage grade for the player (0-100) when under pressure.
pressure_grades_defensenumericPFF overall defense grade for the player (0-100) when under pressure.
no_blitz_grades_defensenumericPFF overall defense grade for the player (0-100) when not blitzed.
no_blitz_grades_defense_penaltynumericPFF defensive penalty grade for the player (0-100) when not blitzed.
blitz_grades_coverage_defensenumericPFF coverage grade for the player (0-100) when blitzed.
no_pressure_grades_defensenumericPFF overall defense grade for the player (0-100) from a clean pocket (no pressure).
no_pressure_grades_defense_penaltynumericPFF defensive penalty grade for the player (0-100) from a clean pocket (no pressure).
no_blitz_grades_coverage_defensenumericPFF coverage grade for the player (0-100) when not blitzed.
blitz_grades_defensenumericPFF overall defense grade for the player (0-100) when blitzed.
blitz_grades_defense_penaltynumericPFF defensive penalty grade for the player (0-100) when blitzed.
no_pressure_grades_coverage_defensenumericPFF coverage grade for the player (0-100) from a clean pocket (no pressure).
pressure_grades_defense_penaltynumericPFF defensive penalty grade for the player (0-100) when under pressure.
pressure_grades_pass_rush_defensenumericPFF pass-rush grade for the player (0-100) when under pressure.
blitz_grades_pass_rush_defensenumericPFF pass-rush grade for the player (0-100) when blitzed.
no_pressure_grades_tacklenumericPFF tackling grade for the player (0-100) from a clean pocket (no pressure).
blitz_grades_tacklenumericPFF tackling grade for the player (0-100) when blitzed.
blitz_grades_overall_tacklenumericPFF overall tackling grade for the player (0-100) when blitzed.
no_pressure_grades_pass_rush_defensenumericPFF pass-rush grade for the player (0-100) from a clean pocket (no pressure).
pressure_grades_overall_tacklenumericPFF overall tackling grade for the player (0-100) when under pressure.
no_blitz_grades_overall_tacklenumericPFF overall tackling grade for the player (0-100) when not blitzed.
pressure_grades_tacklenumericPFF tackling grade for the player (0-100) when under pressure.
no_blitz_grades_pass_rush_defensecharacterPFF pass-rush grade for the player (0-100) when not blitzed.
no_pressure_grades_overall_tacklenumericPFF overall tackling grade for the player (0-100) from a clean pocket (no pressure).
no_blitz_grades_tacklenumericPFF 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}..

Example​

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

Last validated n/a.

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 (parser: parse_pff_report); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — The decoded JSON body. /v1 routes return the Premium Stats envelope ({report_slug: rows}); /v2 routes return {..meta.., columns, rows}..

Example​

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

Last validated n/a.

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 (parser: parse_pff_player_detail); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — The decoded JSON body. /v1 routes return the Premium Stats envelope ({report_slug: rows}); /v2 routes return {..meta.., columns, rows}..

Example​

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

Last validated n/a.