Skip to contents

Get college football position group recruiting information.

Usage

cfbd_recruiting_position(
  start_year = NULL,
  end_year = NULL,
  team = NULL,
  conference = NULL,
  recruit_type = NULL
)

Arguments

start_year

(Integer optional): Start Year, 4 digit format (YYYY). Note: 2000 is the minimum value

end_year

(Integer optional): End Year, 4 digit format (YYYY). Note: 2020 is the maximum value currently

team

(String optional): Team - Select a valid team, D-I football

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

recruit_type

(String optional): HighSchool, PrepSchool or JUCO.

Value

cfbd_recruiting_position() - A data frame with 7 variables:

col_nametypesdescription
teamcharacterRecruiting team (school) name.
conferencecharacterConference affiliation of the recruiting team.
position_groupcharacterPosition group of the recruits (e.g. Offensive Line, Defensive Back).
avg_ratingnumericAverage 247Sports composite rating of recruits in the position group.
total_ratingnumericSum of the 247Sports composite ratings of recruits in the group.
commitsintegerNumber of commits in the position group.
avg_starsnumericAverage star rating of recruits in the position group.

Examples

# \donttest{
  try(cfbd_recruiting_position(2018, team = "Texas"))
#> ── Recruiting position group info from CollegeFootballData.com ─────────────────
#>  Data updated: 2026-09-03 22:37:01 UTC
#> # A tibble: 16 × 7
#>    team  conference position_group avg_rating total_rating commits avg_stars    
#>    <chr> <chr>      <chr>               <dbl>        <dbl> <chr>   <chr>        
#>  1 Texas SEC        Defensive Back      0.937         37.5 40      4.0500000000…
#>  2 Texas SEC        Defensive Line      0.916         39.4 43      3.7906976744…
#>  3 Texas SEC        Linebacker          0.898         20.7 23      3.6086956521…
#>  4 Texas SEC        Offensive Line      0.908         31.8 35      3.7714285714…
#>  5 Texas SEC        Quarterback         0.927         11.1 12      4.0000000000…
#>  6 Texas SEC        Receiver            0.919         33.1 36      3.7222222222…
#>  7 Texas SEC        Running Back        0.918         12.8 14      3.9285714285…
#>  8 Texas SEC        Special Teams       0.879         21.1 24      3.4166666666…
#>  9 Texas SEC        All Positions       0.937         37.5 41      4.0500000000…
#> 10 Texas SEC        All Positions       0.916         39.4 43      3.7906976744…
#> 11 Texas SEC        All Positions       0.898         20.7 23      3.6086956521…
#> 12 Texas SEC        All Positions       0.908         31.8 35      3.7714285714…
#> 13 Texas SEC        All Positions       0.927         11.1 12      4.0000000000…
#> 14 Texas SEC        All Positions       0.919         33.1 36      3.7222222222…
#> 15 Texas SEC        All Positions       0.918         12.8 14      3.9285714285…
#> 16 Texas SEC        All Positions       0.879         21.1 24      3.4166666666…

  try(cfbd_recruiting_position(2016, 2020, team = "Virginia"))
#> ── Recruiting position group info from CollegeFootballData.com ─────────────────
#>  Data updated: 2026-09-03 22:37:02 UTC
#> # A tibble: 16 × 7
#>    team     conference position_group avg_rating total_rating commits avg_stars 
#>    <chr>    <chr>      <chr>               <dbl>        <dbl> <chr>   <chr>     
#>  1 Virginia ACC        Defensive Back      0.833        11.7  14      2.8571428…
#>  2 Virginia ACC        Defensive Line      0.854        13.7  16      3.1250000…
#>  3 Virginia ACC        Linebacker          0.848        15.3  18      3.0000000…
#>  4 Virginia ACC        Offensive Line      0.837        14.2  17      2.9411764…
#>  5 Virginia ACC        Quarterback         0.851         4.26 5       3.0000000…
#>  6 Virginia ACC        Receiver            0.841        16.0  19      2.9473684…
#>  7 Virginia ACC        Running Back        0.848         5.94 7       3.0000000…
#>  8 Virginia ACC        Special Teams       0.837         9.21 11      2.9090909…
#>  9 Virginia ACC        All Positions       0.833        11.7  16      2.8571428…
#> 10 Virginia ACC        All Positions       0.854        13.7  16      3.1250000…
#> 11 Virginia ACC        All Positions       0.848        15.3  18      3.0000000…
#> 12 Virginia ACC        All Positions       0.837        14.2  17      2.9411764…
#> 13 Virginia ACC        All Positions       0.851         4.26 5       3.0000000…
#> 14 Virginia ACC        All Positions       0.841        16.0  20      2.9473684…
#> 15 Virginia ACC        All Positions       0.848         5.94 8       3.0000000…
#> 16 Virginia ACC        All Positions       0.837         9.21 11      2.9090909…

  try(cfbd_recruiting_position(2015, 2020, conference = "SEC"))
#> ── Recruiting position group info from CollegeFootballData.com ─────────────────
#>  Data updated: 2026-09-03 22:37:02 UTC
#> # A tibble: 224 × 7
#>    team     conference position_group avg_rating total_rating commits avg_stars 
#>    <chr>    <chr>      <chr>               <dbl>        <dbl> <chr>   <chr>     
#>  1 Alabama  SEC        Defensive Back      0.947        21.8  23      4.0000000…
#>  2 Alabama  SEC        Defensive Line      0.951        27.6  29      4.1724137…
#>  3 Alabama  SEC        Linebacker          0.935        15.9  17      3.9411764…
#>  4 Alabama  SEC        Offensive Line      0.937        20.6  22      4.0454545…
#>  5 Alabama  SEC        Quarterback         0.894         8.94 10      3.7000000…
#>  6 Alabama  SEC        Receiver            0.920        20.2  22      3.8181818…
#>  7 Alabama  SEC        Running Back        0.919        13.8  15      3.8000000…
#>  8 Alabama  SEC        Special Teams       0.880         9.68 11      3.4545454…
#>  9 Arkansas SEC        Defensive Back      0.863        17.3  20      3.2500000…
#> 10 Arkansas SEC        Defensive Line      0.883        21.2  24      3.3750000…
#> # ℹ 214 more rows
# }