Skip to contents

ESPN Scoreboard

Get live scoreboard data from ESPN or look up the college football schedule for a given season

ESPN Schedule

Usage

espn_cfb_scoreboard(date = NULL)

espn_cfb_schedule(
  year = NULL,
  week = NULL,
  season_type = NULL,
  groups = NULL,
  limit = 500
)

Arguments

date

(Integer required - YYYYMMDD): Date to pull

year

(int): Used to define different seasons. 2002 is the earliest available season.

week

(int): Week of the schedule.

season_type

(string): "regular", "postseason", "off-season", or "both".

groups

(string): Used to define different divisions. FBS or FCS.

limit

(int): number of records to return, default: 500.

Value

espn_cfb_scoreboard() & espn_cfb_schedule() - A data frame with 33 or 54 variables depending on if there are completed games: shared variables

matchup: character.

Long matchup description with full team names (Utah Utes at UCLA Bruins).

matchup_short: character.

Short matchup description with team abbreviations (UTAH @ UCLA).

season: integer.

Season of the game.

type: character.

Season type of the game in CFBD format.

slug: character.

Season type of the game in ESPN format.

game_id: character.

Referencing game ID.

game_uid: character.
game_date: character.

Game date.

attendance: integer.

Reported attendance at the game.

home_team_name: character.

Home team mascot name (Sun Devils).

home_team_logo: character.

Home team logo url.

home_team_abb: character.

Home team abbreviation (ASU).

home_team_id: character.

Home team ID.

home_team_location: character.

Home team name (Arizona State).

home_team_full: character.

Home team full name (Arizona State Sun Devils).

home_team_color: character.

Home team color.

home_score: integer.

Home team points.

home_win: integer.

1 if home team won, 0 if home team lost, NA if game is unfinished

home_record: character

Home team record.

away_team_name: character.

Away team mascot name (Sun Devils).

away_team_logo: character.

Away team logo url.

away_team_abb: character.

Away team abbreviation (ASU).

away_team_id: character.

Away team ID.

away_team_location: character.

Away team name (Arizona State).

away_team_full: character.

Away team full name (Arizona State Sun Devils).

away_team_color: character.

Away team color.

away_score: integer.

Away team points.

away_win: integer.

1 if away team won, 0 if home team lost, NA if game is unfinished

away_record: character

Away team record.

status_name: character.

Status of the game

start_date: character.

Game date.

Unique variables when there are completed games

broadcast_market: character.

Broadcast market (typically "national" or NA)

broadcast_name: character.

Broadcast channel i.e. ESPN, ABC, FOX

passing_leader_yards: numeric.

Passing yards of game's passing leader

passing_leader_stat: character.

Stat line of game's passing leader

passing_leader_name: character.

Name of game's passing leader

passing_leader_shortname: character.

First initial and last name of game's passing leader

passing_leader_headshot: character.

Headshot url of game's passing leader

passing_leader_team_id: character.

Team ID of game's passing leader

passing_leader_pos: character.

Position of game's passing leader

rushing_leader_yards: numeric.

Passing yards of game's rushing leader

rushing_leader_stat: character.

Stat line of game's rushing leader

rushing_leader_name: character.

Name of game's rushing leader

rushing_leader_shortname: character.

First initial and last name of game's rushing leader

rushing_leader_headshot: character.

Headshot url of game's rushing leader

rushing_leader_team_id: character.

Team ID of game's rushing leader

rushing_leader_pos: character.

Position of game's rushing leader

receiving_leader_yards: numeric.

Passing yards of game's receiving leader

receiving_leader_stat: character.

Stat line of game's receiving leader

receiving_leader_name: character.

Name of game's receiving leader

receiving_leader_shortname: character.

First initial and last name of game's receiving leader

receiving_leader_headshot: character.

Headshot url of game's receiving leader

receiving_leader_team_id: character.

Team ID of game's receiving leader

receiving_leader_pos: character.

Position of game's receiving leader

Examples

# \donttest{
  try(espn_cfb_scoreboard())
