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: 2023-03-23 02:31:05 UTC
#> # A tibble: 94 × 33
#>    matchup    match…¹ season type  slug  game_id game_…² game_…³ atten…⁴ home_…⁵
#>    <chr>      <chr>    <int> <chr> <chr> <chr>   <chr>   <chr>     <int> <chr>  
#>  1 Hawai'i R… HAW @ …   2023 regu… regu… 401520… s:20~l… 2023-0…       0 Commod…
#>  2 San José … SJSU @…   2023 regu… regu… 401523… s:20~l… 2023-0…       0 Trojans
#>  3 Navy Mids… NAVY @…   2023 regu… regu… 401525… s:20~l… 2023-0…       0 Fighti…
#>  4 UMass Min… MASS @…   2023 regu… regu… 401525… s:20~l… 2023-0…       0 Aggies 
#>  5 Ohio Bobc… OHIO @…   2023 regu… regu… 401532… s:20~l… 2023-0…       0 Aztecs 
#>  6 UTEP Mine… UTEP @…   2023 regu… regu… 401520… s:20~l… 2023-0…       0 Gameco…
#>  7 Florida I… FIU @ …   2023 regu… regu… 401520… s:20~l… 2023-0…       0 Bulldo…
#>  8 Nebraska … NEB @ …   2023 regu… regu… 401520… s:20~l… 2023-0…       0 Golden…
#>  9 Southern … SUU @ …   2023 regu… regu… 401523… s:20~l… 2023-0…       0 Sun De…
#> 10 Elon Phoe… ELON @…   2023 regu… regu… 401525… s:20~l… 2023-0…       0 Demon …
#> # … with 84 more rows, 23 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 <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>,
#> #   away_score <int>, away_win <int>, away_record <lgl>, status_name <chr>, …
# }

# \donttest{
  try(espn_cfb_schedule(2021, week = 8))
#> ── Schedule Data from ESPN ─────────────────────────────────── cfbfastR 1.9.3 ──
#>  Data updated: 2023-03-23 02:31:06 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>, …
# }