Package index • cfbfastR

Function family overviews

One-page summaries of the cfbd_* and espn_cfb_* function families.

cfbd_api_key api_key: CFBD API Key Endpoint Overview
cfbd_betting betting lines spreads: CFBD Betting Endpoint Overview
cfbd_coaches(): CFBD Coaches Endpoint Overview
cfbd_conferences(): CFBD Conferences Endpoint Overview
cfbd_drives(): CFBD Drives Endpoint Overview
cfbd_pbp play_by_play: CFBD Play-by-Play Endpoint Overview
cfbd_pbp_v2 pbp_v2 modular_epa modular_wpa: CFBD Play-by-Play (v2 Modular EPA/WPA Pipeline) Overview
cfbd_venues(): CFBD Venues Endpoint Overview
espn_cfb_catalog catalog awards franchises positions clear_cache: ESPN College Football Catalog Endpoint Overview
espn_cfb_game game plays leaders: ESPN College Football Game Endpoint Overview
espn_cfb_player(): ESPN College Football Player Endpoint Overview
espn_cfb_season season seasons standings rankings: ESPN College Football Season Endpoint Overview
espn_cfb_team(): ESPN College Football Team Endpoint Overview

cfbfastR Data

Full Season Loaders

Functions exported by cfbfastR which load full seasons of cfbfastR data

load_cfb_pbp(): Load cleaned play-by-play from the data repo
load_cfb_rosters(): Load College Football Rosters
load_cfb_schedules(): Load CFB Game/Schedule Data from data repo
load_cfb_teams(): Load CFB team info from the data repo

Update or Create Database

Functions exported by cfbfastR which update and create a database of cfbfastR play-by-play data

update_cfb_db(): Update or create a cfbfastR play-by-play database

Play-by-Play Data

Functions exported by cfbfastR which return Expected Points and Win Probability model outputs.

cfbd_pbp_data(): Get college football play by play data with cfbfastR expected points/win probability added
cfbd_pbp_data_v2(): Get college football play-by-play data — modular EPA/WPA pipeline (v2)

College Football Data API

API Key Helpers

Functions for registering and inspecting your CollegeFootballData.com API key.

cfbd_key() has_cfbd_key() cfbd_api_key_info(): CFBD API Key Registration

Games Data

Functions exported by cfbfastR sourced from games endpoint of the CollegeFootballData API

cfbd_games: CFBD Games Endpoint Overview
cfbd_game_box_advanced(): Get game advanced box score information.
cfbd_game_info(): Get results information from games.
cfbd_game_media(): Get game media information (TV, radio, etc).
cfbd_game_player_stats(): Get player statistics by game
cfbd_game_records(): Get team records by year
cfbd_game_team_stats(): Get team statistics by game
cfbd_game_weather(): Get weather from games.
cfbd_calendar(): Get calendar of weeks by season.
cfbd_live_scoreboard(): Get live game scoreboard information from games.

Drives Data

Functions exported by cfbfastR sourced from drives endpoint of the CollegeFootballData API

cfbd_drives(): CFBD Drives Endpoint Overview

Plays Data

Functions exported by cfbfastR sourced from plays endpoint of the CollegeFootballData API

cfbd_play: CFBD Plays Endpoint Overview
cfbd_plays(): Get college football play-by-play data.
cfbd_live_plays(): Get live college football play-by-play data.
cfbd_play_stats_player(): Gets player info associated by play
cfbd_play_stats_types(): Get college football mapping for play stats types
cfbd_play_types(): Get college football mapping for play types

Teams Data

Functions exported by cfbfastR sourced from the teams endpoint of the CollegeFootballData API

cfbd_teams: CFBD Teams Endpoint Overview
cfbd_team_info(): Team info lookup
cfbd_team_matchup(): Get matchup history between two teams.
cfbd_team_matchup_records(): Get matchup history records between two teams.
cfbd_team_roster(): Get team rosters
cfbd_team_talent(): Get composite team talent rankings for all teams in a given year

Players Data

Functions exported by cfbfastR sourced from the players endpoint of the CollegeFootballData API

cfbd_players cfbd_player: CFBD Players Endpoint Overview
cfbd_player_info(): Player information lookup
cfbd_player_returning(): Get player returning production
cfbd_player_usage(): Get player usage metrics

