Skip to contents

Get ESPN MLB schedule for a specific year

Usage

espn_mlb_scoreboard(season)

Arguments

season

Either numeric or character (YYYYMMDD)

Value

Returns a tibble with scoreboard data

col_nametypesdescription
matchupcharacterFull game matchup name.
matchup_shortcharacterShort matchup name.
seasonintegerSeason (4-digit year).
season_typeintegerESPN season type (1=pre, 2=regular, 3=postseason, 4=off-season).
season_slugcharacterSeason slug.
game_idintegerUnique ESPN game/event identifier.
game_uidcharacterESPN game UID.
game_dateDateGame date (YYYY-MM-DD).
attendanceintegerGame attendance.
play_by_play_availablelogicalTRUE if play-by-play is available.
was_suspendedlogicalWas suspended.
noteslogicalNotes.
status_namecharacterGame status (e.g. 'STATUS_FINAL').
broadcast_marketcharacterBroadcast market ('national'/'home'/'away').
broadcast_namecharacterBroadcast network name.
batting_leader_valuenumericTeam batting: batting leader value.
batting_leader_statcharacterTeam batting: batting leader stat.
batting_leader_namecharacterTeam batting: batting leader name.
batting_leader_shortnamecharacterTeam batting: batting leader shortname.
batting_leader_headshotcharacterTeam batting: batting leader headshot.
batting_leader_team_idcharacterTeam batting: batting leader team id.
batting_leader_poscharacterTeam batting: batting leader pos.
home_run_leader_valuelogicalHome run leader value.
home_run_leader_statlogicalHome run leader stat.
home_run_leader_namelogicalHome run leader name.
home_run_leader_shortnamelogicalHome run leader shortname.
home_run_leader_headshotlogicalHome run leader headshot.
home_run_leader_team_idlogicalHome run leader team id.
home_run_leader_poslogicalHome run leader pos.
rbi_leader_valuelogicalRbi leader value.
rbi_leader_statlogicalRbi leader stat.
rbi_leader_namelogicalRbi leader name.
rbi_leader_shortnamelogicalRbi leader shortname.
rbi_leader_headshotlogicalRbi leader headshot.
rbi_leader_team_idlogicalRbi leader team id.
rbi_leader_poslogicalRbi leader pos.
start_datecharacterStart date.
broadcastcharacterBroadcast network.
highlightslogicalHighlights.
game_date_timePOSIXctGame start date/time (US/Eastern).
home_team_namecharacterHome team name.
home_team_logocharacterHome team logo.
home_team_abbcharacterHome team abb.
home_team_idintegerHome team id.
home_team_locationcharacterHome team location.
home_team_full_namecharacterHome team full name.
home_team_colorcharacterHome team color.
home_scoreintegerHome team run total after the play.
home_winintegerHome win.
home_recordcharacterHome record.
away_team_namecharacterAway team name.
away_team_logocharacterAway team logo.
away_team_abbcharacterAway team abb.
away_team_idintegerAway team id.
away_team_locationcharacterAway team location.
away_team_full_namecharacterAway team full name.
away_team_colorcharacterAway team color.
away_scoreintegerAway team run total after the play.
away_winintegerAway win.
away_recordcharacterAway record.

See also

