Version: 0.0.56

sportsdataverse-py quickstart

A cross-sport tour of the package — its layout, naming, and return types. Start here, then jump to the notebook for your sport.

The shape of the package. Every wrapper returns a raw Dict by default; opt into a tidy polars (or pandas) DataFrame with return_parsed=True (ESPN wrappers), a matching parse_* function (native NHL/MLB APIs), or by importing from the sportsdataverse.parsed.<league> mirror. Names follow a predictable pattern: espn_<league>_<entity>() for ESPN, <league>_* for a league's native API (NHL/MLB), and load_<league>_*() for pre-built parquet releases.

Part of the SportsDataverse — the names here mirror the R sisters (hoopR, wehoop, cfbfastR, baseballr, fastRhockey). See Ecosystem & philosophy for the full picture.

Setup

pip install sportsdataverse
# or
uv add sportsdataverse

import polars as pl
import sportsdataverse as sdv

Package layout

Each sport lives in its own submodule:

Submodule	Coverage
`sdv.cfb`	NCAA football: PBP, schedule, teams, play participants
`sdv.nfl`	NFL: nflverse parquet (PBP, schedules, NextGen, PFR)
`sdv.mbb`	NCAA men's basketball: PBP, schedule, rosters
`sdv.wbb`	NCAA women's basketball: PBP, schedule, rosters, stats, standings
`sdv.nba`	NBA: PBP, schedule, teams, rosters
`sdv.wnba`	WNBA: PBP, schedule, rosters, stats, standings, draft
`sdv.nhl`	NHL: PBP, schedule, teams

[m for m in dir(sdv) if not m.startswith('_')]