Stats Data

Functions exported by cfbfastR sourced from the stats endpoint of the CollegeFootballData API

cfbd_stats: CFBD Stats Endpoint Overview
cfbd_stats_categories(): Get stats categories
cfbd_stats_game_advanced(): Get game advanced stats
cfbd_stats_game_havoc(): Get game havoc statistics
cfbd_stats_season_advanced(): Get season advanced statistics by team
cfbd_stats_season_player(): Get season statistics by player
cfbd_stats_season_team(): Get season statistics by team

Rankings and Ratings Data

Functions exported by cfbfastR sourced from the rankings and ratings endpoints of the CollegeFootballData API

cfbd_ratings: CFBD Ratings and Rankings Endpoints Overview
cfbd_ratings_elo(): Get Elo historical rating data
cfbd_ratings_fpi(): Get Football Power Index (FPI) historical rating data
cfbd_ratings_sp(): Get SP historical rating data
cfbd_ratings_sp_conference(): Get conference level SP historical rating data
cfbd_ratings_srs(): Get SRS historical rating data
cfbd_rankings(): Get historical Coaches and AP poll data

NFL Draft Data

Functions exported by cfbfastR sourced from the draft endpoints of the CollegeFootballData API

cfbd_draft draft nfl nfl_draft nfl_teams: CFBD NFL Draft Endpoint Overview
cfbd_draft_picks(): Get list of NFL draft picks
cfbd_draft_positions(): Get list of NFL positions
cfbd_draft_teams(): Get list of NFL teams

Betting Data

Functions exported by cfbfastR sourced from lines and betting endpoints of the CollegeFootballData API

cfbd_betting betting lines spreads: CFBD Betting Endpoint Overview
cfbd_betting_ats(): CFBD Against-the-Spread (ATS) Records
cfbd_betting_lines(): CFBD Betting Lines Endpoint Overview

Metrics Data

Functions exported by cfbfastR sourced from the Predicted Points Added (PPA) endpoints of the CollegeFootballData API

cfbd_metrics: CFBD Metrics Endpoint Overview
cfbd_metrics_fg_ep(): Get FG expected points from CFBD API
cfbd_metrics_ppa_games(): Get team game averages for predicted points added (PPA)
cfbd_metrics_ppa_players_games(): Get player game averages for predicted points added (PPA)
cfbd_metrics_ppa_players_season(): Get player season averages for predicted points added (PPA)
cfbd_metrics_ppa_predicted(): Calculate predicted points using down and distance
cfbd_metrics_ppa_teams(): Get team averages for predicted points added (PPA)
cfbd_metrics_wepa_players_kicking(): Get Points Added Above Replacement (PAAR) ratings for kickers
cfbd_metrics_wepa_players_passing(): Get opponent-adjusted player passing statistics for predicted points added (PPA)
cfbd_metrics_wepa_players_rushing(): Get opponent-adjusted player rushing statistics for predicted points added (PPA)
cfbd_metrics_wepa_team_season(): Get opponent-adjusted team season statistics for predicted points added (PPA)
cfbd_metrics_wp(): Get win probability chart data from API
cfbd_metrics_wp_pregame(): Get pre-game win probability data from API

Recruiting Data

Functions exported by cfbfastR sourced from the recruiting endpoints of the CollegeFootballData API

cfbd_recruiting recruiting: CFB Recruiting Endpoint Overview
cfbd_recruiting_player(): Get player recruiting rankings
cfbd_recruiting_position(): Get college football position group recruiting information.
cfbd_recruiting_team(): Get college football recruiting team rankings information.
cfbd_recruiting_transfer_portal(): Get Transfer Portal Data

Schools Data

Functions exported by cfbfastR sourced from venues, conferences, and coaches endpoints of the CollegeFootballData API

cfbd_venues(): CFBD Venues Endpoint Overview
cfbd_conferences(): CFBD Conferences Endpoint Overview
cfbd_coaches(): CFBD Coaches Endpoint Overview

Fox Sports Data

Fox CFB – Read-only Bifrost wrappers

Fox Sports college-football endpoints (play-by-play, boxscore, odds, roster, team stats, game log, standings, and statistical leaders)