Other ESPN MLB Functions: espn_mlb, espn_mlb_athletes_index(), espn_mlb_award(), espn_mlb_betting(), espn_mlb_calendar(), espn_mlb_coach(), espn_mlb_coach_record(), espn_mlb_coach_season(), espn_mlb_coaches(), espn_mlb_conferences(), espn_mlb_draft(), espn_mlb_draft_athlete_detail(), espn_mlb_draft_athletes(), espn_mlb_draft_pick(), espn_mlb_draft_rounds(), espn_mlb_draft_status(), espn_mlb_franchise(), espn_mlb_franchises(), espn_mlb_freeagents(), espn_mlb_futures(), espn_mlb_game_all(), espn_mlb_game_broadcasts(), espn_mlb_game_endpoints, espn_mlb_game_info(), 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_player_box(), espn_mlb_game_powerindex(), espn_mlb_game_predictor(), espn_mlb_game_probabilities(), espn_mlb_game_probables(), espn_mlb_game_propbets(), espn_mlb_game_rosters(), espn_mlb_game_situation(), espn_mlb_game_team_leaders(), espn_mlb_game_team_linescores(), espn_mlb_game_team_records(), espn_mlb_game_team_roster(), espn_mlb_game_team_roster_entry(), espn_mlb_game_team_score(), espn_mlb_game_team_statistics(), espn_mlb_injuries(), espn_mlb_leaders(), espn_mlb_news(), espn_mlb_pbp(), espn_mlb_player_awards(), espn_mlb_player_box(), espn_mlb_player_career_stats(), espn_mlb_player_contract(), espn_mlb_player_contracts(), espn_mlb_player_endpoints, espn_mlb_player_eventlog(), espn_mlb_player_eventlog_v2(), espn_mlb_player_gamelog(), espn_mlb_player_info(), espn_mlb_player_overview(), espn_mlb_player_seasons(), espn_mlb_player_splits(), espn_mlb_player_statisticslog(), espn_mlb_player_stats(), espn_mlb_player_stats_v3(), espn_mlb_position(), espn_mlb_positions(), espn_mlb_powerindex(), espn_mlb_season_awards(), espn_mlb_season_draft(), 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_leaders(), espn_mlb_season_ranking(), espn_mlb_season_rankings(), espn_mlb_season_type(), espn_mlb_season_types(), espn_mlb_season_week(), espn_mlb_season_weeks(), espn_mlb_seasons(), espn_mlb_standings(), espn_mlb_team(), espn_mlb_team_box(), espn_mlb_team_current_roster(), espn_mlb_team_depthchart(), espn_mlb_team_endpoints, espn_mlb_team_injuries(), espn_mlb_team_leaders(), espn_mlb_team_news(), espn_mlb_team_odds_records(), espn_mlb_team_record(), espn_mlb_team_record_detail(), espn_mlb_team_roster(), espn_mlb_team_schedule(), espn_mlb_team_season_profile(), espn_mlb_team_season_roster(), espn_mlb_team_season_statistics(), espn_mlb_team_stats(), espn_mlb_teams(), espn_mlb_tournament(), espn_mlb_tournament_season(), espn_mlb_tournament_seasons(), espn_mlb_tournaments(), espn_mlb_transactions(), espn_mlb_venues(), espn_mlb_week_ranking(), espn_mlb_week_rankings(), espn_mlb_wp()

Examples


# Get schedule from date 2022-11-17 (returns 1000 results, max allowable.)
# \donttest{
try(espn_mlb_scoreboard(season = 20230423))
#> ── ESPN MLB Scoreboard Information from ESPN.com ──── baseballr 2.0.0 ──
#>  Data updated: 2026-06-08 11:07:55 UTC
#> # A tibble: 15 × 60
#>    matchup matchup_short season season_type season_slug game_id game_uid
#>    <chr>   <chr>          <int>       <int> <chr>         <int> <chr>   
#>  1 Colora… COL @ PHI       2023           2 regular-se…  4.01e8 s:1~l:1…
#>  2 Detroi… DET @ BAL       2023           2 regular-se…  4.01e8 s:1~l:1…
#>  3 Housto… HOU @ ATL       2023           2 regular-se…  4.01e8 s:1~l:1…
#>  4 Toront… TOR @ NYY       2023           2 regular-se…  4.01e8 s:1~l:1…
#>  5 Cincin… CIN @ PIT       2023           2 regular-se…  4.01e8 s:1~l:1…
#>  6 Chicag… CHW @ TB        2023           2 regular-se…  4.01e8 s:1~l:1…
#>  7 Miami … MIA @ CLE       2023           2 regular-se…  4.01e8 s:1~l:1…
#>  8 Boston… BOS @ MIL       2023           2 regular-se…  4.01e8 s:1~l:1…
#>  9 Washin… WSH @ MIN       2023           2 regular-se…  4.01e8 s:1~l:1…
#> 10 Los An… LAD @ CHC       2023           2 regular-se…  4.01e8 s:1~l:1…
#> 11 Oaklan… OAK @ TEX       2023           2 regular-se…  4.01e8 s:1~l:1…
#> 12 Kansas… KC @ LAA        2023           2 regular-se…  4.01e8 s:1~l:1…
#> 13 San Di… SD @ ARI        2023           2 regular-se…  4.01e8 s:1~l:1…
#> 14 St. Lo… STL @ SEA       2023           2 regular-se…  4.01e8 s:1~l:1…
#> 15 New Yo… NYM @ SF        2023           2 regular-se…  4.01e8 s:1~l:1…
#> # ℹ 53 more variables: game_date <date>, attendance <int>,
#> #   play_by_play_available <lgl>, was_suspended <lgl>, notes <lgl>,
#> #   status_name <chr>, broadcast_market <chr>, broadcast_name <chr>,
#> #   batting_leader_value <dbl>, batting_leader_stat <chr>,
#> #   batting_leader_name <chr>, batting_leader_shortname <chr>,
#> #   batting_leader_headshot <chr>, batting_leader_team_id <chr>,
#> #   batting_leader_pos <chr>, home_run_leader_value <lgl>, …
# }