Skip to main content

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

pff_api_team_leaders​

A team's leaders for one position group, with rank and percentile

Endpoint URL: GET https://api.pff.com/v2/{league}/teams/{team}/leaders

Valid URL: https://api.pff.com/v2/nfl/teams/cincinnati-bengals/leaders?season=2022

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug: nfl or ncaa.
teamteamYThe team, as its slug (los-angeles-rams) or its numeric franchise id (26) — both resolve through the league's team directory for the season, and both produce the same answer.
seasonseasonYSeason, as a four-digit year: 2006 or later, and at most one year past the current season.
weekGroupweek_groupYWhich part of the season to cover: REG (regular season), PO (playoffs) or REGPO (both, the default).
groupgroupYWhich position group the leaders come from — receiving (the default), passing, rushing or defense.

Returns​

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

col_nametypedescription
player_idintegerPFF player id (integer; matches the /players id and every player_id join key).
namecharacterPlayer's display name as PFF lists it.
positioncharacterPFF position code (e.g. QB, HB, WR, TE, ED, DI, LB, CB, S); qualification floors and ranking pools are per position.
jerseycharacterJersey number as a string; leading zeros are meaningful (e.g. "01").
gamesintegerGames played in the requested season part (PFF column '#G').
games_rankintegerPlayer's rank on games played among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
games_rank_ofintegerNumber of qualified players at his position league-wide ranked on games played, the pool games_rank is out of; null when the player is below his position's qualifying volume.
games_percentileintegerPlayer's percentile (0-100, higher = better) on games played among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
targetsintegerPasses thrown to the player (targets) over the requested season part.
targets_rankintegerPlayer's rank on targets among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
targets_rank_ofintegerNumber of qualified players at his position league-wide ranked on targets, the pool targets_rank is out of; null when the player is below his position's qualifying volume.
targets_percentileintegerPlayer's percentile (0-100, higher = better) on targets among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
receptionsintegerPasses caught by the player over the requested season part.
receptions_rankintegerPlayer's rank on receptions among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
receptions_rank_ofintegerNumber of qualified players at his position league-wide ranked on receptions, the pool receptions_rank is out of; null when the player is below his position's qualifying volume.
receptions_percentileintegerPlayer's percentile (0-100, higher = better) on receptions among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
reception_pctnumericReceptions per target (catch rate), as a fraction (0-1).
reception_pct_rankintegerPlayer's rank on catch rate among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
reception_pct_rank_ofintegerNumber of qualified players at his position league-wide ranked on catch rate, the pool reception_pct_rank is out of; null when the player is below his position's qualifying volume.
reception_pct_percentileintegerPlayer's percentile (0-100, higher = better) on catch rate among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
receiving_yardsintegerReceiving yards gained by the player.
receiving_yards_rankintegerPlayer's rank on receiving yards among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
receiving_yards_rank_ofintegerNumber of qualified players at his position league-wide ranked on receiving yards, the pool receiving_yards_rank is out of; null when the player is below his position's qualifying volume.
receiving_yards_percentileintegerPlayer's percentile (0-100, higher = better) on receiving yards among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
yards_per_receptionnumericReceiving yards per reception (receiving_yards / receptions).
yards_per_reception_rankintegerPlayer's rank on yards per reception among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
yards_per_reception_rank_ofintegerNumber of qualified players at his position league-wide ranked on yards per reception, the pool yards_per_reception_rank is out of; null when the player is below his position's qualifying volume.
yards_per_reception_percentileintegerPlayer's percentile (0-100, higher = better) on yards per reception among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
receiving_tdintegerReceiving touchdowns scored by the player.
receiving_td_rankintegerPlayer's rank on receiving touchdowns among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
receiving_td_rank_ofintegerNumber of qualified players at his position league-wide ranked on receiving touchdowns, the pool receiving_td_rank is out of; null when the player is below his position's qualifying volume.
receiving_td_percentileintegerPlayer's percentile (0-100, higher = better) on receiving touchdowns among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_offensenumericPFF overall offense grade (0-100).
grade_offense_rankintegerPlayer's rank on PFF offense grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_offense_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF offense grade, the pool grade_offense_rank is out of; null when the player is below his position's qualifying volume.
grade_offense_percentileintegerPlayer's percentile (0-100, higher = better) on PFF offense grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_receivingnumericPFF receiving grade (0-100).
grade_receiving_rankintegerPlayer's rank on PFF receiving grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_receiving_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF receiving grade, the pool grade_receiving_rank is out of; null when the player is below his position's qualifying volume.
grade_receiving_percentileintegerPlayer's percentile (0-100, higher = better) on PFF receiving grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_dropnumericPFF hands/drop grade (0-100).
grade_drop_rankintegerPlayer's rank on PFF hands/drop grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_drop_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF hands/drop grade, the pool grade_drop_rank is out of; null when the player is below his position's qualifying volume.
grade_drop_percentileintegerPlayer's percentile (0-100, higher = better) on PFF hands/drop grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_fumblenumericPFF ball-security (hands/fumble) grade (0-100).
grade_fumble_rankintegerPlayer's rank on PFF ball-security grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_fumble_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF ball-security grade, the pool grade_fumble_rank is out of; null when the player is below his position's qualifying volume.
grade_fumble_percentileintegerPlayer's percentile (0-100, higher = better) on PFF ball-security grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_pass_blocknumericPFF pass-blocking grade (0-100); null when the player has no graded pass-blocking snaps.
grade_pass_block_rankintegerPlayer's rank on PFF pass-blocking grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_pass_block_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF pass-blocking grade, the pool grade_pass_block_rank is out of; null when the player is below his position's qualifying volume.
grade_pass_block_percentileintegerPlayer's percentile (0-100, higher = better) on PFF pass-blocking grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.

