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.0 ──
#>  Data updated: 2022-06-15 19:51:22 UTC
#> # A tibble: 94 × 31
#>    matchup           matchup_short season type  slug  game_id game_uid game_date
#>    <chr>             <chr>          <int> <chr> <chr> <chr>   <chr>    <chr>    
#>  1 Nevada Wolf Pack… NEV @ NMSU      2022 regu… regu… 401409… s:20~l:… 2022-08-…
#>  2 Austin Peay Gove… APSU @ WKU      2022 regu… regu… 401426… s:20~l:… 2022-08-…
#>  3 Northwestern Wil… NU @ NEB        2022 regu… regu… 401405… s:20~l:… 2022-08-…
#>  4 Idaho State Beng… IDST @ UNLV     2022 regu… regu… 401413… s:20~l:… 2022-08-…
#>  5 UConn Huskies at… CONN @ USU      2022 regu… regu… 401404… s:20~l:… 2022-08-…
#>  6 Wyoming Cowboys … WYO @ ILL       2022 regu… regu… 401405… s:20~l:… 2022-08-…
#>  7 Duquesne Dukes a… DUQ @ FSU       2022 regu… regu… 401411… s:20~l:… 2022-08-…
#>  8 Charlotte 49ers … CLT @ FAU       2022 regu… regu… 401426… s:20~l:… 2022-08-…
#>  9 Florida A&M Ratt… FAMU @ UNC      2022 regu… regu… 401411… s:20~l:… 2022-08-…
#> 10 North Texas Mean… UNT @ UTEP      2022 regu… regu… 401426… s:20~l:… 2022-08-…
#> # … with 84 more rows, and 23 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>, away_score <int>, away_win <int>, …
# }

# \donttest{
  try(espn_cfb_schedule(2021, week = 8))
#> ── Schedule Data from ESPN ─────────────────────────────────── cfbfastR 1.9.0 ──
#>  Data updated: 2022-06-15 19:51:23 UTC
#> # A tibble: 54 × 55
#>    matchup           matchup_short season type  slug  game_id game_uid game_date
#>    <chr>             <chr>          <int> <chr> <chr> <chr>   <chr>    <chr>    
#>  1 Coastal Carolina… CCU @ APP       2021 regu… regu… 401309… s:20~l:… 2021-10-…
#>  2 Tulane Green Wav… TULN @ SMU      2021 regu… regu… 401301… s:20~l:… 2021-10-…
#>  3 Florida Atlantic… FAU @ CLT       2021 regu… regu… 401282… s:20~l:… 2021-10-…
#>  4 Louisiana Ragin'… UL @ ARST       2021 regu… regu… 401309… s:20~l:… 2021-10-…
#>  5 San José State S… SJSU @ UNLV     2021 regu… regu… 401310… s:20~l:… 2021-10-…
#>  6 Middle Tennessee… MTSU @ CONN     2021 regu… regu… 401282… s:20~l:… 2021-10-…
#>  7 Memphis Tigers a… MEM @ UCF       2021 regu… regu… 401301… s:20~l:… 2021-10-…
#>  8 Colorado State R… CSU @ USU       2021 regu… regu… 401310… s:20~l:… 2021-10-…
#>  9 Washington Huski… WASH @ ARIZ     2021 regu… regu… 401309… s:20~l:… 2021-10-…
#> 10 Cincinnati Bearc… CIN @ NAVY      2021 regu… regu… 401301… s:20~l:… 2021-10-…
#> # … with 44 more rows, and 47 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>, away_score <int>, away_win <int>, …
# }