#> ── Live Scoreboard Data from ESPN ──────────────────────────── cfbfastR 1.9.4 ──
#>  Data updated: 2023-04-04 07:43:45 UTC
#> # A tibble: 94 × 34
#>    matchup          matchup_short season type  slug  game_id game_uid game_date 
#>    <chr>            <chr>          <int> <chr> <chr> <chr>   <chr>    <date>    
#>  1 Hawai'i Rainbow… HAW @ VAN       2023 regu… regu… 401520… s:20~l:… 2023-08-26
#>  2 San José State … SJSU @ USC      2023 regu… regu… 401523… s:20~l:… 2023-08-26
#>  3 Navy Midshipmen… NAVY @ ND       2023 regu… regu… 401525… s:20~l:… 2023-08-26
#>  4 UMass Minutemen… MASS @ NMSU     2023 regu… regu… 401525… s:20~l:… 2023-08-26
#>  5 Ohio Bobcats at… OHIO @ SDSU     2023 regu… regu… 401532… s:20~l:… 2023-08-26
#>  6 UTEP Miners at … UTEP @ JVST     2023 regu… regu… 401520… s:20~l:… 2023-08-26
#>  7 Florida Interna… FIU @ LT        2023 regu… regu… 401520… s:20~l:… 2023-08-26
#>  8 Nebraska Cornhu… NEB @ MINN      2023 regu… regu… 401520… s:20~l:… 2023-08-31
#>  9 Southern Utah T… SUU @ ASU       2023 regu… regu… 401523… s:20~l:… 2023-08-31
#> 10 Elon Phoenix at… ELON @ WAKE     2023 regu… regu… 401525… s:20~l:… 2023-08-31
#> # ℹ 84 more rows
#> # ℹ 26 more variables: attendance <int>, home_team_name <chr>,
#> #   home_team_logo <chr>, home_team_abb <chr>, home_team_id <chr>,
#> #   home_team_location <chr>, home_team_full <chr>, home_team_color <chr>,
#> #   home_score <int>, home_win <int>, home_record <lgl>, away_team_name <chr>,
#> #   away_team_logo <chr>, away_team_abb <chr>, away_team_id <chr>,
#> #   away_team_location <chr>, away_team_full <chr>, away_team_color <chr>, …
# }

# \donttest{
  try(espn_cfb_schedule(2021, week = 8))
#> ── Schedule Data from ESPN ─────────────────────────────────── cfbfastR 1.9.4 ──
#>  Data updated: 2023-04-04 07:43:45 UTC
#> # A tibble: 54 × 56
#>    matchup          matchup_short season type  slug  game_id game_uid game_date 
#>    <chr>            <chr>          <int> <chr> <chr> <chr>   <chr>    <date>    
#>  1 Coastal Carolin… CCU @ APP       2021 regu… regu… 401309… s:20~l:… 2021-10-20
#>  2 Tulane Green Wa… TULN @ SMU      2021 regu… regu… 401301… s:20~l:… 2021-10-21
#>  3 Florida Atlanti… FAU @ CLT       2021 regu… regu… 401282… s:20~l:… 2021-10-21
#>  4 Louisiana Ragin… UL @ ARST       2021 regu… regu… 401309… s:20~l:… 2021-10-21
#>  5 San José State … SJSU @ UNLV     2021 regu… regu… 401310… s:20~l:… 2021-10-21
#>  6 Middle Tennesse… MTSU @ CONN     2021 regu… regu… 401282… s:20~l:… 2021-10-22
#>  7 Memphis Tigers … MEM @ UCF       2021 regu… regu… 401301… s:20~l:… 2021-10-22
#>  8 Colorado State … CSU @ USU       2021 regu… regu… 401310… s:20~l:… 2021-10-22
#>  9 Washington Husk… WASH @ ARIZ     2021 regu… regu… 401309… s:20~l:… 2021-10-22
#> 10 Cincinnati Bear… CIN @ NAVY      2021 regu… regu… 401301… s:20~l:… 2021-10-23
#> # ℹ 44 more rows
#> # ℹ 48 more variables: attendance <int>, home_team_name <chr>,
#> #   home_team_logo <chr>, home_team_abb <chr>, home_team_id <chr>,
#> #   home_team_location <chr>, home_team_full <chr>, home_team_color <chr>,
#> #   home_score <int>, home_win <int>, home_record <chr>, away_team_name <chr>,
#> #   away_team_logo <chr>, away_team_abb <chr>, away_team_id <chr>,
#> #   away_team_location <chr>, away_team_full <chr>, away_team_color <chr>, …
# }