['Any',
 'Booster',
 'CFBPlayProcess',
 'DMatrix',
 'Dict',
 'EDGE_ENDPOINT_PARSERS',
 'EDGE_SUBFRAME_PARSERS',
 'Iterable',
 'List',
 'Literal',
 'MLB_API_ENDPOINT_PARSERS',
 'NFLPlayProcess',
 'NFL_BASE_URL',
 'NFL_COMBINE_URL',
 'NFL_CONTRACTS_URL',
 'NFL_DEPTH_CHARTS_URL',
 'NFL_DRAFT_PICKS_URL',
 'NFL_FF_OPPORTUNITY_URL',
 'NFL_FF_PLAYERIDS_URL',
 'NFL_FF_RANKINGS_ALL_URL',
 'NFL_FF_RANKINGS_DRAFT_URL',
 'NFL_FF_RANKINGS_WEEK_URL',
 'NFL_FTN_CHARTING_URL',
 'NFL_INJURIES_URL',
 'NFL_NGS_PASSING_URL',
 'NFL_NGS_RECEIVING_URL',
 'NFL_NGS_RUSHING_URL',
 'NFL_OFFICIALS_URL',
 'NFL_PBP_PARTICIPATION_URL',
 'NFL_PFR_SEASON_DEF_URL',
 'NFL_PFR_SEASON_PASS_URL',
 'NFL_PFR_SEASON_REC_URL',
 'NFL_PFR_SEASON_RUSH_URL',
 'NFL_PFR_WEEK_DEF_URL',
 'NFL_PFR_WEEK_PASS_URL',
 'NFL_PFR_WEEK_REC_URL',
 'NFL_PFR_WEEK_RUSH_URL',
 'NFL_PLAYER_KICKING_STATS_URL',
 'NFL_PLAYER_STATS_URL',
 'NFL_PLAYER_URL',
 'NFL_ROSTER_URL',
 'NFL_SNAP_COUNTS_URL',
 'NFL_TEAM_LOGO_URL',
 'NFL_TEAM_SCHEDULE_URL',
 'NFL_TEAM_STATS_URL',
 'NFL_TRADES_URL',
 'NFL_WEEKLY_ROSTER_URL',
 'NHL_API_WEB_ENDPOINT_PARSERS',
 'NHL_STATS_REST_ENDPOINT_PARSERS',
 'NflConfig',
 'Optional',
 'STATCAST_EMPTY',
 'SeasonNotFoundError',
 'StringIO',
 'Union',
 'annotations',
 'cache',
 'cache_stats',
 'cached_loader',
 'cfb',
 'cfb_espn_ext',
 'cfb_game_rosters',
 'cfb_loaders',
 'cfb_loaders_extra',
 'cfb_pbp',
 'cfb_play_participants',
 'cfb_player_stats',
 'cfb_schedule',
 'cfb_teams',
 'clear_cache',
 'clear_team_cache',
 'config',
 'datasets',
 'datetime',
 'defense_score_vec',
 'discover',
 'dl_utils',
 'download',
 'end_change_vec',
 'ep_class_to_score_mapping',
 'ep_end_columns',
 'ep_final_names',
 'ep_model',
 'ep_model_file',
 'ep_start_columns',
 'ep_start_touchback_columns',
 'errors',
 'espn_cfb_award',
 'espn_cfb_awards',
 'espn_cfb_calendar',
 'espn_cfb_calendar_offseason',
 'espn_cfb_calendar_ondays',
 'espn_cfb_calendar_postseason',
 'espn_cfb_calendar_regular_season',
 'espn_cfb_coach',
 'espn_cfb_coach_record',
 'espn_cfb_coach_season',
 'espn_cfb_coaches',
 'espn_cfb_conferences',
 'espn_cfb_draft',
 'espn_cfb_franchise',
 'espn_cfb_franchises',
 'espn_cfb_futures',
 'espn_cfb_game',
 'espn_cfb_game_broadcasts',
 'espn_cfb_game_competition',
 'espn_cfb_game_leaders',
 'espn_cfb_game_odds',
 'espn_cfb_game_official_detail',
 'espn_cfb_game_officials',
 'espn_cfb_game_play',
 'espn_cfb_game_play_personnel',
 'espn_cfb_game_plays',
 'espn_cfb_game_powerindex',
 'espn_cfb_game_predictor',
 'espn_cfb_game_probabilities',
 'espn_cfb_game_propbets',
 'espn_cfb_game_rosters',
 'espn_cfb_game_scoringplays',
 'espn_cfb_game_situation',
 'espn_cfb_game_status',
 'espn_cfb_game_team',
 'espn_cfb_game_team_leaders',
 'espn_cfb_game_team_linescores',
 'espn_cfb_game_team_record',
 'espn_cfb_game_team_roster',
 'espn_cfb_game_team_statistics',
 'espn_cfb_game_teams',
 'espn_cfb_games',
 'espn_cfb_groups',
 'espn_cfb_injuries',
 'espn_cfb_leaders',
 'espn_cfb_leaders_core',
 'espn_cfb_league_notes',
 'espn_cfb_league_root',
 'espn_cfb_news',
 'espn_cfb_play_participants',
 'espn_cfb_player_awards',
 'espn_cfb_player_bio',
 'espn_cfb_player_career_stats',
 'espn_cfb_player_contracts',
 'espn_cfb_player_core',
 'espn_cfb_player_eventlog',
 'espn_cfb_player_gamelog',
 'espn_cfb_player_info',
 'espn_cfb_player_injuries',
 'espn_cfb_player_news',
 'espn_cfb_player_notes',
 'espn_cfb_player_overview',
 'espn_cfb_player_records',
 'espn_cfb_player_seasons',
 'espn_cfb_player_splits',
 'espn_cfb_player_statisticslog',
 'espn_cfb_player_stats',
 'espn_cfb_player_stats_v3',
 'espn_cfb_player_vs_player',
 'espn_cfb_players_index',
 'espn_cfb_position',
 'espn_cfb_positions',
 'espn_cfb_rankings',
 'espn_cfb_recruits',
 'espn_cfb_schedule',
 'espn_cfb_scoreboard',
 'espn_cfb_season_awards',
 'espn_cfb_season_coaches',
 'espn_cfb_season_draft',
 'espn_cfb_season_draft_round_picks',
 'espn_cfb_season_freeagents',
 'espn_cfb_season_group',
 'espn_cfb_season_group_children',
 'espn_cfb_season_group_teams',
 'espn_cfb_season_info',
 'espn_cfb_season_players',
 'espn_cfb_season_pointer',
 'espn_cfb_season_powerindex_leaders',
 'espn_cfb_season_qbr',
 'espn_cfb_season_qbr_week',
 'espn_cfb_season_team',
 'espn_cfb_season_teams',
 'espn_cfb_season_type',
 'espn_cfb_season_type_corrections',
 'espn_cfb_season_type_leaders',
 'espn_cfb_season_types',
 'espn_cfb_season_week',
 'espn_cfb_season_week_games',
 'espn_cfb_season_weeks',
 'espn_cfb_seasons',
 'espn_cfb_standings',
 'espn_cfb_standings_core',
 'espn_cfb_statistics_league',
 'espn_cfb_summary',
 'espn_cfb_talentpicks',
 'espn_cfb_team',
 'espn_cfb_team_core',
 'espn_cfb_team_depthcharts',
 'espn_cfb_team_history',
 'espn_cfb_team_injuries',
 'espn_cfb_team_leaders',
 'espn_cfb_team_news',
 'espn_cfb_team_powerindex',
 'espn_cfb_team_record',
 'espn_cfb_team_roster',
 'espn_cfb_team_schedule',
 'espn_cfb_team_transactions',
 'espn_cfb_teams',
 'espn_cfb_teams_core',
 'espn_cfb_teams_site',
 'espn_cfb_tournaments',
 'espn_cfb_transactions',
 'espn_cfb_venue',
 'espn_cfb_venues',
 'espn_cfb_week_rankings',
 'espn_mbb_award',
 'espn_mbb_awards',
 'espn_mbb_calendar',
 'espn_mbb_calendar_offseason',
 'espn_mbb_calendar_ondays',
 'espn_mbb_calendar_postseason',
 'espn_mbb_calendar_regular_season',
 'espn_mbb_coach',
 'espn_mbb_coach_record',
 'espn_mbb_coach_season',
 'espn_mbb_coaches',
 'espn_mbb_conferences',
 'espn_mbb_draft',
 'espn_mbb_franchise',
 'espn_mbb_franchises',
 'espn_mbb_game',
 'espn_mbb_game_broadcasts',
 'espn_mbb_game_competition',
 'espn_mbb_game_leaders',
 'espn_mbb_game_odds',
 'espn_mbb_game_official_detail',
 'espn_mbb_game_officials',
 'espn_mbb_game_play',
 'espn_mbb_game_play_personnel',
 'espn_mbb_game_plays',
 'espn_mbb_game_powerindex',
 'espn_mbb_game_predictor',
 'espn_mbb_game_probabilities',
 'espn_mbb_game_propbets',
 'espn_mbb_game_rosters',
 'espn_mbb_game_scoringplays',
 'espn_mbb_game_situation',
 'espn_mbb_game_status',
 'espn_mbb_game_team',
 'espn_mbb_game_team_leaders',
 'espn_mbb_game_team_linescores',
 'espn_mbb_game_team_record',
 'espn_mbb_game_team_roster',
 'espn_mbb_game_team_statistics',
 'espn_mbb_game_teams',
 'espn_mbb_games',
 'espn_mbb_injuries',
 'espn_mbb_leaders',
 'espn_mbb_leaders_core',
 'espn_mbb_league_notes',
 'espn_mbb_league_root',
 'espn_mbb_news',
 'espn_mbb_pbp',
 'espn_mbb_player_awards',
 'espn_mbb_player_bio',
 'espn_mbb_player_career_stats',
 'espn_mbb_player_contracts',
 'espn_mbb_player_core',
 'espn_mbb_player_eventlog',
 'espn_mbb_player_gamelog',
 'espn_mbb_player_info',
 'espn_mbb_player_injuries',
 'espn_mbb_player_news',
 'espn_mbb_player_notes',
 'espn_mbb_player_overview',
 'espn_mbb_player_records',
 'espn_mbb_player_seasons',
 'espn_mbb_player_splits',
 'espn_mbb_player_statisticslog',
 'espn_mbb_player_stats',
 'espn_mbb_player_stats_v3',
 'espn_mbb_player_vs_player',
 'espn_mbb_players_index',
 'espn_mbb_position',
 'espn_mbb_positions',
 'espn_mbb_rankings',
 'espn_mbb_schedule',
 'espn_mbb_scoreboard',
 'espn_mbb_season_awards',
 'espn_mbb_season_coaches',
 'espn_mbb_season_draft',
 'espn_mbb_season_draft_round_picks',
 'espn_mbb_season_freeagents',
 'espn_mbb_season_futures',
 'espn_mbb_season_group',
 'espn_mbb_season_group_children',
 'espn_mbb_season_group_teams',
 'espn_mbb_season_groups',
 'espn_mbb_season_info',
 'espn_mbb_season_players',
 'espn_mbb_season_pointer',
 'espn_mbb_season_powerindex',
 'espn_mbb_season_powerindex_leaders',
 'espn_mbb_season_recruits',
 'espn_mbb_season_team',
 'espn_mbb_season_teams',
 'espn_mbb_season_type',
 'espn_mbb_season_type_corrections',
 'espn_mbb_season_type_leaders',
 'espn_mbb_season_types',
 'espn_mbb_season_week',
 'espn_mbb_season_week_games',
 'espn_mbb_season_week_rankings',
 'espn_mbb_season_weeks',
 'espn_mbb_seasons',
 'espn_mbb_standings',
 'espn_mbb_standings_core',
 'espn_mbb_statistics_league',
 'espn_mbb_summary',
 'espn_mbb_talentpicks',
 'espn_mbb_team',
 'espn_mbb_team_core',
 'espn_mbb_team_depthcharts',
 'espn_mbb_team_history',
 'espn_mbb_team_injuries',
 'espn_mbb_team_leaders',
 'espn_mbb_team_news',
 'espn_mbb_team_record',
 'espn_mbb_team_roster',
 'espn_mbb_team_schedule',
 'espn_mbb_team_transactions',
 'espn_mbb_teams',
 'espn_mbb_teams_core',
 'espn_mbb_teams_site',
 'espn_mbb_tournaments',
 'espn_mbb_transactions',
 'espn_mbb_venue',
 'espn_mbb_venues',
 'espn_mlb_award',
 'espn_mlb_awards',
 'espn_mlb_calendar',
 'espn_mlb_calendar_offseason',
 'espn_mlb_calendar_ondays',
 'espn_mlb_calendar_postseason',
 'espn_mlb_calendar_regular_season',
 'espn_mlb_coach',
 'espn_mlb_coach_record',
 'espn_mlb_coach_season',
 'espn_mlb_coaches',
 'espn_mlb_conferences',
 'espn_mlb_draft',
 'espn_mlb_franchise',
 'espn_mlb_franchises',
 'espn_mlb_game',
 'espn_mlb_game_broadcasts',
 'espn_mlb_game_competition',
 'espn_mlb_game_leaders',
 'espn_mlb_game_odds',
 'espn_mlb_game_official_detail',
 'espn_mlb_game_officials',
 'espn_mlb_game_play',
 'espn_mlb_game_play_personnel',
 'espn_mlb_game_plays',
 'espn_mlb_game_powerindex',
 'espn_mlb_game_predictor',
 'espn_mlb_game_probabilities',
 'espn_mlb_game_propbets',
 'espn_mlb_game_rosters',
 'espn_mlb_game_scoringplays',
 'espn_mlb_game_situation',
 'espn_mlb_game_status',
 'espn_mlb_game_team',
 'espn_mlb_game_team_leaders',
 'espn_mlb_game_team_linescores',
 'espn_mlb_game_team_record',
 'espn_mlb_game_team_roster',
 'espn_mlb_game_team_statistics',
 'espn_mlb_game_teams',
 'espn_mlb_games',
 'espn_mlb_injuries',
 'espn_mlb_leaders',
 'espn_mlb_leaders_core',
 'espn_mlb_league_notes',
 'espn_mlb_league_root',
 'espn_mlb_news',
 'espn_mlb_pbp',
 'espn_mlb_player_awards',
 'espn_mlb_player_bio',
 'espn_mlb_player_career_stats',
 'espn_mlb_player_contracts',
 'espn_mlb_player_core',
 'espn_mlb_player_eventlog',
 'espn_mlb_player_gamelog',
 'espn_mlb_player_hotzones',
 'espn_mlb_player_info',
 'espn_mlb_player_injuries',
 'espn_mlb_player_news',
 'espn_mlb_player_notes',
 'espn_mlb_player_overview',
 'espn_mlb_player_records',
 'espn_mlb_player_seasons',
 'espn_mlb_player_splits',
 'espn_mlb_player_statisticslog',
 'espn_mlb_player_stats',
 'espn_mlb_player_stats_v3',
 'espn_mlb_player_vs_player',
 'espn_mlb_players_index',
 'espn_mlb_position',
 'espn_mlb_positions',
 'espn_mlb_schedule',
 'espn_mlb_scoreboard',
 'espn_mlb_season_awards',
 'espn_mlb_season_coaches',
 'espn_mlb_season_draft',
 'espn_mlb_season_draft_round_picks',
 'espn_mlb_season_freeagents',
 'espn_mlb_season_futures',
 'espn_mlb_season_group',
 'espn_mlb_season_group_children',
 'espn_mlb_season_group_teams',
 'espn_mlb_season_groups',
 'espn_mlb_season_info',
 'espn_mlb_season_players',
 'espn_mlb_season_pointer',
 'espn_mlb_season_powerindex',
 'espn_mlb_season_powerindex_leaders',
 'espn_mlb_season_team',
 'espn_mlb_season_teams',
 'espn_mlb_season_type',
 'espn_mlb_season_type_corrections',
 'espn_mlb_season_type_leaders',
 'espn_mlb_season_types',
 'espn_mlb_season_week',
 'espn_mlb_season_week_games',
 'espn_mlb_season_weeks',
 'espn_mlb_seasons',
 'espn_mlb_standings',
 'espn_mlb_standings_core',
 'espn_mlb_statistics_league',
 'espn_mlb_summary',
 'espn_mlb_talentpicks',
 'espn_mlb_team',
 'espn_mlb_team_core',
 'espn_mlb_team_depthcharts',
 'espn_mlb_team_history',
 'espn_mlb_team_injuries',
 'espn_mlb_team_leaders',
 'espn_mlb_team_news',
 'espn_mlb_team_record',
 'espn_mlb_team_roster',
 'espn_mlb_team_schedule',
 'espn_mlb_team_transactions',
 'espn_mlb_teams',
 'espn_mlb_teams_core',
 'espn_mlb_teams_site',
 'espn_mlb_tournaments',
 'espn_mlb_transactions',
 'espn_mlb_venue',
 'espn_mlb_venues',
 'espn_nba_award',
 'espn_nba_awards',
 'espn_nba_calendar',
 'espn_nba_calendar_offseason',
 'espn_nba_calendar_ondays',
 'espn_nba_calendar_postseason',
 'espn_nba_calendar_regular_season',
 'espn_nba_coach',
 'espn_nba_coach_record',
 'espn_nba_coach_season',
 'espn_nba_coaches',
 'espn_nba_conferences',
 'espn_nba_draft',
 'espn_nba_franchise',
 'espn_nba_franchises',
 'espn_nba_game',
 'espn_nba_game_broadcasts',
 'espn_nba_game_competition',
 'espn_nba_game_leaders',
 'espn_nba_game_odds',
 'espn_nba_game_official_detail',
 'espn_nba_game_officials',
 'espn_nba_game_play',
 'espn_nba_game_play_personnel',
 'espn_nba_game_plays',
 'espn_nba_game_powerindex',
 'espn_nba_game_predictor',
 'espn_nba_game_probabilities',
 'espn_nba_game_propbets',
 'espn_nba_game_rosters',
 'espn_nba_game_scoringplays',
 'espn_nba_game_situation',
 'espn_nba_game_status',
 'espn_nba_game_team',
 'espn_nba_game_team_leaders',
 'espn_nba_game_team_linescores',
 'espn_nba_game_team_record',
 'espn_nba_game_team_roster',
 'espn_nba_game_team_statistics',
 'espn_nba_game_teams',
 'espn_nba_games',
 'espn_nba_injuries',
 'espn_nba_leaders',
 'espn_nba_leaders_core',
 'espn_nba_league_notes',
 'espn_nba_league_root',
 'espn_nba_news',
 'espn_nba_pbp',
 'espn_nba_player_awards',
 'espn_nba_player_bio',
 'espn_nba_player_career_stats',
 'espn_nba_player_contracts',
 'espn_nba_player_core',
 'espn_nba_player_eventlog',
 'espn_nba_player_gamelog',
 'espn_nba_player_info',
 'espn_nba_player_injuries',
 'espn_nba_player_news',
 'espn_nba_player_notes',
 'espn_nba_player_overview',
 'espn_nba_player_records',
 'espn_nba_player_seasons',
 'espn_nba_player_splits',
 'espn_nba_player_statisticslog',
 'espn_nba_player_stats',
 'espn_nba_player_stats_v3',
 'espn_nba_player_vs_player',
 'espn_nba_players_index',
 'espn_nba_position',
 'espn_nba_positions',
 'espn_nba_schedule',
 'espn_nba_scoreboard',
 'espn_nba_season_awards',
 'espn_nba_season_coaches',
 'espn_nba_season_draft',
 'espn_nba_season_draft_round_picks',
 'espn_nba_season_freeagents',
 'espn_nba_season_futures',
 'espn_nba_season_group',
 'espn_nba_season_group_children',
 'espn_nba_season_group_teams',
 'espn_nba_season_groups',
 'espn_nba_season_info',
 'espn_nba_season_players',
 'espn_nba_season_pointer',
 'espn_nba_season_powerindex',
 'espn_nba_season_powerindex_leaders',
 'espn_nba_season_team',
 'espn_nba_season_teams',
 'espn_nba_season_type',
 'espn_nba_season_type_corrections',
 'espn_nba_season_type_leaders',
 'espn_nba_season_types',
 'espn_nba_season_week',
 'espn_nba_season_week_games',
 'espn_nba_season_weeks',
 'espn_nba_seasons',
 'espn_nba_standings',
 'espn_nba_standings_core',
 'espn_nba_statistics_league',
 'espn_nba_summary',
 'espn_nba_talentpicks',
 'espn_nba_team',
 'espn_nba_team_core',
 'espn_nba_team_depthcharts',
 'espn_nba_team_history',
 'espn_nba_team_injuries',
 'espn_nba_team_leaders',
 'espn_nba_team_news',
 'espn_nba_team_record',
 'espn_nba_team_roster',
 'espn_nba_team_schedule',
 'espn_nba_team_transactions',
 'espn_nba_teams',
 'espn_nba_teams_core',
 'espn_nba_teams_site',
 'espn_nba_tournaments',
 'espn_nba_transactions',
 'espn_nba_venue',
 'espn_nba_venues',
 'espn_nfl_award',
 'espn_nfl_awards',
 'espn_nfl_calendar',
 'espn_nfl_calendar_offseason',
 'espn_nfl_calendar_ondays',
 'espn_nfl_calendar_postseason',
 'espn_nfl_calendar_regular_season',
 'espn_nfl_coach',
 'espn_nfl_coach_record',
 'espn_nfl_coach_season',
 'espn_nfl_coaches',
 'espn_nfl_conferences',
 'espn_nfl_draft',
 'espn_nfl_franchise',
 'espn_nfl_franchises',
 'espn_nfl_game',
 'espn_nfl_game_broadcasts',
 'espn_nfl_game_competition',
 'espn_nfl_game_leaders',
 'espn_nfl_game_odds',
 'espn_nfl_game_official_detail',
 'espn_nfl_game_officials',
 'espn_nfl_game_play',
 'espn_nfl_game_play_personnel',
 'espn_nfl_game_plays',
 'espn_nfl_game_powerindex',
 'espn_nfl_game_predictor',
 'espn_nfl_game_probabilities',
 'espn_nfl_game_propbets',
 'espn_nfl_game_rosters',
 'espn_nfl_game_scoringplays',
 'espn_nfl_game_situation',
 'espn_nfl_game_status',
 'espn_nfl_game_team',
 'espn_nfl_game_team_leaders',
 'espn_nfl_game_team_linescores',
 'espn_nfl_game_team_record',
 'espn_nfl_game_team_roster',
 'espn_nfl_game_team_statistics',
 'espn_nfl_game_teams',
 'espn_nfl_games',
 'espn_nfl_injuries',
 'espn_nfl_leaders',
 'espn_nfl_leaders_core',
 'espn_nfl_league_notes',
 'espn_nfl_league_root',
 'espn_nfl_news',
 'espn_nfl_player_awards',
 'espn_nfl_player_bio',
 'espn_nfl_player_career_stats',
 'espn_nfl_player_contracts',
 'espn_nfl_player_core',
 'espn_nfl_player_eventlog',
 'espn_nfl_player_gamelog',
 'espn_nfl_player_info',
 'espn_nfl_player_injuries',
 'espn_nfl_player_news',
 'espn_nfl_player_notes',
 'espn_nfl_player_overview',
 'espn_nfl_player_records',
 'espn_nfl_player_seasons',
 'espn_nfl_player_splits',
 'espn_nfl_player_statisticslog',
 'espn_nfl_player_stats',
 'espn_nfl_player_stats_v3',
 'espn_nfl_player_vs_player',
 'espn_nfl_players_index',
 'espn_nfl_position',
 'espn_nfl_positions',
 'espn_nfl_schedule',
 'espn_nfl_scoreboard',
 'espn_nfl_season_awards',
 'espn_nfl_season_coaches',
 'espn_nfl_season_draft',
 'espn_nfl_season_draft_round_picks',
 'espn_nfl_season_freeagents',
 'espn_nfl_season_futures',
 'espn_nfl_season_group',
 'espn_nfl_season_group_children',
 'espn_nfl_season_group_teams',
 'espn_nfl_season_groups',
 'espn_nfl_season_info',
 'espn_nfl_season_players',
 'espn_nfl_season_pointer',
 'espn_nfl_season_powerindex',
 'espn_nfl_season_powerindex_leaders',
 'espn_nfl_season_qbr',
 'espn_nfl_season_qbr_week',
 'espn_nfl_season_team',
 'espn_nfl_season_teams',
 'espn_nfl_season_type',
 'espn_nfl_season_type_corrections',
 'espn_nfl_season_type_leaders',
 'espn_nfl_season_types',
 'espn_nfl_season_week',
 'espn_nfl_season_week_games',
 'espn_nfl_season_weeks',
 'espn_nfl_seasons',
 'espn_nfl_standings',
 'espn_nfl_standings_core',
 'espn_nfl_statistics_league',
 'espn_nfl_summary',
 'espn_nfl_talentpicks',
 'espn_nfl_team',
 'espn_nfl_team_core',
 'espn_nfl_team_depthcharts',
 'espn_nfl_team_history',
 'espn_nfl_team_injuries',
 'espn_nfl_team_leaders',
 'espn_nfl_team_news',
 'espn_nfl_team_record',
 'espn_nfl_team_roster',
 'espn_nfl_team_schedule',
 'espn_nfl_team_transactions',
 'espn_nfl_teams',
 'espn_nfl_teams_core',
 'espn_nfl_teams_site',
 'espn_nfl_tournaments',
 'espn_nfl_transactions',
 'espn_nfl_venue',
 'espn_nfl_venues',
 'espn_nhl_award',
 'espn_nhl_awards',
 'espn_nhl_calendar',
 'espn_nhl_calendar_offseason',
 'espn_nhl_calendar_ondays',
 'espn_nhl_calendar_postseason',
 'espn_nhl_calendar_regular_season',
 'espn_nhl_coach',
 'espn_nhl_coach_record',
 'espn_nhl_coach_season',
 'espn_nhl_coaches',
 'espn_nhl_conferences',
 'espn_nhl_draft',
 'espn_nhl_franchise',
 'espn_nhl_franchises',
 'espn_nhl_game',
 'espn_nhl_game_broadcasts',
 'espn_nhl_game_competition',
 'espn_nhl_game_leaders',
 'espn_nhl_game_odds',
 'espn_nhl_game_official_detail',
 'espn_nhl_game_officials',
 'espn_nhl_game_play',
 'espn_nhl_game_play_personnel',
 'espn_nhl_game_plays',
 'espn_nhl_game_powerindex',
 'espn_nhl_game_predictor',
 'espn_nhl_game_probabilities',
 'espn_nhl_game_propbets',
 'espn_nhl_game_rosters',
 'espn_nhl_game_scoringplays',
 'espn_nhl_game_situation',
 'espn_nhl_game_status',
 'espn_nhl_game_team',
 'espn_nhl_game_team_leaders',
 'espn_nhl_game_team_linescores',
 'espn_nhl_game_team_record',
 'espn_nhl_game_team_roster',
 'espn_nhl_game_team_statistics',
 'espn_nhl_game_teams',
 'espn_nhl_games',
 'espn_nhl_injuries',
 'espn_nhl_leaders',
 'espn_nhl_leaders_core',
 'espn_nhl_league_notes',
 'espn_nhl_league_root',
 'espn_nhl_news',
 'espn_nhl_pbp',
 'espn_nhl_player_awards',
 'espn_nhl_player_bio',
 'espn_nhl_player_career_stats',
 'espn_nhl_player_contracts',
 'espn_nhl_player_core',
 'espn_nhl_player_eventlog',
 'espn_nhl_player_gamelog',
 'espn_nhl_player_info',
 'espn_nhl_player_injuries',
 'espn_nhl_player_news',
 'espn_nhl_player_notes',
 'espn_nhl_player_overview',
 'espn_nhl_player_records',
 'espn_nhl_player_seasons',
 'espn_nhl_player_splits',
 'espn_nhl_player_statisticslog',
 'espn_nhl_player_stats',
 'espn_nhl_player_stats_v3',
 'espn_nhl_player_vs_player',
 'espn_nhl_players_index',
 'espn_nhl_position',
 'espn_nhl_positions',
 'espn_nhl_schedule',
 'espn_nhl_scoreboard',
 'espn_nhl_season_awards',
 'espn_nhl_season_coaches',
 'espn_nhl_season_draft',
 'espn_nhl_season_draft_round_picks',
 'espn_nhl_season_freeagents',
 'espn_nhl_season_futures',
 'espn_nhl_season_group',
 'espn_nhl_season_group_children',
 'espn_nhl_season_group_teams',
 'espn_nhl_season_groups',
 'espn_nhl_season_info',
 'espn_nhl_season_players',
 'espn_nhl_season_pointer',
 'espn_nhl_season_powerindex',
 'espn_nhl_season_powerindex_leaders',
 'espn_nhl_season_team',
 'espn_nhl_season_teams',
 'espn_nhl_season_type',
 'espn_nhl_season_type_corrections',
 'espn_nhl_season_type_leaders',
 'espn_nhl_season_types',
 'espn_nhl_season_week',
 'espn_nhl_season_week_games',
 'espn_nhl_season_weeks',
 'espn_nhl_seasons',
 'espn_nhl_standings',
 'espn_nhl_standings_core',
 'espn_nhl_statistics_league',
 'espn_nhl_summary',
 'espn_nhl_talentpicks',
 'espn_nhl_team',
 'espn_nhl_team_core',
 'espn_nhl_team_depthcharts',
 'espn_nhl_team_history',
 'espn_nhl_team_injuries',
 'espn_nhl_team_leaders',
 'espn_nhl_team_news',
 'espn_nhl_team_record',
 'espn_nhl_team_roster',
 'espn_nhl_team_schedule',
 'espn_nhl_team_transactions',
 'espn_nhl_teams',
 'espn_nhl_teams_core',
 'espn_nhl_teams_site',
 'espn_nhl_tournaments',
 'espn_nhl_transactions',
 'espn_nhl_venue',
 'espn_nhl_venues',
 'espn_wbb_award',
 'espn_wbb_awards',
 'espn_wbb_calendar',
 'espn_wbb_calendar_offseason',
 'espn_wbb_calendar_ondays',
 'espn_wbb_calendar_postseason',
 'espn_wbb_calendar_regular_season',
 'espn_wbb_coach',
 'espn_wbb_coach_record',
 'espn_wbb_coach_season',
 'espn_wbb_coaches',
 'espn_wbb_conferences',
 'espn_wbb_draft',
 'espn_wbb_franchise',
 'espn_wbb_franchises',
 'espn_wbb_game',
 'espn_wbb_game_broadcasts',
 'espn_wbb_game_competition',
 'espn_wbb_game_leaders',
 'espn_wbb_game_odds',
 'espn_wbb_game_official_detail',
 'espn_wbb_game_officials',
 'espn_wbb_game_play',
 'espn_wbb_game_play_personnel',
 'espn_wbb_game_plays',
 'espn_wbb_game_powerindex',
 'espn_wbb_game_predictor',
 'espn_wbb_game_probabilities',
 'espn_wbb_game_propbets',
 'espn_wbb_game_rosters',
 'espn_wbb_game_scoringplays',
 'espn_wbb_game_situation',
 'espn_wbb_game_status',
 'espn_wbb_game_team',
 'espn_wbb_game_team_leaders',
 'espn_wbb_game_team_linescores',
 'espn_wbb_game_team_record',
 'espn_wbb_game_team_roster',
 'espn_wbb_game_team_statistics',
 'espn_wbb_game_teams',
 'espn_wbb_games',
 'espn_wbb_injuries',
 'espn_wbb_leaders',
 'espn_wbb_leaders_core',
 'espn_wbb_league_notes',
 'espn_wbb_league_root',
 'espn_wbb_news',
 'espn_wbb_pbp',
 'espn_wbb_player_awards',
 'espn_wbb_player_bio',
 'espn_wbb_player_career_stats',
 'espn_wbb_player_contracts',
 'espn_wbb_player_core',
 'espn_wbb_player_eventlog',
 'espn_wbb_player_gamelog',
 'espn_wbb_player_info',
 'espn_wbb_player_injuries',
 'espn_wbb_player_news',
 'espn_wbb_player_notes',
 'espn_wbb_player_overview',
 'espn_wbb_player_records',
 'espn_wbb_player_seasons',
 'espn_wbb_player_splits',
 'espn_wbb_player_statisticslog',
 'espn_wbb_player_stats',
 'espn_wbb_player_stats_v3',
 'espn_wbb_player_vs_player',
 'espn_wbb_players_index',
 'espn_wbb_position',
 'espn_wbb_positions',
 'espn_wbb_rankings',
 'espn_wbb_schedule',
 'espn_wbb_scoreboard',
 'espn_wbb_season_awards',
 'espn_wbb_season_coaches',
 'espn_wbb_season_draft',
 'espn_wbb_season_draft_round_picks',
 'espn_wbb_season_freeagents',
 'espn_wbb_season_futures',
 'espn_wbb_season_group',
 'espn_wbb_season_group_children',
 'espn_wbb_season_group_teams',
 'espn_wbb_season_groups',
 'espn_wbb_season_info',
 'espn_wbb_season_players',
 'espn_wbb_season_pointer',
 'espn_wbb_season_powerindex',
 'espn_wbb_season_powerindex_leaders',
 'espn_wbb_season_recruits',
 'espn_wbb_season_team',
 'espn_wbb_season_teams',
 'espn_wbb_season_type',
 'espn_wbb_season_type_corrections',
 'espn_wbb_season_type_leaders',
 'espn_wbb_season_types',
 'espn_wbb_season_week',
 'espn_wbb_season_week_games',
 'espn_wbb_season_week_rankings',
 'espn_wbb_season_weeks',
 'espn_wbb_seasons',
 'espn_wbb_standings',
 'espn_wbb_standings_core',
 'espn_wbb_statistics_league',
 'espn_wbb_summary',
 'espn_wbb_talentpicks',
 'espn_wbb_team',
 'espn_wbb_team_core',
 'espn_wbb_team_depthcharts',
 'espn_wbb_team_history',
 'espn_wbb_team_injuries',
 'espn_wbb_team_leaders',
 'espn_wbb_team_news',
 'espn_wbb_team_record',
 'espn_wbb_team_roster',
 'espn_wbb_team_schedule',
 'espn_wbb_team_stats',
 'espn_wbb_team_transactions',
 'espn_wbb_teams',
 'espn_wbb_teams_core',
 'espn_wbb_teams_site',
 'espn_wbb_tournaments',
 'espn_wbb_transactions',
 'espn_wbb_venue',
 'espn_wbb_venues',
 'espn_wnba_award',
 'espn_wnba_awards',
 'espn_wnba_calendar',
 'espn_wnba_calendar_offseason',
 'espn_wnba_calendar_ondays',
 'espn_wnba_calendar_postseason',
 'espn_wnba_calendar_regular_season',
 'espn_wnba_coach',
 'espn_wnba_coach_record',
 'espn_wnba_coach_season',
 'espn_wnba_coaches',
 'espn_wnba_conferences',
 'espn_wnba_draft',
 'espn_wnba_franchise',
 'espn_wnba_franchises',
 'espn_wnba_game',
 'espn_wnba_game_broadcasts',
 'espn_wnba_game_competition',
 'espn_wnba_game_leaders',
 'espn_wnba_game_odds',
 'espn_wnba_game_official_detail',
 'espn_wnba_game_officials',
 'espn_wnba_game_play',
 'espn_wnba_game_play_personnel',
 'espn_wnba_game_plays',
 'espn_wnba_game_powerindex',
 'espn_wnba_game_predictor',
 'espn_wnba_game_probabilities',
 'espn_wnba_game_propbets',
 'espn_wnba_game_rosters',
 'espn_wnba_game_scoringplays',
 'espn_wnba_game_situation',
 'espn_wnba_game_status',
 'espn_wnba_game_team',
 'espn_wnba_game_team_leaders',
 'espn_wnba_game_team_linescores',
 'espn_wnba_game_team_record',
 'espn_wnba_game_team_roster',
 'espn_wnba_game_team_statistics',
 'espn_wnba_game_teams',
 'espn_wnba_games',
 'espn_wnba_injuries',
 'espn_wnba_leaders',
 'espn_wnba_leaders_core',
 'espn_wnba_league_notes',
 'espn_wnba_league_root',
 'espn_wnba_news',
 'espn_wnba_pbp',
 'espn_wnba_player_awards',
 'espn_wnba_player_bio',
 'espn_wnba_player_career_stats',
 'espn_wnba_player_contracts',
 'espn_wnba_player_core',
 'espn_wnba_player_eventlog',
 'espn_wnba_player_gamelog',
 'espn_wnba_player_info',
 'espn_wnba_player_injuries',
 'espn_wnba_player_news',
 'espn_wnba_player_notes',
 ...]

