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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
league | league | Y | League 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. | ||
season | season | Y | Season, as a four-digit year. | ||
week | week | Y | Week filter. | ||
player_id | player_id | Y | Player id, taken as a positional argument. |
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_seasons(league='nfl', player_id=28022, season=2022)
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
league | league | Y | League 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. | ||
season | season | Y | Season, as a four-digit year, taken as a positional argument. | ||
week | week | Y | Week filter. | ||
player_id | player_id | Y | Player id, taken as a positional argument. |
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_snaps_summary(league='nfl', player_id=28022, season=2022)
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
league | league | Y | League 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. | ||
season | season | Y | Season, as a four-digit year, taken as a positional argument. | ||
week | week | Y | Week filter. | ||
player_id | player_id | Y | Player id, taken as a positional argument. |
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_position_pivot(league='nfl', player_id=28022, season=2022)
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
league | league | Y | League 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. | ||
season | season | Y | Season, as a four-digit year. | ||
week | week | Y | Week filter. | ||
player_id | player_id | Y | Player id, taken as a positional argument. | ||
career | career | Y | Career-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_offense_summary(league='nfl', player_id=28022, season=2022)
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
league | league | Y | League 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. | ||
season | season | Y | Season, as a four-digit year. | ||
week | week | Y | Week filter. | ||
player_id | player_id | Y | Player id, taken as a positional argument. | ||
career | career | Y | Career-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_offense_blocking(league='nfl', player_id=28022, season=2022)
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
league | league | Y | League 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. | ||
season | season | Y | Season, as a four-digit year. | ||
week | week | Y | Week filter. | ||
player_id | player_id | Y | Player id, taken as a positional argument. | ||
career | career | Y | Career-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_offense_pass_blocking(league='nfl', player_id=28022, season=2022)
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
league | league | Y | League 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. | ||
season | season | Y | Season, as a four-digit year. | ||
week | week | Y | Week filter. | ||
player_id | player_id | Y | Player id, taken as a positional argument. | ||
career | career | Y | Career-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_offense_run_blocking(league='nfl', player_id=28022, season=2022)
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
league | league | Y | League 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. | ||
season | season | Y | Season, as a four-digit year. | ||
week | week | Y | Week filter. | ||
player_id | player_id | Y | Player id, taken as a positional argument. | ||
career | career | Y | Career-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_passing_summary(league='nfl', player_id=28022, season=2022)
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
league | league | Y | League 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. | ||
season | season | Y | Season, as a four-digit year, taken as a positional argument. | ||
week | week | Y | Week filter. | ||
player_id | player_id | Y | Player id, taken as a positional argument. | ||
career | career | Y | Career-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_name | type | description |
|---|---|---|
comp_pct_diff | numeric | Difference in completion percentage between play-action and non-play-action attempts (PA minus non-PA), from the PFF passing-concept split. |
pa_grades_pass | numeric | PFF passing grade (0-100) on play-action dropbacks. |
no_screen_grades_offense | numeric | PFF overall offense grade for the player (0-100) excluding screen passes. |
pa_qb_rating | numeric | Traditional NFL passer rating on play-action dropbacks. |
no_screen_qb_rating | numeric | Traditional NFL passer rating excluding screen passes. |
pa_completions | numeric | Number of completed passes on play-action dropbacks. |
pa_thrown_aways | numeric | Number of intentional throwaways on play-action dropbacks. |
pa_dropbacks_percent | numeric | Share of the player's total dropbacks that came on play-action dropbacks, expressed as a percentage. |
ypa_diff | numeric | Difference in yards per attempt between play-action and non-play-action attempts (PA minus non-PA), from the PFF passing-concept split. |
no_screen_drops | numeric | Number of catchable passes dropped by receivers excluding screen passes. |
screen_completion_percent | numeric | Percentage of pass attempts completed on screen passes. |
npa_bats | numeric | Number of pass attempts batted down at the line of scrimmage on non-play-action dropbacks. |
no_screen_thrown_aways | numeric | Number of intentional throwaways excluding screen passes. |
pa_grades_run | numeric | PFF rushing grade for the player (0-100) on play-action dropbacks. |
screen_pressure_to_sack_rate | numeric | Percentage of pressured dropbacks that ended in a sack on screen passes. |
pa_drop_rate | numeric | Percentage of catchable passes dropped by receivers on play-action dropbacks. |
screen_grades_offense | numeric | PFF overall offense grade for the player (0-100) on screen passes. |
dropbacks | numeric | Number of dropbacks. |
npa_thrown_aways | numeric | Number of intentional throwaways on non-play-action dropbacks. |
no_screen_def_gen_pressures | numeric | Number of defense-generated pressures on the player's dropbacks excluding screen passes, as charted by PFF. |
screen_grades_hands_fumble | numeric | PFF hands (fumble) grade for the player, reflecting ball security (0-100) on screen passes. |
pa_touchdowns | numeric | Number of passing touchdowns thrown on play-action dropbacks. |
npa_ypa | numeric | Yards gained per pass attempt on non-play-action dropbacks. |
draft_season | numeric | NFL season (year) in which the player was drafted, per PFF player metadata. |
screen_avg_time_to_throw | numeric | Average time from snap to release in seconds on screen passes. |
screen_thrown_aways | numeric | Number of intentional throwaways on screen passes. |
npa_sacks | numeric | Number of sacks taken on non-play-action dropbacks. |
npa_aimed_passes | numeric | Number of aimed passes (attempts excluding spikes and throwaways) on non-play-action dropbacks, as charted by PFF. |
no_screen_completions | numeric | Number of completed passes excluding screen passes. |
no_screen_positive_epa_percent | numeric | Percentage of dropbacks with positive expected points added excluding screen passes. |
screen_spikes | numeric | Number of clock-stopping spikes on screen passes. |
pa_first_downs | numeric | Number of passing first downs gained on play-action dropbacks. |
pa_big_time_throws | numeric | Number of big-time throws on play-action dropbacks, per PFF's highest-value, highest-difficulty throw designation. |
team_name | character | Team abbreviation the player is credited to for the range. |
pa_spikes | numeric | Number of clock-stopping spikes on play-action dropbacks. |
pa_sack_percent | numeric | Percentage of dropbacks that ended in a sack on play-action dropbacks. |
screen_dropbacks_percent | numeric | Share of the player's total dropbacks that came on screen passes, expressed as a percentage. |
no_screen_epa | numeric | Total expected points added (EPA) on the player's dropbacks excluding screen passes. |
npa_avg_time_to_throw | numeric | Average time from snap to release in seconds on non-play-action dropbacks. |
screen_bats | numeric | Number of pass attempts batted down at the line of scrimmage on screen passes. |
screen_grades_run_block | numeric | PFF run-blocking grade for the player (0-100) on screen passes. |
jersey_number | character | Jersey number (string; zero-padded, e.g. "09"). |
no_screen_bats | numeric | Number of pass attempts batted down at the line of scrimmage excluding screen passes. |
npa_grades_offense | numeric | PFF overall offense grade for the player (0-100) on non-play-action dropbacks. |
no_screen_grades_pass_route | numeric | PFF receiving (route) grade for the player (0-100) excluding screen passes. |
screen_def_gen_pressures | numeric | Number of defense-generated pressures on the player's dropbacks on screen passes, as charted by PFF. |
pa_pressure_to_sack_rate | numeric | Percentage of pressured dropbacks that ended in a sack on play-action dropbacks. |
screen_sack_percent | numeric | Percentage of dropbacks that ended in a sack on screen passes. |
no_screen_btt_rate | numeric | Big-time throws as a percentage of qualifying attempts excluding screen passes, per PFF charting. |
npa_btt_rate | numeric | Big-time throws as a percentage of qualifying attempts on non-play-action dropbacks, per PFF charting. |
screen_interceptions | numeric | Number of passes intercepted on screen passes. |
no_screen_passing_snaps | numeric | Number of passing snaps played excluding screen passes. |
no_screen_grades_hands_fumble | numeric | PFF hands (fumble) grade for the player, reflecting ball security (0-100) excluding screen passes. |
screen_scrambles | numeric | Number of scrambles on screen passes. |
screen_grades_pass | numeric | PFF passing grade (0-100) on screen passes. |
npa_qb_rating | numeric | Traditional NFL passer rating on non-play-action dropbacks. |
no_screen_grades_pass | numeric | PFF passing grade (0-100) excluding screen passes. |
pa_avg_time_to_throw | numeric | Average time from snap to release in seconds on play-action dropbacks. |
screen_twp_rate | numeric | Turnover-worthy plays as a percentage of qualifying attempts on screen passes, per PFF charting. |
player_game_count | numeric | Number of games the player appeared in during the period covered. |
npa_accuracy_percent | numeric | Percentage of aimed passes charted as accurate by PFF on non-play-action dropbacks. |
eligible_season | numeric | Season (year) of the player's NFL draft eligibility, per PFF player metadata. |
npa_drops | numeric | Number of catchable passes dropped by receivers on non-play-action dropbacks. |
screen_yards | numeric | Passing yards gained on screen passes. |
no_screen_drop_rate | numeric | Percentage of catchable passes dropped by receivers excluding screen passes. |
no_screen_grades_offense_penalty | numeric | PFF offensive penalty grade for the player (0-100) excluding screen passes. |
npa_passing_snaps | numeric | Number of passing snaps played on non-play-action dropbacks. |
screen_drop_rate | numeric | Percentage of catchable passes dropped by receivers on screen passes. |
screen_epa | numeric | Total expected points added (EPA) on the player's dropbacks on screen passes. |
screen_grades_pass_route | numeric | PFF receiving (route) grade for the player (0-100) on screen passes. |
screen_grades_offense_penalty | numeric | PFF offensive penalty grade for the player (0-100) on screen passes. |
npa_spikes | numeric | Number of clock-stopping spikes on non-play-action dropbacks. |
screen_hit_as_threw | numeric | Number of attempts on which the passer was hit as he threw on screen passes, as charted by PFF. |
no_screen_aimed_passes | numeric | Number of aimed passes (attempts excluding spikes and throwaways) excluding screen passes, as charted by PFF. |
screen_drops | numeric | Number of catchable passes dropped by receivers on screen passes. |
screen_ypa | numeric | Yards gained per pass attempt on screen passes. |
npa_twp_rate | numeric | Turnover-worthy plays as a percentage of qualifying attempts on non-play-action dropbacks, per PFF charting. |
screen_accuracy_percent | numeric | Percentage of aimed passes charted as accurate by PFF on screen passes. |
npa_hit_as_threw | numeric | Number of attempts on which the passer was hit as he threw on non-play-action dropbacks, as charted by PFF. |
pa_accuracy_percent | numeric | Percentage of aimed passes charted as accurate by PFF on play-action dropbacks. |
pa_def_gen_pressures | numeric | Number of defense-generated pressures on the player's dropbacks on play-action dropbacks, as charted by PFF. |
screen_avg_depth_of_target | numeric | Average depth of target in air yards on screen passes. |
pa_sacks | numeric | Number of sacks taken on play-action dropbacks. |
screen_passing_snaps | numeric | Number of passing snaps played on screen passes. |
no_screen_grades_run | numeric | PFF rushing grade for the player (0-100) excluding screen passes. |
no_screen_first_downs | numeric | Number of passing first downs gained excluding screen passes. |
pa_ypa | numeric | Yards gained per pass attempt on play-action dropbacks. |
npa_scrambles | numeric | Number of scrambles on non-play-action dropbacks. |
npa_pressure_to_sack_rate | numeric | Percentage of pressured dropbacks that ended in a sack on non-play-action dropbacks. |
pa_twp_rate | numeric | Turnover-worthy plays as a percentage of qualifying attempts on play-action dropbacks, per PFF charting. |
no_screen_twp_rate | numeric | Turnover-worthy plays as a percentage of qualifying attempts excluding screen passes, per PFF charting. |
npa_grades_hands_fumble | numeric | PFF hands (fumble) grade for the player, reflecting ball security (0-100) on non-play-action dropbacks. |
screen_completions | numeric | Number of completed passes on screen passes. |
screen_btt_rate | numeric | Big-time throws as a percentage of qualifying attempts on screen passes, per PFF charting. |
npa_grades_run | numeric | PFF rushing grade for the player (0-100) on non-play-action dropbacks. |
no_screen_interceptions | numeric | Number of passes intercepted excluding screen passes. |
npa_grades_run_block | numeric | PFF run-blocking grade for the player (0-100) on non-play-action dropbacks. |
no_screen_sacks | numeric | Number of sacks taken excluding screen passes. |
penalties | numeric | Penalties charged to the player over the covered span. |
no_screen_big_time_throws | numeric | Number of big-time throws excluding screen passes, per PFF's highest-value, highest-difficulty throw designation. |
npa_drop_rate | numeric | Percentage of catchable passes dropped by receivers on non-play-action dropbacks. |
npa_attempts | numeric | Number of pass attempts on non-play-action dropbacks. |
screen_qb_rating | numeric | Traditional NFL passer rating on screen passes. |
npa_grades_offense_penalty | numeric | PFF offensive penalty grade for the player (0-100) on non-play-action dropbacks. |
pa_bats | numeric | Number of pass attempts batted down at the line of scrimmage on play-action dropbacks. |
pa_attempts | numeric | Number of pass attempts on play-action dropbacks. |
npa_def_gen_pressures | numeric | Number of defense-generated pressures on the player's dropbacks on non-play-action dropbacks, as charted by PFF. |
no_screen_avg_time_to_throw | numeric | Average time from snap to release in seconds excluding screen passes. |
pa_yards | numeric | Passing yards gained on play-action dropbacks. |
npa_positive_epa_percent | numeric | Percentage of dropbacks with positive expected points added on non-play-action dropbacks. |
team | character | Team abbreviation the player is credited to for the range. |
no_screen_scrambles | numeric | Number of scrambles excluding screen passes. |
pa_turnover_worthy_plays | numeric | Number of turnover-worthy plays on play-action dropbacks, plays PFF charts as deserving of a turnover. |
pa_aimed_passes | numeric | Number of aimed passes (attempts excluding spikes and throwaways) on play-action dropbacks, as charted by PFF. |
declined_penalties | numeric | Number of declined penalties committed by the player. |
pa_grades_offense | numeric | PFF overall offense grade for the player (0-100) on play-action dropbacks. |
screen_positive_epa_percent | numeric | Percentage of dropbacks with positive expected points added on screen passes. |
no_screen_dropbacks | numeric | Number of dropbacks excluding screen passes. |
no_screen_dropbacks_percent | numeric | Share of the player's total dropbacks that came excluding screen passes, expressed as a percentage. |
npa_grades_pass_route | numeric | PFF receiving (route) grade for the player (0-100) on non-play-action dropbacks. |
npa_sack_percent | numeric | Percentage of dropbacks that ended in a sack on non-play-action dropbacks. |
pa_positive_epa_percent | numeric | Percentage of dropbacks with positive expected points added on play-action dropbacks. |
pa_grades_run_block | numeric | PFF run-blocking grade for the player (0-100) on play-action dropbacks. |
no_screen_turnover_worthy_plays | numeric | Number of turnover-worthy plays excluding screen passes, plays PFF charts as deserving of a turnover. |
position | character | PFF 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_route | numeric | PFF receiving (route) grade for the player (0-100) on play-action dropbacks. |
npa_epa | numeric | Total expected points added (EPA) on the player's dropbacks on non-play-action dropbacks. |
no_screen_avg_depth_of_target | numeric | Average depth of target in air yards excluding screen passes. |
pa_grades_hands_fumble | numeric | PFF hands (fumble) grade for the player, reflecting ball security (0-100) on play-action dropbacks. |
no_screen_completion_percent | numeric | Percentage of pass attempts completed excluding screen passes. |
pa_hit_as_threw | numeric | Number of attempts on which the passer was hit as he threw on play-action dropbacks, as charted by PFF. |
pa_grades_offense_penalty | numeric | PFF offensive penalty grade for the player (0-100) on play-action dropbacks. |
npa_dropbacks_percent | numeric | Share of the player's total dropbacks that came on non-play-action dropbacks, expressed as a percentage. |
npa_grades_pass | numeric | PFF passing grade (0-100) on non-play-action dropbacks. |
screen_grades_run | numeric | PFF rushing grade for the player (0-100) on screen passes. |
screen_first_downs | numeric | Number of passing first downs gained on screen passes. |
npa_completion_percent | numeric | Percentage of pass attempts completed on non-play-action dropbacks. |
no_screen_grades_run_block | numeric | PFF run-blocking grade for the player (0-100) excluding screen passes. |
no_screen_hit_as_threw | numeric | Number of attempts on which the passer was hit as he threw excluding screen passes, as charted by PFF. |
screen_turnover_worthy_plays | numeric | Number of turnover-worthy plays on screen passes, plays PFF charts as deserving of a turnover. |
npa_avg_depth_of_target | numeric | Average depth of target in air yards on non-play-action dropbacks. |
npa_dropbacks | numeric | Number of dropbacks on non-play-action dropbacks. |
player | character | Player's display name as PFF lists it. |
pa_drops | numeric | Number of catchable passes dropped by receivers on play-action dropbacks. |
pa_btt_rate | numeric | Big-time throws as a percentage of qualifying attempts on play-action dropbacks, per PFF charting. |
franchise_id | numeric | PFF franchise (team) id (integer join key). |
screen_big_time_throws | numeric | Number of big-time throws on screen passes, per PFF's highest-value, highest-difficulty throw designation. |
screen_aimed_passes | numeric | Number of aimed passes (attempts excluding spikes and throwaways) on screen passes, as charted by PFF. |
npa_touchdowns | numeric | Number of passing touchdowns thrown on non-play-action dropbacks. |
screen_attempts | numeric | Number of pass attempts on screen passes. |
screen_dropbacks | numeric | Number of dropbacks on screen passes. |
no_screen_yards | numeric | Passing yards gained excluding screen passes. |
pa_scrambles | numeric | Number of scrambles on play-action dropbacks. |
pa_completion_percent | numeric | Percentage of pass attempts completed on play-action dropbacks. |
pa_avg_depth_of_target | numeric | Average depth of target in air yards on play-action dropbacks. |
pa_interceptions | numeric | Number of passes intercepted on play-action dropbacks. |
no_screen_accuracy_percent | numeric | Percentage of aimed passes charted as accurate by PFF excluding screen passes. |
no_screen_spikes | numeric | Number of clock-stopping spikes excluding screen passes. |
pa_dropbacks | numeric | Number of dropbacks on play-action dropbacks. |
npa_big_time_throws | numeric | Number of big-time throws on non-play-action dropbacks, per PFF's highest-value, highest-difficulty throw designation. |
no_screen_sack_percent | numeric | Percentage of dropbacks that ended in a sack excluding screen passes. |
pa_epa | numeric | Total expected points added (EPA) on the player's dropbacks on play-action dropbacks. |
no_screen_attempts | numeric | Number of pass attempts excluding screen passes. |
pa_passing_snaps | numeric | Number of passing snaps played on play-action dropbacks. |
npa_completions | numeric | Number of completed passes on non-play-action dropbacks. |
screen_touchdowns | numeric | Number of passing touchdowns thrown on screen passes. |
npa_first_downs | numeric | Number of passing first downs gained on non-play-action dropbacks. |
no_screen_touchdowns | numeric | Number of passing touchdowns thrown excluding screen passes. |
player_id | numeric | PFF player id (integer; matches the /players id and every player_id join key). |
npa_yards | numeric | Passing yards gained on non-play-action dropbacks. |
no_screen_ypa | numeric | Yards gained per pass attempt excluding screen passes. |
npa_turnover_worthy_plays | numeric | Number of turnover-worthy plays on non-play-action dropbacks, plays PFF charts as deserving of a turnover. |
npa_interceptions | numeric | Number of passes intercepted on non-play-action dropbacks. |
no_screen_pressure_to_sack_rate | numeric | Percentage of pressured dropbacks that ended in a sack excluding screen passes. |
screen_sacks | numeric | Number of sacks taken on screen passes. |
screen_grades_hands_drop | numeric | PFF hands (drop) grade for the player (0-100) on screen passes. |
screen_grades_pass_block | numeric | PFF pass-blocking grade for the player (0-100) on screen passes. |
no_screen_grades_pass_block | numeric | PFF pass-blocking grade for the player (0-100) excluding screen passes. |
pa_grades_hands_drop | numeric | PFF hands (drop) grade for the player (0-100) on play-action dropbacks. |
npa_grades_pass_block | numeric | PFF pass-blocking grade for the player (0-100) on non-play-action dropbacks. |
pa_grades_pass_block | numeric | PFF pass-blocking grade for the player (0-100) on play-action dropbacks. |
npa_grades_hands_drop | numeric | PFF hands (drop) grade for the player (0-100) on non-play-action dropbacks. |
no_screen_grades_hands_drop | numeric | PFF hands (drop) grade for the player (0-100) excluding screen passes. |
pa_grades_screen_block | numeric | PFF screen-blocking grade for the player (0-100) on play-action dropbacks. |
screen_grades_screen_block | numeric | PFF screen-blocking grade for the player (0-100) on screen passes. |
no_screen_grades_screen_block | numeric | PFF screen-blocking grade for the player (0-100) excluding screen passes. |
npa_grades_screen_block | numeric | PFF screen-blocking grade for the player (0-100) on non-play-action dropbacks. |
pa_grades_defense_penalty | numeric | PFF defensive penalty grade for the player (0-100) on play-action dropbacks. |
npa_grades_defense_penalty | numeric | PFF defensive penalty grade for the player (0-100) on non-play-action dropbacks. |
npa_grades_coverage_defense | numeric | PFF coverage grade for the player (0-100) on non-play-action dropbacks. |
pa_grades_defense | numeric | PFF overall defense grade for the player (0-100) on play-action dropbacks. |
screen_grades_coverage_defense | numeric | PFF coverage grade for the player (0-100) on screen passes. |
npa_grades_defense | numeric | PFF overall defense grade for the player (0-100) on non-play-action dropbacks. |
screen_grades_defense | numeric | PFF overall defense grade for the player (0-100) on screen passes. |
screen_grades_defense_penalty | numeric | PFF defensive penalty grade for the player (0-100) on screen passes. |
no_screen_grades_defense | numeric | PFF overall defense grade for the player (0-100) excluding screen passes. |
pa_grades_coverage_defense | numeric | PFF coverage grade for the player (0-100) on play-action dropbacks. |
no_screen_grades_defense_penalty | numeric | PFF defensive penalty grade for the player (0-100) excluding screen passes. |
no_screen_grades_coverage_defense | numeric | PFF coverage grade for the player (0-100) excluding screen passes. |
no_screen_grades_overall_tackle | numeric | PFF overall tackling grade for the player (0-100) excluding screen passes. |
pa_grades_overall_tackle | numeric | PFF overall tackling grade for the player (0-100) on play-action dropbacks. |
pa_grades_tackle | numeric | PFF tackling grade for the player (0-100) on play-action dropbacks. |
pa_grades_pass_rush_defense | character | PFF pass-rush grade for the player (0-100) on play-action dropbacks. |
screen_grades_run_defense | character | PFF run-defense grade for the player (0-100) on screen passes. |
pa_grades_run_defense | character | PFF run-defense grade for the player (0-100) on play-action dropbacks. |
npa_grades_overall_tackle | numeric | PFF overall tackling grade for the player (0-100) on non-play-action dropbacks. |
no_screen_grades_pass_rush_defense | numeric | PFF pass-rush grade for the player (0-100) excluding screen passes. |
npa_grades_tackle | numeric | PFF tackling grade for the player (0-100) on non-play-action dropbacks. |
screen_grades_tackle | character | PFF tackling grade for the player (0-100) on screen passes. |
no_screen_grades_tackle | numeric | PFF tackling grade for the player (0-100) excluding screen passes. |
npa_grades_pass_rush_defense | numeric | PFF pass-rush grade for the player (0-100) on non-play-action dropbacks. |
no_screen_grades_run_defense | numeric | PFF run-defense grade for the player (0-100) excluding screen passes. |
screen_grades_overall_tackle | character | PFF overall tackling grade for the player (0-100) on screen passes. |
npa_grades_run_defense | numeric | PFF run-defense grade for the player (0-100) on non-play-action dropbacks. |
screen_grades_pass_rush_defense | numeric | PFF 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}..
Example
pff_api_player_passing_concept(league='nfl', player_id=28022, season=2022)
Last validated n/a.