NFL (sportsdataverse.nfl)

Data sources

Source	APIs / hosts	Functions	Auth
ESPN	cdn.espn.com, site.api.espn.com, site.web.api.espn.com +1 more	124	none
NFL.com Shield API	api.nfl.com	22	WEB_DESKTOP bearer token
NFL Pro	pro.nfl.com	32	none
Sleeper fantasy API	api.sleeper.app	15	none
PFF Developer API	api.pff.com	68	API key (SDV_PY_PFF_API_KEY)
PFF Premium Stats (LEGACY)	premium.pff.com	46	cookie (legacy)
nflverse data releases	github.com	46	none
sportsdataverse-data releases	github.com	21	none
Fox Sports API	api.foxsports.com	25	none
Additional functions	hand-written wrappers & helpers	166	—

ESPN

Reference	Functions
ESPN site API (v2)	24
ESPN web API (v3)	5
ESPN core API (v2)	84
ESPN FPI API (fitt v3)	1
ESPN CDN API (cdn.espn.com)	4
Hand-written wrappers	6

NFL.com Shield API

Reference	Functions
NFL.com API	15
Hand-written wrappers	7

NFL Pro

Reference	Functions
nflpro	16
Hand-written wrappers	16

Sleeper fantasy API

Reference	Functions
Sleeper fantasy API v1 (api.sleeper.app)	15

PFF Developer API

Reference	Functions
PFF Developer API (api.pff.com, API key)	68

PFF Premium Stats (LEGACY)

Reference	Functions
PFF Premium Stats -- LEGACY (premium.pff.com, cookie auth; use the PFF Developer API)	46

nflverse data releases

Reference	Functions
nflverse data releases	8
Hand-written wrappers	38

sportsdataverse-data releases

Reference	Functions
sportsdataverse-data releases	21

Fox Sports API

Reference	Functions
Hand-written wrappers	25

Tools and helpers

Play-by-play processing

• NFLPlayProcess
• build_nfl_player_stats
• build_nfl_player_stats_def
• build_nfl_player_stats_kicking
• build_nfl_rosters
• build_nfl_season
• build_nfl_team_stats
• calculate_nfl_series_conversion_rates
• clean_nfl_pbp
• shield_nfl_pbp
• shield_to_espn_summary
• team_name_fn

Models and calculators

• adjust_pressure_pairs
• calculate_completion_probability
• calculate_epa
• calculate_expected_points
• calculate_win_probability
• calculate_wpa
• calculate_xpass
• calculate_xyac
• efficiency_ratings
• env_adjusted_make_prob
• fg_make_probability
• fit_nfl_field_position_ep
• get_2pt_probs
• get_2pt_wp
• get_4th_down_probs
• get_fg_wp
• get_go_wp
• get_punt_wp
• load_nfl_fp_curve
• nfl_compute_results
• nfl_draft_projection
• nfl_fantasy_projection
• nfl_kicker_rating
• nfl_line_grades
• nfl_player_projection
• nfl_ratings
• nfl_simulations
• nfl_usage_projection
• opponent_adjusted_ridge
• pressure_pairs
• special_teams_ratings
• team_pressure_rates

Analytics

• calculate_nfl_standings
• compose_counting_projection
• nfl_availability_projection
• nfl_game_script
• nfl_play_call_probabilities
• nfl_play_call_tendencies
• nfl_player_props
• nfl_predict_games
• nfl_punter_value
• nfl_season_standings
• nfl_special_teams_epa
• playcall_features
• player_usage_efficiency
• predict_margin
• predict_total
• team_game_pace
• win_prob_from_margin

Cache and configuration

• NflConfig
• cached_loader
• clear_cache
• get_config
• reset_config
• update_config

Dates and seasons

• get_current_nfl_season
• get_current_nfl_week
• get_current_season
• get_current_week
• most_recent_nfl_season

IDs and crosswalks

• build_nfl_players
• nfl_players_crosswalk

Examples

Worked examples — executed notebooks rendered as pages (refreshed weekly against the live APIs):

• Quickstart
• NFL tutorial

Python ↔ R parity

Each sportsdataverse function and its equivalent in the sister R package, nflreadr. Same-named where possible; the R column links the package's pkgdown reference.

sportsdataverse.nfl (Python)	nflreadr (R)
clear_cache	clear_cache
get_current_season	get_current_season
get_current_week	get_current_week
load_combine	load_combine
load_contracts	load_contracts
load_depth_charts	load_depth_charts
load_draft_picks	load_draft_picks
load_espn_qbr	load_espn_qbr
load_ff_opportunity	load_ff_opportunity
load_ff_playerids	load_ff_playerids
load_ff_rankings	load_ff_rankings
load_ftn_charting	load_ftn_charting
load_injuries	load_injuries
load_nextgen_stats	load_nextgen_stats
load_nfl_combine	load_combine
load_nfl_contracts	load_contracts
load_nfl_depth_charts	load_depth_charts
load_nfl_draft_picks	load_draft_picks
load_nfl_espn_qbr	load_espn_qbr
load_nfl_ff_opportunity	load_ff_opportunity
load_nfl_ff_playerids	load_ff_playerids
load_nfl_ff_rankings	load_ff_rankings
load_nfl_ftn_charting	load_ftn_charting
load_nfl_injuries	load_injuries
load_nfl_nextgen_stats	load_nextgen_stats
load_nfl_officials	load_officials
load_nfl_pbp	load_pbp
load_nfl_pbp_participation	load_participation
load_nfl_pfr_advstats	load_pfr_advstats
load_nfl_player_stats	load_player_stats
load_nfl_players	load_players
load_nfl_rosters	load_rosters
load_nfl_schedule	load_schedules
load_nfl_snap_counts	load_snap_counts
load_nfl_team_stats	load_team_stats
load_nfl_teams	load_teams
load_nfl_trades	load_trades
load_nfl_weekly_rosters	load_rosters_weekly
load_officials	load_officials
load_participation	load_participation
load_pfr_advstats	load_pfr_advstats
load_player_stats	load_player_stats
load_players	load_players
load_rosters_weekly	load_rosters_weekly
load_schedules	load_schedules
load_snap_counts	load_snap_counts
load_team_stats	load_team_stats
load_teams	load_teams
load_trades	load_trades