NFL — PFF Premium Stats (premium.pff.com)
sportsdataverse.nfl — 46 endpoints.
pff_facet_run_defense_summary
Facet report /defense/run (By Position leaderboard; add franchiseId for By Team, gameId for By Game)
Endpoint URL: GET https://premium.pff.com/api/v1/facet/defense/run
Valid URL: https://premium.pff.com/api/v1/facet/defense/run
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
league | league | Y | League slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules. | ||
season | season | Y | Season (starting year). | ||
week | week | Y | Week or week-group key (e.g. 'REG', a week number, or a range). | ||
franchiseId | franchise_id | Y | PFF franchise (team) id; filters a report 'By Team'. | ||
gameId | game_id | Y | PFF game id; filters a report 'By Game'. | ||
division | division | Y | Division filter (NCAA). |
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 |
|---|---|---|
assists | numeric | Total assists. |
avg_depth_of_tackle | numeric | |
declined_penalties | numeric | |
draft_season | numeric | |
eligible_season | numeric | |
forced_fumbles | numeric | |
franchise_id | numeric | ESPN franchise identifier. |
grades_coverage_defense | numeric | |
grades_defense | numeric | |
grades_defense_penalty | numeric | |
grades_pass_rush_defense | numeric | |
grades_run_defense | numeric | |
grades_tackle | numeric | |
jersey_number | character | Jersey number. Often useful for joins by name/team/jersey. |
missed_tackle_rate | numeric | |
missed_tackles | numeric | |
penalties | numeric | Total number of penalties. |
player | character | Player name |
player_game_count | numeric | |
player_id | numeric | Player ID (aka GSIS ID) as defined by nflreadr::load_rosters |
position | character | Primary position as reported by NFL.com |
run_stop_opp | numeric | |
snap_counts_run | numeric | |
stop_percent | numeric | |
stops | numeric | |
tackles | numeric | Team tackles. |
team | character | NFL team. Uses official abbreviations as per NFL.com |
team_name | character | Full team display name (e.g. 'Las Vegas Aces'). |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
pff_facet_run_defense_summary()
Last validated n/a.
pff_facet_field_goal_summary
Facet report /field_goal/summary (By Position leaderboard; add franchiseId for By Team, gameId for By Game)
Endpoint URL: GET https://premium.pff.com/api/v1/facet/field_goal/summary
Valid URL: https://premium.pff.com/api/v1/facet/field_goal/summary
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
league | league | Y | League slug (nfl/ncaa/aaf/ufl); pre-bound by the per-league shim modules. | ||
season | season | Y | Season (starting year). | ||
week | week | Y | Week or week-group key (e.g. 'REG', a week number, or a range). | ||
franchiseId | franchise_id | Y | PFF franchise (team) id; filters a report 'By Team'. | ||
gameId | game_id | Y | PFF game id; filters a report 'By Game'. | ||
division | division | Y | Division filter (NCAA). |
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 |
|---|---|---|
twenty_attempts | numeric | |
pat_percent | numeric | |
draft_season | numeric | |
forty_made | numeric | |
team_name | character | Full team display name (e.g. 'Las Vegas Aces'). |
fifty_percent | numeric | |
total_made | numeric | |
jersey_number | character | Jersey number. Often useful for joins by name/team/jersey. |
one_made | numeric | |
fifty_attempts | numeric | |
forty_attempts | numeric | |
player_game_count | numeric | |
eligible_season | numeric | |
thirty_percent | numeric | |
total_attempts | numeric | |
pat_attempts | numeric | |
twenty_made | numeric | |
one_attempts | numeric | |
grades_fgep_kicker | numeric | |
thirty_attempts | numeric | |
penalties | numeric | Total number of penalties. |
pat_made | numeric | |
team | character | NFL team. Uses official abbreviations as per NFL.com |
declined_penalties | numeric | |
one_percent | numeric | |
total_percent | numeric | |
position | character | Primary position as reported by NFL.com |
twenty_percent | numeric | |
forty_percent | numeric | |
player | character | Player name |
franchise_id | numeric | ESPN franchise identifier. |
fifty_made | numeric | |
thirty_made | numeric | |
player_id | numeric | Player ID (aka GSIS ID) as defined by nflreadr::load_rosters |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
pff_facet_field_goal_summary()
Last validated n/a.