passing

col_nametypedescription
player_idintegerPFF player id (integer; matches the /players id and every player_id join key).
namecharacterPlayer's display name as PFF lists it.
positioncharacterPFF position code (e.g. QB, HB, WR, TE, ED, DI, LB, CB, S); qualification floors and ranking pools are per position.
jerseycharacterJersey number as a string; leading zeros are meaningful (e.g. "01").
gamesintegerGames played in the requested season part (PFF column '#G').
games_rankintegerPlayer's rank on games played among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
games_rank_ofintegerNumber of qualified players at his position league-wide ranked on games played, the pool games_rank is out of; null when the player is below his position's qualifying volume.
games_percentileintegerPlayer's percentile (0-100, higher = better) on games played among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
pass_attemptsintegerPass attempts thrown by the player.
pass_attempts_rankintegerPlayer's rank on pass attempts among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
pass_attempts_rank_ofintegerNumber of qualified players at his position league-wide ranked on pass attempts, the pool pass_attempts_rank is out of; null when the player is below his position's qualifying volume.
pass_attempts_percentileintegerPlayer's percentile (0-100, higher = better) on pass attempts among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
completionsintegerPasses the player completed.
completions_rankintegerPlayer's rank on completions among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
completions_rank_ofintegerNumber of qualified players at his position league-wide ranked on completions, the pool completions_rank is out of; null when the player is below his position's qualifying volume.
completions_percentileintegerPlayer's percentile (0-100, higher = better) on completions among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
completion_pctnumericCompletion percentage as a fraction (0-1).
completion_pct_rankintegerPlayer's rank on completion percentage among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
completion_pct_rank_ofintegerNumber of qualified players at his position league-wide ranked on completion percentage, the pool completion_pct_rank is out of; null when the player is below his position's qualifying volume.
completion_pct_percentileintegerPlayer's percentile (0-100, higher = better) on completion percentage among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
passing_yardsintegerPassing yards gained by the player.
passing_yards_rankintegerPlayer's rank on passing yards among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
passing_yards_rank_ofintegerNumber of qualified players at his position league-wide ranked on passing yards, the pool passing_yards_rank is out of; null when the player is below his position's qualifying volume.
passing_yards_percentileintegerPlayer's percentile (0-100, higher = better) on passing yards among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
yards_per_attemptnumericPassing yards per pass attempt (passing_yards / pass_attempts).
yards_per_attempt_rankintegerPlayer's rank on yards per pass attempt among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
yards_per_attempt_rank_ofintegerNumber of qualified players at his position league-wide ranked on yards per pass attempt, the pool yards_per_attempt_rank is out of; null when the player is below his position's qualifying volume.
yards_per_attempt_percentileintegerPlayer's percentile (0-100, higher = better) on yards per pass attempt among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
passing_tdintegerPassing touchdowns thrown by the player.
passing_td_rankintegerPlayer's rank on passing touchdowns among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
passing_td_rank_ofintegerNumber of qualified players at his position league-wide ranked on passing touchdowns, the pool passing_td_rank is out of; null when the player is below his position's qualifying volume.
passing_td_percentileintegerPlayer's percentile (0-100, higher = better) on passing touchdowns among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
interceptionsintegerInterceptions: thrown by the passer in the passing group, made by the defender in the defense group.
interceptions_rankintegerPlayer's rank on interceptions among qualified players at his position league-wide (1 = best: fewest thrown in the passing group, most made in the defense group; tied players share a rank); null when the player is below his position's qualifying volume.
interceptions_rank_ofintegerNumber of qualified players at his position league-wide ranked on interceptions, the pool interceptions_rank is out of; null when the player is below his position's qualifying volume.
interceptions_percentileintegerPlayer's percentile (0-100, higher = better) on interceptions among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_offensenumericPFF overall offense grade (0-100).
grade_offense_rankintegerPlayer's rank on PFF offense grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_offense_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF offense grade, the pool grade_offense_rank is out of; null when the player is below his position's qualifying volume.
grade_offense_percentileintegerPlayer's percentile (0-100, higher = better) on PFF offense grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_passnumericPFF passing grade (0-100).
grade_pass_rankintegerPlayer's rank on PFF passing grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_pass_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF passing grade, the pool grade_pass_rank is out of; null when the player is below his position's qualifying volume.
grade_pass_percentileintegerPlayer's percentile (0-100, higher = better) on PFF passing grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_runnumericPFF rushing grade (0-100).
grade_run_rankintegerPlayer's rank on PFF rushing grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_run_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF rushing grade, the pool grade_run_rank is out of; null when the player is below his position's qualifying volume.
grade_run_percentileintegerPlayer's percentile (0-100, higher = better) on PFF rushing grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_fumblenumericPFF ball-security (hands/fumble) grade (0-100).
grade_fumble_rankintegerPlayer's rank on PFF ball-security grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_fumble_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF ball-security grade, the pool grade_fumble_rank is out of; null when the player is below his position's qualifying volume.
grade_fumble_percentileintegerPlayer's percentile (0-100, higher = better) on PFF ball-security grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.