fox_cfb_boxscore(): Get Fox Sports college football boxscore
fox_cfb_league_leaders(): Get Fox Sports college football statistical leaders
fox_cfb_odds(): Get Fox Sports college football game odds
fox_cfb_pbp(): Get Fox Sports college football play-by-play
fox_cfb_standings(): Get Fox Sports college football conference standings
fox_cfb_team_gamelog(): Get Fox Sports college football team game log
fox_cfb_team_roster(): Get Fox Sports college football team roster
fox_cfb_team_stats(): Get Fox Sports college football team stat leaders

ESPN Data

ESPN CFB – Game data

Per-game ESPN endpoints (play-by-play, drives, plays, leaders, predictor, situation, odds)

espn_cfb_pbp(): Get ESPN college football PBP data
espn_cfb_pbp_v2(): Get ESPN College Football Play-by-Play (core-v2)
espn_cfb_unnest_plays(): Unnest ESPN CFB drive plays into a flat play-by-play table
espn_cfb_game game plays leaders: ESPN College Football Game Endpoint Overview
espn_cfb_game_broadcasts(): ESPN College Football Game Broadcasts
espn_cfb_game_drive_plays(): ESPN College Football Game Drive Plays
espn_cfb_game_drives(): ESPN College Football Game Drives
espn_cfb_game_leaders(): ESPN College Football Game Leaders
espn_cfb_game_odds(): ESPN College Football Game Odds
espn_cfb_game_pbp(): ESPN College Football Game Plays (Core-v2 Play-by-Play)
espn_cfb_game_play(): ESPN College Football Game Play (Single Play Detail)
espn_cfb_game_player_box(): ESPN College Football Game Player Box Score
espn_cfb_game_player_statistics(): ESPN College Football Game Player Statistics (Single Athlete)
espn_cfb_game_powerindex(): ESPN College Football Game Power Index (Matchup FPI)
espn_cfb_game_predictor(): ESPN College Football Game Predictor (BPI Matchup Predictor)
espn_cfb_game_probabilities(): ESPN College Football Game Win Probabilities
espn_cfb_game_situation(): ESPN College Football Game Situation
espn_cfb_game_status(): ESPN College Football Game Status
espn_cfb_game_team_leaders(): ESPN College Football Game Team Leaders
espn_cfb_game_team_linescores(): ESPN College Football Game Team Linescores
espn_cfb_game_team_records(): ESPN College Football Game Team Records
espn_cfb_game_team_roster(): ESPN College Football Game Team Roster
espn_cfb_game_team_statistics(): ESPN College Football Game Team Statistics
espn_cfb_game_teams(): ESPN College Football Game Teams

ESPN CFB – Schedule, scoreboard & calendar

Calendar, schedule, and scoreboard endpoints

espn_cfb_scoreboard() espn_cfb_schedule(): ESPN Scoreboard
espn_cfb_calendar(): ESPN Calendar

ESPN CFB – Season metadata

Season, week, rankings, standings, and group endpoints

espn_cfb_seasons(): ESPN College Football Seasons Index
espn_cfb_season_info(): ESPN College Football Season Detail
espn_cfb_season_types(): ESPN College Football Season Types
espn_cfb_season_weeks(): ESPN College Football Season Weeks
espn_cfb_week_rankings(): ESPN College Football Weekly Rankings
espn_cfb_rankings(): ESPN College Football Ranking Sources
espn_cfb_standings(): ESPN College Football Standings (Long Format)
espn_cfb_groups(): ESPN College Football Groups & Conferences

ESPN CFB – Team detail

Team-scoped catalog and detail endpoints

espn_cfb_team(): ESPN College Football Team Endpoint Overview
espn_cfb_teams(): ESPN College Football Teams Index
espn_cfb_team_ats(): ESPN College Football Team Against-the-Spread Records
espn_cfb_team_awards(): ESPN College Football Team Awards
espn_cfb_team_coaches(): ESPN College Football Team Coaches
espn_cfb_team_events(): ESPN College Football Team Season Event Log
espn_cfb_team_leaders(): ESPN College Football Team Statistical Leaders
espn_cfb_team_powerindex(): ESPN College Football Single-Team Power Index (Long Format)
espn_cfb_team_ranks(): ESPN College Football Team Poll Rank History
espn_cfb_team_record(): ESPN College Football Team Record (Long Format)
espn_cfb_team_roster(): ESPN College Football Team Roster (Season-Scoped)
espn_cfb_team_schedule(): ESPN College Football Team Schedule
espn_cfb_team_stats(): Get ESPN college football team stats data

