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
: characterHome 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
: characterAway 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>, …
# }