rushing

col_nametypedescription
player_idintegerPFF player id (integer; matches the /players id and every player_id join key).
namecharacterPlayer's display name as PFF lists it.
positioncharacterPFF position code (e.g. QB, HB, WR, TE, ED, DI, LB, CB, S); qualification floors and ranking pools are per position.
jerseycharacterJersey number as a string; leading zeros are meaningful (e.g. "01").
gamesintegerGames played in the requested season part (PFF column '#G').
games_rankintegerPlayer's rank on games played among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
games_rank_ofintegerNumber of qualified players at his position league-wide ranked on games played, the pool games_rank is out of; null when the player is below his position's qualifying volume.
games_percentileintegerPlayer's percentile (0-100, higher = better) on games played among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
rush_attemptsintegerRushing attempts (carries) by the player.
rush_attempts_rankintegerPlayer's rank on rushing attempts among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
rush_attempts_rank_ofintegerNumber of qualified players at his position league-wide ranked on rushing attempts, the pool rush_attempts_rank is out of; null when the player is below his position's qualifying volume.
rush_attempts_percentileintegerPlayer's percentile (0-100, higher = better) on rushing attempts among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
rushing_yardsintegerRushing yards gained by the player.
rushing_yards_rankintegerPlayer's rank on rushing yards among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
rushing_yards_rank_ofintegerNumber of qualified players at his position league-wide ranked on rushing yards, the pool rushing_yards_rank is out of; null when the player is below his position's qualifying volume.
rushing_yards_percentileintegerPlayer's percentile (0-100, higher = better) on rushing yards among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
yards_per_carrynumericRushing yards per carry (rushing_yards / rush_attempts).
yards_per_carry_rankintegerPlayer's rank on yards per carry among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
yards_per_carry_rank_ofintegerNumber of qualified players at his position league-wide ranked on yards per carry, the pool yards_per_carry_rank is out of; null when the player is below his position's qualifying volume.
yards_per_carry_percentileintegerPlayer's percentile (0-100, higher = better) on yards per carry among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
yards_after_contact_per_attemptnumericRushing yards after contact per attempt (PFF column 'YAC/ATT').
yards_after_contact_per_attempt_rankintegerPlayer's rank on yards after contact per attempt among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
yards_after_contact_per_attempt_rank_ofintegerNumber of qualified players at his position league-wide ranked on yards after contact per attempt, the pool yards_after_contact_per_attempt_rank is out of; null when the player is below his position's qualifying volume.
yards_after_contact_per_attempt_percentileintegerPlayer's percentile (0-100, higher = better) on yards after contact per attempt among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
rushing_tdintegerRushing touchdowns scored by the player.
rushing_td_rankintegerPlayer's rank on rushing touchdowns among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
rushing_td_rank_ofintegerNumber of qualified players at his position league-wide ranked on rushing touchdowns, the pool rushing_td_rank is out of; null when the player is below his position's qualifying volume.
rushing_td_percentileintegerPlayer's percentile (0-100, higher = better) on rushing touchdowns among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
fumblesintegerFumbles by the player (rushing group).
fumbles_rankintegerPlayer's rank on fumbles among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
fumbles_rank_ofintegerNumber of qualified players at his position league-wide ranked on fumbles, the pool fumbles_rank is out of; null when the player is below his position's qualifying volume.
fumbles_percentileintegerPlayer's percentile (0-100, higher = better) on fumbles among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_offensenumericPFF overall offense grade (0-100).
grade_offense_rankintegerPlayer's rank on PFF offense grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_offense_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF offense grade, the pool grade_offense_rank is out of; null when the player is below his position's qualifying volume.
grade_offense_percentileintegerPlayer's percentile (0-100, higher = better) on PFF offense grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_runnumericPFF rushing grade (0-100).
grade_run_rankintegerPlayer's rank on PFF rushing grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_run_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF rushing grade, the pool grade_run_rank is out of; null when the player is below his position's qualifying volume.
grade_run_percentileintegerPlayer's percentile (0-100, higher = better) on PFF rushing grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_fumblenumericPFF ball-security (hands/fumble) grade (0-100).
grade_fumble_rankintegerPlayer's rank on PFF ball-security grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_fumble_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF ball-security grade, the pool grade_fumble_rank is out of; null when the player is below his position's qualifying volume.
grade_fumble_percentileintegerPlayer's percentile (0-100, higher = better) on PFF ball-security grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_receivingnumericPFF receiving grade (0-100).
grade_receiving_rankintegerPlayer's rank on PFF receiving grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_receiving_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF receiving grade, the pool grade_receiving_rank is out of; null when the player is below his position's qualifying volume.
grade_receiving_percentileintegerPlayer's percentile (0-100, higher = better) on PFF receiving grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_pass_blocknumericPFF pass-blocking grade (0-100); null when the player has no graded pass-blocking snaps.
grade_pass_block_rankintegerPlayer's rank on PFF pass-blocking grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_pass_block_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF pass-blocking grade, the pool grade_pass_block_rank is out of; null when the player is below his position's qualifying volume.
grade_pass_block_percentileintegerPlayer's percentile (0-100, higher = better) on PFF pass-blocking grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.