Polars vs pandas

Every loader returns a polars DataFrame by default. Pass return_as_pandas=True to get a pandas frame instead — useful when downstream code (sklearn, statsmodels) expects pandas.

teams_pl = sdv.wnba.espn_wnba_teams()
type(teams_pl).__name__, teams_pl.shape

('DataFrame', (15, 14))

teams_pd = sdv.wnba.espn_wnba_teams(return_as_pandas=True)
type(teams_pd).__name__, teams_pd.shape

('DataFrame', (15, 14))

The `download()` retry layer

All HTTP traffic goes through sportsdataverse.dl_utils.download() — a thin wrapper around requests with an exponential-style retry loop and ESPN-404 awareness. You can call it directly when you need a one-off endpoint that doesn't have a wrapper yet.

from sportsdataverse.dl_utils import download

url = 'https://site.api.espn.com/apis/site/v2/sports/basketball/wnba/teams'
resp = download(url, num_retries=3)
resp.status_code, len(resp.content)

(200, 56312)

Pipeline example: schedule -> first 5 games

Fetch a schedule, then pull the first PBP frame to confirm the round-trip works end-to-end.

schedule = sdv.wnba.espn_wnba_schedule(dates=20240601)
schedule.select(['id', 'home_display_name', 'away_display_name', 'status_type_completed']).head()

