Skip to main content

NFL — PFF Developer API (api.pff.com, API key) — Signature

pff_api_signature_passing_time_in_pocket​

Signature stat: time in pocket

Endpoint URL: GET https://api.pff.com/v1/facet/signature/passing/time_in_pocket

Valid URL: https://api.pff.com/v1/facet/signature/passing/time_in_pocket?league=nfl&season=2022&week=1

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, and the SECOND positional argument of the four signature commands.
weekweekYWeek, and the THIRD positional argument of the four signature commands.

Returns​

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

col_nametypedescription
more_btt_rateFloat64Big-time throws as a percentage of qualifying attempts on dropbacks with time in pocket of 2.5 seconds or more, per PFF charting.
more_grades_runFloat64PFF rushing grade for the player (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
more_ypaFloat64Yards gained per pass attempt on dropbacks with time in pocket of 2.5 seconds or more.
more_passing_snapsFloat64Number of passing snaps played on dropbacks with time in pocket of 2.5 seconds or more.
more_pressure_to_sack_rateFloat64Percentage of pressured dropbacks that ended in a sack on dropbacks with time in pocket of 2.5 seconds or more.
less_def_gen_pressuresFloat64Number of defense-generated pressures on the player's dropbacks on dropbacks with time in pocket under 2.5 seconds, as charted by PFF.
dropbacksFloat64Number of dropbacks.
less_sack_percentFloat64Percentage of dropbacks that ended in a sack on dropbacks with time in pocket under 2.5 seconds.
less_first_downsFloat64Number of passing first downs gained on dropbacks with time in pocket under 2.5 seconds.
less_ypaFloat64Yards gained per pass attempt on dropbacks with time in pocket under 2.5 seconds.
draft_seasonFloat64NFL season (year) in which the player was drafted, per PFF player metadata.
more_grades_pass_routeStringPFF receiving (route) grade for the player (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
less_pressure_to_sack_rateFloat64Percentage of pressured dropbacks that ended in a sack on dropbacks with time in pocket under 2.5 seconds.
less_aimed_passesFloat64Number of aimed passes (attempts excluding throwaways, spikes, batted passes and throws made while hit) on dropbacks with time in pocket under 2.5 seconds, as charted by PFF.
more_dropbacks_percentFloat64Share of the player's total dropbacks that came on dropbacks with time in pocket of 2.5 seconds or more, expressed as a percentage.
less_positive_epa_percentFloat64Percentage of dropbacks with positive expected points added on dropbacks with time in pocket under 2.5 seconds.
team_nameStringTeam abbreviation the player is credited to for the range.
avg_ttt_scramblesFloat64Average time in the pocket in seconds on dropbacks ending in a scramble.
more_yardsFloat64Passing yards gained on dropbacks with time in pocket of 2.5 seconds or more.
more_accuracy_percentFloat64Percentage of aimed passes charted as accurate by PFF on dropbacks with time in pocket of 2.5 seconds or more.
less_attemptsFloat64Number of pass attempts on dropbacks with time in pocket under 2.5 seconds.
less_drop_rateFloat64Percentage of catchable passes dropped by receivers on dropbacks with time in pocket under 2.5 seconds.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
more_turnover_worthy_playsFloat64Number of turnover-worthy plays on dropbacks with time in pocket of 2.5 seconds or more, plays PFF charts as deserving of a turnover.
more_interceptionsFloat64Number of passes intercepted on dropbacks with time in pocket of 2.5 seconds or more.
more_sack_percentFloat64Percentage of dropbacks that ended in a sack on dropbacks with time in pocket of 2.5 seconds or more.
more_twp_rateFloat64Turnover-worthy plays as a percentage of qualifying attempts on dropbacks with time in pocket of 2.5 seconds or more, per PFF charting.
less_completionsFloat64Number of completed passes on dropbacks with time in pocket under 2.5 seconds.
more_thrown_awaysFloat64Number of intentional throwaways on dropbacks with time in pocket of 2.5 seconds or more.
less_btt_rateFloat64Big-time throws as a percentage of qualifying attempts on dropbacks with time in pocket under 2.5 seconds, per PFF charting.
more_big_time_throwsFloat64Number of big-time throws on dropbacks with time in pocket of 2.5 seconds or more, per PFF's highest-value, highest-difficulty throw designation.
less_qb_ratingFloat64Traditional NFL passer rating on dropbacks with time in pocket under 2.5 seconds.
less_hit_as_threwFloat64Number of attempts on which the passer was hit as he threw on dropbacks with time in pocket under 2.5 seconds, as charted by PFF.
more_attemptsFloat64Number of pass attempts on dropbacks with time in pocket of 2.5 seconds or more.
player_game_countFloat64Number of games the player appeared in during the period covered.
less_spikesFloat64Number of clock-stopping spikes on dropbacks with time in pocket under 2.5 seconds.
eligible_seasonFloat64Season (year) of the player's NFL draft eligibility, per PFF player metadata.
less_dropbacks_percentFloat64Share of the player's total dropbacks that came on dropbacks with time in pocket under 2.5 seconds, expressed as a percentage.
more_qb_ratingFloat64Traditional NFL passer rating on dropbacks with time in pocket of 2.5 seconds or more.
less_dropbacksFloat64Number of dropbacks on dropbacks with time in pocket under 2.5 seconds.
more_grades_hands_fumbleFloat64PFF hands (fumble) grade for the player, reflecting ball security (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
more_avg_depth_of_targetFloat64Average depth of target in air yards on dropbacks with time in pocket of 2.5 seconds or more.
less_scramblesFloat64Number of scrambles on dropbacks with time in pocket under 2.5 seconds.
more_positive_epa_percentFloat64Percentage of dropbacks with positive expected points added on dropbacks with time in pocket of 2.5 seconds or more.
less_sacksFloat64Number of sacks taken on dropbacks with time in pocket under 2.5 seconds.
less_grades_passFloat64PFF passing grade (0-100) on dropbacks with time in pocket under 2.5 seconds.
less_dropsFloat64Number of catchable passes dropped by receivers on dropbacks with time in pocket under 2.5 seconds.
more_sacksFloat64Number of sacks taken on dropbacks with time in pocket of 2.5 seconds or more.
more_first_downsFloat64Number of passing first downs gained on dropbacks with time in pocket of 2.5 seconds or more.
less_big_time_throwsFloat64Number of big-time throws on dropbacks with time in pocket under 2.5 seconds, per PFF's highest-value, highest-difficulty throw designation.
avg_ttt_attemptsFloat64Average time from snap to release in seconds on dropbacks ending in a pass attempt.
more_aimed_passesFloat64Number of aimed passes (attempts excluding throwaways, spikes, batted passes and throws made while hit) on dropbacks with time in pocket of 2.5 seconds or more, as charted by PFF.
less_accuracy_percentFloat64Percentage of aimed passes charted as accurate by PFF on dropbacks with time in pocket under 2.5 seconds.
more_scramblesFloat64Number of scrambles on dropbacks with time in pocket of 2.5 seconds or more.
less_epaFloat64Total expected points added (EPA) on the player's dropbacks on dropbacks with time in pocket under 2.5 seconds.
more_spikesFloat64Number of clock-stopping spikes on dropbacks with time in pocket of 2.5 seconds or more.
less_grades_pass_routeStringPFF receiving (route) grade for the player (0-100) on dropbacks with time in pocket under 2.5 seconds.
less_grades_offenseFloat64PFF overall offense grade for the player (0-100) on dropbacks with time in pocket under 2.5 seconds.
avg_ttt_sacksFloat64Average time from snap to sack in seconds on dropbacks ending in a sack.
more_grades_offense_penaltyFloat64PFF offensive penalty grade for the player (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
teamStringTeam abbreviation the player is credited to for the range.
less_batsFloat64Number of pass attempts batted down at the line of scrimmage on dropbacks with time in pocket under 2.5 seconds.
less_grades_runFloat64PFF rushing grade for the player (0-100) on dropbacks with time in pocket under 2.5 seconds.
positionStringPFF position code the player is listed at (e.g. QB, HB, FB, WR, TE, T, G, C, ED, DI, LB, CB, S, K, P).
less_touchdownsFloat64Number of passing touchdowns thrown on dropbacks with time in pocket under 2.5 seconds.
less_yardsFloat64Passing yards gained on dropbacks with time in pocket under 2.5 seconds.
less_grades_run_blockStringPFF run-blocking grade for the player (0-100) on dropbacks with time in pocket under 2.5 seconds.
less_grades_hands_fumbleFloat64PFF hands (fumble) grade for the player, reflecting ball security (0-100) on dropbacks with time in pocket under 2.5 seconds.
more_hit_as_threwFloat64Number of attempts on which the passer was hit as he threw on dropbacks with time in pocket of 2.5 seconds or more, as charted by PFF.
more_epaFloat64Total expected points added (EPA) on the player's dropbacks on dropbacks with time in pocket of 2.5 seconds or more.
avg_time_to_throwFloat64Average time to throw per dropback, in seconds from snap to release.
less_turnover_worthy_playsFloat64Number of turnover-worthy plays on dropbacks with time in pocket under 2.5 seconds, plays PFF charts as deserving of a turnover.
less_completion_percentFloat64Percentage of pass attempts completed on dropbacks with time in pocket under 2.5 seconds.
more_dropsFloat64Number of catchable passes dropped by receivers on dropbacks with time in pocket of 2.5 seconds or more.
playerStringPlayer's display name as PFF lists it.
more_touchdownsFloat64Number of passing touchdowns thrown on dropbacks with time in pocket of 2.5 seconds or more.
franchise_idFloat64PFF franchise (team) id (integer join key).
more_drop_rateFloat64Percentage of catchable passes dropped by receivers on dropbacks with time in pocket of 2.5 seconds or more.
less_twp_rateFloat64Turnover-worthy plays as a percentage of qualifying attempts on dropbacks with time in pocket under 2.5 seconds, per PFF charting.
more_grades_offenseFloat64PFF overall offense grade for the player (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
less_thrown_awaysFloat64Number of intentional throwaways on dropbacks with time in pocket under 2.5 seconds.
less_avg_depth_of_targetFloat64Average depth of target in air yards on dropbacks with time in pocket under 2.5 seconds.
less_avg_time_to_throwFloat64Average time to throw per dropback, in seconds from snap to release, on dropbacks with time in pocket under 2.5 seconds.
less_grades_offense_penaltyFloat64PFF offensive penalty grade for the player (0-100) on dropbacks with time in pocket under 2.5 seconds.
less_interceptionsFloat64Number of passes intercepted on dropbacks with time in pocket under 2.5 seconds.
more_def_gen_pressuresFloat64Number of defense-generated pressures on the player's dropbacks on dropbacks with time in pocket of 2.5 seconds or more, as charted by PFF.
more_avg_time_to_throwFloat64Average time to throw per dropback, in seconds from snap to release, on dropbacks with time in pocket of 2.5 seconds or more.
more_dropbacksFloat64Number of dropbacks on dropbacks with time in pocket of 2.5 seconds or more.
more_grades_passFloat64PFF passing grade (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
less_passing_snapsFloat64Number of passing snaps played on dropbacks with time in pocket under 2.5 seconds.
more_completionsFloat64Number of completed passes on dropbacks with time in pocket of 2.5 seconds or more.
more_grades_run_blockStringPFF run-blocking grade for the player (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
more_batsFloat64Number of pass attempts batted down at the line of scrimmage on dropbacks with time in pocket of 2.5 seconds or more.
more_completion_percentFloat64Percentage of pass attempts completed on dropbacks with time in pocket of 2.5 seconds or more.
more_grades_hands_dropStringPFF hands (drop) grade for the player (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
less_grades_hands_dropStringPFF hands (drop) grade for the player (0-100) on dropbacks with time in pocket under 2.5 seconds.
less_grades_pass_blockStringPFF pass-blocking grade for the player (0-100) on dropbacks with time in pocket under 2.5 seconds.
more_grades_pass_blockStringPFF pass-blocking grade for the player (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
less_grades_screen_blockStringPFF screen-blocking grade for the player (0-100) on dropbacks with time in pocket under 2.5 seconds.
more_grades_screen_blockStringPFF screen-blocking grade for the player (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
less_grades_defense_penaltyStringPFF defensive penalty grade for the player (0-100) on dropbacks with time in pocket under 2.5 seconds.
less_grades_coverage_defenseStringPFF coverage grade for the player (0-100) on dropbacks with time in pocket under 2.5 seconds.
more_grades_defense_penaltyStringPFF defensive penalty grade for the player (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
more_grades_defenseStringPFF overall defense grade for the player (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
more_grades_coverage_defenseStringPFF coverage grade for the player (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
less_grades_defenseStringPFF overall defense grade for the player (0-100) on dropbacks with time in pocket under 2.5 seconds.
less_grades_overall_tackleStringPFF overall tackling grade for the player (0-100) on dropbacks with time in pocket under 2.5 seconds.
more_grades_pass_rush_defenseStringPFF pass-rush grade for the player (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
more_grades_run_defenseStringPFF run-defense grade for the player (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
more_grades_tackleStringPFF tackling grade for the player (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
less_grades_pass_rush_defenseStringPFF pass-rush grade for the player (0-100) on dropbacks with time in pocket under 2.5 seconds.
less_grades_tackleStringPFF tackling grade for the player (0-100) on dropbacks with time in pocket under 2.5 seconds.
more_grades_overall_tackleStringPFF overall tackling grade for the player (0-100) on dropbacks with time in pocket of 2.5 seconds or more.
less_grades_run_defenseStringPFF run-defense grade for the player (0-100) on dropbacks with time in pocket under 2.5 seconds.

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

Raises​

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

Example​

pff_api_signature_passing_time_in_pocket(league='nfl', season='2022', week='1')

pff_api_signature_pass_blocking_efficiency_line​

Signature stat: pass-blocking efficiency, by line

Endpoint URL: GET https://api.pff.com/v1/facet/signature/pass-blocking/efficiency/line

Valid URL: https://api.pff.com/v1/facet/signature/pass-blocking/efficiency/line?league=nfl&season=2022&week=1

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, and the SECOND positional argument of the four signature commands.
weekweekYWeek, and the THIRD positional argument of the four signature commands.

Returns​

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

col_nametypedescription
attemptsFloat64Pass plays the team's offensive line blocked on over the covered span, as counted by PFF (equal to pass_snaps in the captured rows).
franchise_idFloat64PFF franchise (team) id of the team whose offensive line the row describes (integer join key).
hits_allowedFloat64Quarterback hits allowed.
hurries_allowedFloat64Quarterback hurries allowed.
pass_snapsFloat64Pass-play snaps.
pbeFloat64PFF Pass Blocking Efficiency rating, pressures allowed per pass-blocking snap weighted toward sacks.
player_game_countFloat64Number of games the player appeared in over the covered span.
pressures_allowedFloat64Total pressures allowed (sacks, hits, and hurries).
sacks_allowedFloat64Sacks allowed by the team's offensive line over the covered span.
season_idFloat64Season (year) the row covers (e.g. 2022).
team_nameStringAbbreviation of the team whose offensive line the row describes (e.g. "ATL").

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

Raises​

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

Example​

pff_api_signature_pass_blocking_efficiency_line(league='nfl', season='2022', week='1')

pff_api_signature_defense_outside_pass_rush​

Signature stat: outside pass rush

Endpoint URL: GET https://api.pff.com/v1/facet/signature/defense/outside_pass_rush

Valid URL: https://api.pff.com/v1/facet/signature/defense/outside_pass_rush?league=nfl&season=2022&week=1

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, and the SECOND positional argument of the four signature commands.
weekweekYWeek, and the THIRD positional argument of the four signature commands.

Returns​

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

col_nametypedescription
lhs_sacksFloat64Sacks recorded when rushing from the left side.
rhs_hitsFloat64Quarterback hits recorded when rushing from the right side.
rhs_prpFloat64PFF Pass Rush Productivity rating, pressure generated per pass-rush snap weighted toward sacks when rushing from the right side.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
pass_snapsFloat64Pass-play snaps.
lhs_hurriesFloat64Quarterback hurries recorded when rushing from the left side.
team_nameStringTeam abbreviation the player is credited to for the range.
prpFloat64PFF Pass Rush Productivity rating, pressure generated per pass-rush snap weighted toward sacks.
tacklesFloat64Tackles made by the player, as charted by PFF.
rhs_pressuresFloat64Total pressures generated (sacks, hits, and hurries) when rushing from the right side.
rhs_pass_rush_percentFloat64Share of pass-play snaps spent rushing the passer when rushing from the right side.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
lhs_pass_rush_percentFloat64Share of pass-play snaps spent rushing the passer when rushing from the left side.
lhs_pass_rush_snapsFloat64Pass-rush snaps played when rushing from the left side.
sacksFloat64Sacks recorded by the pass rusher.
lhs_assistsFloat64Assisted tackles when rushing from the left side.
player_game_countFloat64Number of games the player appeared in over the covered span.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
lhs_pressuresFloat64Total pressures generated (sacks, hits, and hurries) when rushing from the left side.
pass_rush_snapsFloat64Pass-rush snaps played.
hurriesFloat64Quarterback hurries recorded.
rhs_pass_rush_snapsFloat64Pass-rush snaps played when rushing from the right side.
lhs_prpFloat64PFF Pass Rush Productivity rating, pressure generated per pass-rush snap weighted toward sacks when rushing from the left side.
hitsFloat64Quarterback hits recorded by the pass rusher.
lhs_hitsFloat64Quarterback hits recorded when rushing from the left side.
rhs_tacklesFloat64Tackles made when rushing from the right side.
lhs_stopsFloat64Stops, PFF's tackles that constitute a failed play for the offense when rushing from the left side.
teamStringTeam abbreviation the player is credited to for the range.
stopsFloat64Stops, PFF's tackles that constitute a failed play for the offense.
rhs_missesFloat64Missed tackles when rushing from the right side.
positionStringPFF position code the player is listed at (e.g. QB, HB, FB, WR, TE, T, G, C, ED, DI, LB, CB, S, K, P).
pressuresFloat64Total pressures generated (sacks, hits, and hurries).
missesFloat64Missed tackles.
playerStringPlayer's display name as PFF lists it.
rhs_sacksFloat64Sacks recorded when rushing from the right side.
franchise_idFloat64PFF franchise (team) id (integer join key).
pass_rush_percentFloat64Share of pass-play snaps spent rushing the passer.
rhs_hurriesFloat64Quarterback hurries recorded when rushing from the right side.
rhs_assistsFloat64Assisted tackles when rushing from the right side.
rhs_stopsFloat64Stops, PFF's tackles that constitute a failed play for the offense when rushing from the right side.
assistsFloat64Assisted tackles credited to the player.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
lhs_tacklesFloat64Tackles made when rushing from the left side.
lhs_missesFloat64Missed tackles when rushing from the left side.

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

Raises​

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

Example​

pff_api_signature_defense_outside_pass_rush(league='nfl', season='2022', week='1')

pff_api_signature_defense_slot_coverage​

Signature stat: slot coverage

Endpoint URL: GET https://api.pff.com/v1/facet/signature/defense/slot_coverage

Valid URL: https://api.pff.com/v1/facet/signature/defense/slot_coverage?league=nfl&season=2022&week=1

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, and the SECOND positional argument of the four signature commands.
weekweekYWeek, and the THIRD positional argument of the four signature commands.

Returns​

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

col_nametypedescription
coverage_snapsFloat64Coverage snaps played while covering the slot.
coverage_snaps_per_receptionFloat64Coverage snaps played per reception allowed while covering the slot.
coverage_snaps_per_targetFloat64Coverage snaps played per target into the player's coverage while covering the slot.
draft_seasonFloat64Season of the player's NFL draft class, per PFF.
eligible_seasonFloat64Season of the player's NFL draft eligibility, per PFF.
franchise_idFloat64PFF franchise (team) id (integer join key).
interceptionsFloat64Interceptions made by the player while covering the slot.
jersey_numberStringJersey number (string; zero-padded, e.g. "09").
playerStringPlayer's display name as PFF lists it.
player_game_countFloat64Number of games the player appeared in over the covered span.
player_idFloat64PFF player id (integer; matches the /players id and every player_id join key).
positionStringPFF position code the player is listed at (e.g. QB, HB, FB, WR, TE, T, G, C, ED, DI, LB, CB, S, K, P).
qb_rating_againstFloat64NFL passer rating allowed on targets into the player's coverage while covering the slot.
receptionsFloat64Receptions allowed in the player's coverage while covering the slot.
targetsFloat64Passes thrown into the player's coverage (targets allowed) while covering the slot.
teamStringTeam abbreviation the player is credited to for the range.
team_nameStringTeam abbreviation the player is credited to for the range.
touchdownsFloat64Touchdowns allowed into the player's coverage while covering the slot.
yardsFloat64Receiving yards allowed in the player's coverage while covering the slot.
yards_after_catchFloat64Yards after the catch allowed in the player's coverage while covering the slot.
yards_per_coverage_snapFloat64Receiving yards allowed per coverage snap while covering the slot.

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

Raises​

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

Example​

pff_api_signature_defense_slot_coverage(league='nfl', season='2022', week='1')