ESPN CFB – Athlete coverage

Player, position and recruit endpoints

espn_cfb_player(): ESPN College Football Player Endpoint Overview
espn_cfb_players(): ESPN College Football Players Index
espn_cfb_player_career_stats(): ESPN College Football Player Season Statistics (Long Format)
espn_cfb_player_eventlog(): ESPN College Football Player Event Log
espn_cfb_player_gamelog(): ESPN College Football Player Game Log
espn_cfb_player_overview(): ESPN College Football Player Statistics Overview
espn_cfb_player_seasons(): ESPN College Football Player Seasons
espn_cfb_player_splits(): ESPN College Football Player Statistical Splits
espn_cfb_player_stats(): Get ESPN college football player stats data
espn_cfb_player_stats_v3(): ESPN College Football Player Stats (web v3, all categories)
espn_cfb_position(): ESPN College Football Position Detail
espn_cfb_positions(): ESPN College Football Positions Index
espn_cfb_recruits(): ESPN College Football Recruits

ESPN CFB – Coaches & venues

Coach, coach record, and venue endpoints

espn_cfb_coach(): ESPN College Football Coach Detail
espn_cfb_coaches(): ESPN College Football Coaches Index
espn_cfb_coach_record(): ESPN College Football Coach Season Record
espn_cfb_venue(): ESPN College Football Venue Detail
espn_cfb_venues(): ESPN College Football Venues Index

ESPN CFB – Awards, futures & franchises

Award catalog, futures markets, and franchise records

espn_cfb_award(): ESPN College Football Award Detail
espn_cfb_awards(): ESPN College Football Awards
espn_cfb_franchise(): ESPN College Football Franchise Detail
espn_cfb_franchises(): ESPN College Football Franchises Index
espn_cfb_futures(): ESPN College Football Betting Futures (Long Format)

ESPN CFB – Metrics & ratings

Win probability, QBR, power index, and FPI ratings

espn_metrics_wp(): ESPN Metrics
espn_ratings_fpi(): ESPN FPI Ratings
espn_cfb_qbr(): ESPN College Football Total Quarterback Rating (QBR)
espn_cfb_powerindex(): ESPN College Football Power Index (Long Format)

ESPN CFB – Cache management

Catalog-cache management helpers

espn_cfb_clear_cache(): Clear the cfbfastR ESPN catalog cache

Yahoo Sports Data

Yahoo CFB – Stats, scoreboard & boxscore

Yahoo Sports college-football endpoints (player/team season stats, legacy per-category leaders, scoreboard, and boxscore scaffold), wrapping Yahoo’s shangrila stats graph and editorial feed

yahoo_cfb_boxscore(): Get Yahoo Sports college football boxscore (SCAFFOLD)
yahoo_cfb_player_season_stats(): Get Yahoo Sports college football player season stats (modern)
yahoo_cfb_player_season_stats_legacy(): Get Yahoo Sports CFB legacy per-category player leaders
yahoo_cfb_scoreboard(): Get Yahoo Sports college football scoreboard
yahoo_cfb_team_season_stats(): Get Yahoo Sports college football team season stats (modern)
yahoo_cfb_team_season_stats_legacy(): Get Yahoo Sports CFB legacy per-category team stats

Helper Functions and Data

Included data

Data included within the package

cfbd_play_type_df cfbd_conf_types_df: Data in the package for reference

Model functions and PBP helpers

Expected points / win probability models and play-by-play parsing helpers

create_epa() epa_fg_probs(): Create EPA
create_wpa_naive() wpa_calcs_naive(): Create WPA
add_play_counts() clean_drive_dat() prep_epa_df_after() clean_drive_info() clean_play_text() add_player_cols() add_yardage() clean_pbp_dat() penalty_detection(): Series of functions to help clean the play-by-play data for analysis

cfbfastR Helper Functions

Internal helpers used by cfbfastR

csv_from_url(): Load .csv / .csv.gz file from a remote connection
rds_from_url(): Load .rds file from a remote connection