defense

col_nametypedescription
player_idintegerPFF player id (integer; matches the /players id and every player_id join key).
namecharacterPlayer's display name as PFF lists it.
positioncharacterPFF position code (e.g. QB, HB, WR, TE, ED, DI, LB, CB, S); qualification floors and ranking pools are per position.
jerseycharacterJersey number as a string; leading zeros are meaningful (e.g. "01").
gamesintegerGames played in the requested season part (PFF column '#G').
games_rankintegerPlayer's rank on games played among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
games_rank_ofintegerNumber of qualified players at his position league-wide ranked on games played, the pool games_rank is out of; null when the player is below his position's qualifying volume.
games_percentileintegerPlayer's percentile (0-100, higher = better) on games played among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
tacklesintegerTackles made by the player, as charted by PFF (assisted tackles are reported in assists).
tackles_rankintegerPlayer's rank on tackles among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
tackles_rank_ofintegerNumber of qualified players at his position league-wide ranked on tackles, the pool tackles_rank is out of; null when the player is below his position's qualifying volume.
tackles_percentileintegerPlayer's percentile (0-100, higher = better) on tackles among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
assistsintegerAssisted tackles credited to the player.
assists_rankintegerPlayer's rank on assisted tackles among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
assists_rank_ofintegerNumber of qualified players at his position league-wide ranked on assisted tackles, the pool assists_rank is out of; null when the player is below his position's qualifying volume.
assists_percentileintegerPlayer's percentile (0-100, higher = better) on assisted tackles among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
sacksnumericSacks recorded by the defender.
sacks_rankintegerPlayer's rank on sacks among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
sacks_rank_ofintegerNumber of qualified players at his position league-wide ranked on sacks, the pool sacks_rank is out of; null when the player is below his position's qualifying volume.
sacks_percentileintegerPlayer's percentile (0-100, higher = better) on sacks among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
qb_hurriesintegerQuarterback hurries recorded by the defender.
qb_hurries_rankintegerPlayer's rank on quarterback hurries among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
qb_hurries_rank_ofintegerNumber of qualified players at his position league-wide ranked on quarterback hurries, the pool qb_hurries_rank is out of; null when the player is below his position's qualifying volume.
qb_hurries_percentileintegerPlayer's percentile (0-100, higher = better) on quarterback hurries among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
interceptionsintegerInterceptions: thrown by the passer in the passing group, made by the defender in the defense group.
interceptions_rankintegerPlayer's rank on interceptions among qualified players at his position league-wide (1 = best: fewest thrown in the passing group, most made in the defense group; tied players share a rank); null when the player is below his position's qualifying volume.
interceptions_rank_ofintegerNumber of qualified players at his position league-wide ranked on interceptions, the pool interceptions_rank is out of; null when the player is below his position's qualifying volume.
interceptions_percentileintegerPlayer's percentile (0-100, higher = better) on interceptions among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
passes_defendedintegerPasses defended credited to the defender (PFF column 'PD').
passes_defended_rankintegerPlayer's rank on passes defended among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
passes_defended_rank_ofintegerNumber of qualified players at his position league-wide ranked on passes defended, the pool passes_defended_rank is out of; null when the player is below his position's qualifying volume.
passes_defended_percentileintegerPlayer's percentile (0-100, higher = better) on passes defended among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_defensenumericPFF overall defense grade (0-100).
grade_defense_rankintegerPlayer's rank on PFF defense grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_defense_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF defense grade, the pool grade_defense_rank is out of; null when the player is below his position's qualifying volume.
grade_defense_percentileintegerPlayer's percentile (0-100, higher = better) on PFF defense grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_run_defensenumericPFF run-defense grade (0-100).
grade_run_defense_rankintegerPlayer's rank on PFF run-defense grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_run_defense_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF run-defense grade, the pool grade_run_defense_rank is out of; null when the player is below his position's qualifying volume.
grade_run_defense_percentileintegerPlayer's percentile (0-100, higher = better) on PFF run-defense grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_tacklenumericPFF tackling grade (0-100).
grade_tackle_rankintegerPlayer's rank on PFF tackling grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_tackle_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF tackling grade, the pool grade_tackle_rank is out of; null when the player is below his position's qualifying volume.
grade_tackle_percentileintegerPlayer's percentile (0-100, higher = better) on PFF tackling grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_pass_rushnumericPFF pass-rush grade (0-100).
grade_pass_rush_rankintegerPlayer's rank on PFF pass-rush grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_pass_rush_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF pass-rush grade, the pool grade_pass_rush_rank is out of; null when the player is below his position's qualifying volume.
grade_pass_rush_percentileintegerPlayer's percentile (0-100, higher = better) on PFF pass-rush grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.
grade_coveragenumericPFF coverage grade (0-100).
grade_coverage_rankintegerPlayer's rank on PFF coverage grade among qualified players at his position league-wide (1 = best; tied players share a rank); null when the player is below his position's qualifying volume.
grade_coverage_rank_ofintegerNumber of qualified players at his position league-wide ranked on PFF coverage grade, the pool grade_coverage_rank is out of; null when the player is below his position's qualifying volume.
grade_coverage_percentileintegerPlayer's percentile (0-100, higher = better) on PFF coverage grade among qualified players at his position league-wide; null when the player is below his position's qualifying volume.

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_team_leaders(league='nfl', season=2022, team='cincinnati-bengals')

