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.3 ──
#>  Data updated: 2022-11-24 08:46:40 UTC
#> # A tibble: 64 × 55
#>    matchup    match…¹ season type  slug  game_id game_…² game_…³ atten…⁴ home_…⁵
#>    <chr>      <chr>    <int> <chr> <chr> <chr>   <chr>   <chr>     <int> <chr>  
#>  1 Mississip… MSST @…   2022 regu… regu… 401403… s:20~l… 2022-1…       0 Rebels 
#>  2 Ball Stat… BALL @…   2022 regu… regu… 401416… s:20~l… 2022-1…   14021 RedHaw…
#>  3 Bowling G… BGSU @…   2022 regu… regu… 401416… s:20~l… 2022-1…   11693 Bobcats
#>  4 Tulane Gr… TULN @…   2022 regu… regu… 401415… s:20~l… 2022-1…       0 Bearca…
#>  5 Baylor Be… BAY @ …   2022 regu… regu… 401404… s:20~l… 2022-1…       0 Longho…
#>  6 Utah Stat… USU @ …   2022 regu… regu… 401415… s:20~l… 2022-1…       0 Broncos
#>  7 Central M… CMU @ …   2022 regu… regu… 401416… s:20~l… 2022-1…       0 Eagles 
#>  8 Toledo Ro… TOL @ …   2022 regu… regu… 401416… s:20~l… 2022-1…       0 Broncos
#>  9 Arizona S… ASU @ …   2022 regu… regu… 401404… s:20~l… 2022-1…       0 Wildca…
#> 10 NC State … NCST @…   2022 regu… regu… 401411… s:20~l… 2022-1…       0 Tar He…
#> # … with 54 more rows, 45 more variables: 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>,
#> #   away_score <int>, away_win <int>, away_record <chr>, notes <lgl>, …
# }

# \donttest{
  try(espn_cfb_schedule(2021, week = 8))
#> ── Schedule Data from ESPN ─────────────────────────────────── cfbfastR 1.9.3 ──
#>  Data updated: 2022-11-24 08:46:41 UTC
#> # A tibble: 54 × 55
#>    matchup    match…¹ season type  slug  game_id game_…² game_…³ atten…⁴ home_…⁵
#>    <chr>      <chr>    <int> <chr> <chr> <chr>   <chr>   <chr>     <int> <chr>  
#>  1 Coastal C… CCU @ …   2021 regu… regu… 401309… s:20~l… 2021-1…   31061 Mounta…
#>  2 Tulane Gr… TULN @…   2021 regu… regu… 401301… s:20~l… 2021-1…   22843 Mustan…
#>  3 Florida A… FAU @ …   2021 regu… regu… 401282… s:20~l… 2021-1…   13017 49ers  
#>  4 Louisiana… UL @ A…   2021 regu… regu… 401309… s:20~l… 2021-1…    7138 Red Wo…
#>  5 San José … SJSU @…   2021 regu… regu… 401310… s:20~l… 2021-1…   19318 Rebels 
#>  6 Middle Te… MTSU @…   2021 regu… regu… 401282… s:20~l… 2021-1…   10698 Huskies
#>  7 Memphis T… MEM @ …   2021 regu… regu… 401301… s:20~l… 2021-1…   39328 Knights
#>  8 Colorado … CSU @ …   2021 regu… regu… 401310… s:20~l… 2021-1…   21423 Aggies 
#>  9 Washingto… WASH @…   2021 regu… regu… 401309… s:20~l… 2021-1…   30880 Wildca…
#> 10 Cincinnat… CIN @ …   2021 regu… regu… 401301… s:20~l… 2021-1…   32004 Midshi…
#> # … with 44 more rows, 45 more variables: 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>,
#> #   away_score <int>, away_win <int>, away_record <chr>, notes <lgl>, …
# }