Get results information from games. — cfbd_game

Get results information from games.

Usage

cfbd_game_info(
  year,
  week = NULL,
  season_type = "regular",
  team = NULL,
  home_team = NULL,
  away_team = NULL,
  conference = NULL,
  division = "fbs",
  game_id = NULL,
  quarter_scores = FALSE
)

Arguments

year: (Integer required): Year, 4 digit format(YYYY)
week: (Integer optional): Week - values from 1-15, 1-14 for seasons pre-playoff (i.e. 2013 or earlier)
season_type: (String default regular): Select Season Type: regular, postseason, or both
team: (String optional): D-I Team
home_team: (String optional): Home D-I Team
away_team: (String optional): Away D-I Team
conference: (String optional): Conference abbreviation - Select a valid FBS conference Conference abbreviations P5: ACC, B12, B1G, SEC, PAC Conference abbreviations G5 and FBS Independents: CUSA, MAC, MWC, Ind, SBC, AAC
division: (String optional): Division abbreviation - Select a valid division: fbs/fcs/ii/iii
game_id: (Integer optional): Game ID filter for querying a single game
quarter_scores: (Logical default FALSE): This is a parameter to return the list columns that give the score at each quarter: home_line_scores and away_line_scores. I have defaulted the parameter to false so that you will not have to go to the trouble of dropping it.

Value

cfbd_game_info() - A data frame with 22 variables:

game_id: integer.: Referencing game id.
season: integer.: Season of the game.
week: integer.: Game week.
season_type: character.: Season type of the game.
start_date: character.: Game date.
start_time_tbd: logical.: TRUE/FALSE flag for if the game's start time is to be determined.
neutral_site: logical.: TRUE/FALSE flag for the game taking place at a neutral site.
conference_game: logical.: TRUE/FALSE flag for this game qualifying as a conference game.
attendance: integer.: Reported attendance at the game.
venue_id: integer.: Referencing venue id.
venue: character.: Venue name.
home_id: integer.: Home team referencing id.
home_team: character.: Home team name.
home_conference: character.: Home team conference.
home_division: character.: Home team division.
home_points: integer.: Home team points.
home_post_win_prob: character.: Home team post-game win probability.
home_pregame_elo: character.: Home team pre-game ELO rating.
home_postgame_elo: character.: Home team post-game ELO rating.
away_id: integer.: Away team referencing id.
away_team: character.: Away team name.
away_conference: character.: Away team conference.
away_division: character.: Away team division.
away_points: integer.: Away team points.
away_post_win_prob: character.: Away team post-game win probability.
away_pregame_elo: character.: Away team pre-game ELO rating.
away_postgame_elo: character.: Away team post-game ELO rating.
excitement_index: character.: Game excitement index.
highlights: character.: Game highlight urls.
notes: character.: Game notes.

Examples

# \donttest{
  try(cfbd_game_info(2018, week = 7, conference = "Ind"))
#> ── Game information from CollegeFootballData.com ───────────── cfbfastR 1.9.5 ──
#> ℹ Data updated: 2024-02-01 16:00:34 UTC
#> # A tibble: 5 × 31
#>     game_id season  week season_type start_date         start_time_tbd completed
#>       <int>  <int> <int> <chr>       <chr>              <lgl>          <lgl>    
#> 1 401013452   2018     7 regular     2018-10-13T18:00:… NA             TRUE     
#> 2 401013148   2018     7 regular     2018-10-13T18:30:… NA             TRUE     
#> 3 401013370   2018     7 regular     2018-10-13T19:30:… NA             TRUE     
#> 4 401013442   2018     7 regular     2018-10-13T21:00:… NA             TRUE     
#> 5 401016408   2018     7 regular     2018-10-14T02:15:… NA             TRUE     
#> # ℹ 24 more variables: neutral_site <lgl>, conference_game <lgl>,
#> #   attendance <int>, venue_id <int>, venue <chr>, home_id <int>,
#> #   home_team <chr>, home_conference <chr>, home_division <chr>,
#> #   home_points <int>, home_post_win_prob <chr>, home_pregame_elo <int>,
#> #   home_postgame_elo <int>, away_id <int>, away_team <chr>,
#> #   away_conference <chr>, away_division <chr>, away_points <int>,
#> #   away_post_win_prob <chr>, away_pregame_elo <int>, …
# }