Last validated n/a.

pff_api_team_rushing_direction​

A team's rushing by direction, one row per rusher and gap, plus totals

Endpoint URL: GET https://api.pff.com/v2/{league}/teams/{team}/reports/rushing-direction

Valid URL: https://api.pff.com/v2/nfl/teams/cincinnati-bengals/reports/rushing-direction?season=2022

API ParameterPythonPatternRequiredNullableDescription
leagueleagueYLeague slug: nfl or ncaa.
teamteamYThe team, as its slug (los-angeles-rams) or its numeric franchise id (26) — both resolve through the league's team directory for the season, and both produce the same answer.
seasonseasonYSeason, as a four-digit year: 2006 or later, and at most one year past the current season.
weekGroupweek_groupYWhich part of the season to cover: REG (regular season), PO (playoffs) or REGPO (both, the default).

Returns​

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

col_nametypedescription
player_idintegerPFF player id of the rusher (integer; matches the /players id and every player_id join key).
playercharacterRusher's display name as PFF lists it.
positioncharacterPFF position code of the rusher (e.g. HB, QB, WR).
directioncharacterRun direction as PFF charts it, i.e. the gap or edge the carry went to (e.g. LE = left end, LT = left tackle, LG = left guard); one row per rusher per direction.
attemptsintegerCarries in this direction (PFF column 'ATT').
yardsintegerRushing yards on carries in this direction.
ypanumericRushing yards per carry in this direction (PFF column 'YPA').
touchdownsintegerRushing touchdowns on carries in this direction.
first_downsintegerRushing first downs gained on carries in this direction.
explosiveintegerCarries in this direction that gained 10 or more yards (PFF column '10+').
yards_after_contactintegerRushing yards gained after first contact on carries in this direction (PFF column 'YCO').
yco_attemptnumericYards after contact per carry in this direction (PFF column 'YCO/A').
longestintegerLongest carry in this direction, in yards.
avoided_tacklesintegerMissed tackles forced on carries in this direction (PFF column 'MTF').
fumblesintegerFumbles on carries 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}..

Example​

pff_api_team_rushing_direction(league='nfl', season=2022, team='cincinnati-bengals')

Last validated n/a.