shape: (1, 4)
┌───────────┬───────────────────┬───────────────────┬───────────────────────┐
│ id        ┆ home_display_name ┆ away_display_name ┆ status_type_completed │
│ ---       ┆ ---               ┆ ---               ┆ ---                   │
│ str       ┆ str               ┆ str               ┆ bool                  │
╞═══════════╪═══════════════════╪═══════════════════╪═══════════════════════╡
│ 401620261 ┆ Indiana Fever     ┆ Chicago Sky       ┆ true                  │
└───────────┴───────────────────┴───────────────────┴───────────────────────┘

Cross-references

R companion (umbrella): https://www.sportsdataverse.org
Polars docs: https://docs.pola.rs
pandas docs: https://pandas.pydata.org/docs/

Where to go next

02_cfb_intro.ipynb — college football
03_nfl_intro.ipynb — NFL (nflverse parity surface)
04_nba_intro.ipynb — NBA
05_wbb_intro.ipynb — NCAA women's basketball
06_mbb_intro.ipynb — NCAA men's basketball
07_nhl_intro.ipynb — NHL (native api-web + ESPN)
08_wnba_intro.ipynb — WNBA
09_mlb_intro.ipynb — MLB (Stats API, Statcast, ESPN)
10_pwhl_intro.ipynb — PWHL

Each notebook links back to its rendered API page under docs/docs/<sport>/index.md.

Setup​

Package layout​

Polars vs pandas​

The download() retry layer​

Pipeline example: schedule -> first 5 games​

Cross-references​

Where to go next​