Skip to contents

Get player recruiting rankings

Usage

cfbd_recruiting_player(
  year = NULL,
  team = NULL,
  recruit_type = "HighSchool",
  state = NULL,
  position = NULL
)

Arguments

year

(Integer optional): Year, 4 digit format (YYYY) - Minimum: 2000, Maximum: 2020 currently

team

(String optional): D-I Team

recruit_type

(String optional): default API return is 'HighSchool', other options include 'JUCO' or 'PrepSchool' - For position group information

state

(String optional): Two letter State abbreviation

position

(String optional): Position Group - options include:

  • Offense: 'PRO', 'DUAL', 'RB', 'FB', 'TE', 'OT', 'OG', 'OC', 'WR'

  • Defense: 'CB', 'S', 'OLB', 'ILB', 'WDE', 'SDE', 'DT'

  • Special Teams: 'K', 'P'

Value

cfbd_recruiting_player() - A data frame with 14 variables:

id: integer.

Referencing id - 247Sports.

athlete_id

Athlete referencing id.

recruit_type: character.

High School, Prep School, or Junior College.

year: integer.

Recruit class year.

ranking: integer.

Recruit Ranking.

name: character.

Recruit Name.

school: character.

School recruit attended.

committed_to: character.

School the recruit is committed to.

position: character.

Recruit position.

height: double.

Recruit height.

weight: integer.

Recruit weight.

stars: integer.

Recruit stars.

rating: double.

247 composite rating.

city: character.

Hometown of the recruit.

state_province: character.

Hometown state of the recruit.

country: character.

Hometown country of the recruit.

hometown_info_latitude: character.

Hometown latitude.

hometown_info_longitude: character.

Hometown longitude.

hometown_info_fips_code: character.

Hometown FIPS code.

Examples

# \donttest{
  try(cfbd_recruiting_player(2018, team = "Texas"))
#> ── Player recruiting info from CollegeFootballData.com ─────── cfbfastR 1.9.5 ──
#>  Data updated: 2024-02-01 16:01:06 UTC
#> # A tibble: 29 × 19
#>    id    athlete_id recruit_type  year ranking name          school committed_to
#>    <chr> <chr>      <chr>        <int>   <int> <chr>         <chr>  <chr>       
#>  1 42926 4362077    HighSchool    2018      19 Caden Sterns  Steele Texas       
#>  2 42931 4362086    HighSchool    2018      24 B.J. Foster   Angle… Texas       
#>  3 42954 4362074    HighSchool    2018      47 Jalen Green   Heigh… Texas       
#>  4 42959 4362088    HighSchool    2018      52 DeMarvion Ov… Arp    Texas       
#>  5 42968 4362107    HighSchool    2018      61 Brennan Eagl… Alief… Texas       
#>  6 42971 4362076    HighSchool    2018      64 Anthony Cook  Lamar  Texas       
#>  7 43003 4362079    HighSchool    2018      96 Joshua Moore  Yoakum Texas       
#>  8 43011 NA         HighSchool    2018     104 Al'vonte Woo… Lamar  Texas       
#>  9 43022 NA         HighSchool    2018     115 D'shawn Jami… Lamar  Texas       
#> 10 43026 4362091    HighSchool    2018     119 Ayodele Adeo… IMG A… Texas       
#> # ℹ 19 more rows
#> # ℹ 11 more variables: position <chr>, height <dbl>, weight <int>, stars <int>,
#> #   rating <dbl>, city <chr>, state_province <chr>, country <chr>,
#> #   hometown_info_latitude <chr>, hometown_info_longitude <chr>,
#> #   hometown_info_fips_code <chr>

  try(cfbd_recruiting_player(2016, recruit_type = "JUCO"))
#> ── Player recruiting info from CollegeFootballData.com ─────── cfbfastR 1.9.5 ──
#>  Data updated: 2024-02-01 16:01:06 UTC
#> # A tibble: 476 × 19
#>    id    athlete_id recruit_type  year ranking name          school committed_to
#>    <chr> <chr>      <chr>        <int>   <int> <chr>         <chr>  <chr>       
#>  1 55123 NA         JUCO          2016       1 Jonathan Kon… Arizo… Tennessee   
#>  2 55124 NA         JUCO          2016       2 Charles Bald… ASA C… Alabama     
#>  3 55125 -1039929   JUCO          2016       3 Garett Bolles Snow … Utah        
#>  4 55126 NA         JUCO          2016       4 Malcolm Prid… Nassa… Ohio State  
#>  5 55127 4057659    JUCO          2016       5 Mark Thompson Dodge… Florida     
#>  6 55128 4038530    JUCO          2016       6 Taj Williams  Iowa … TCU         
#>  7 55129 556465     JUCO          2016       7 Jerod Evans   Trini… Virginia Te…
#>  8 55130 NA         JUCO          2016       8 Tyree Horton  Highl… TCU         
#>  9 55131 NA         JUCO          2016       9 Ryan Parker   Tyler… TCU         
#> 10 55132 545367     JUCO          2016      10 Derrick Will… Trini… Texas Tech  
#> # ℹ 466 more rows
#> # ℹ 11 more variables: position <chr>, height <dbl>, weight <int>, stars <int>,
#> #   rating <dbl>, city <chr>, state_province <chr>, country <chr>,
#> #   hometown_info_latitude <chr>, hometown_info_longitude <chr>,
#> #   hometown_info_fips_code <chr>

  try(cfbd_recruiting_player(2020, recruit_type = "HighSchool", position = "OT", state = "FL"))
#> ── Player recruiting info from CollegeFootballData.com ─────── cfbfastR 1.9.5 ──
#>  Data updated: 2024-02-01 16:01:06 UTC
#> # A tibble: 26 × 19
#>    id    athlete_id recruit_type  year ranking name          school committed_to
#>    <chr> <chr>      <chr>        <int>   <int> <chr>         <chr>  <chr>       
#>  1 61676 4429039    HighSchool    2020     110 Marcus Dumer… St. T… LSU         
#>  2 61695 4429010    HighSchool    2020     128 Jalen Rivers  Oakle… Miami       
#>  3 61724 NA         HighSchool    2020     157 Issiah Walke… Norla… Florida     
#>  4 61838 NA         HighSchool    2020     271 Joshua Braun  Suwan… Florida     
#>  5 61885 4433873    HighSchool    2020     318 Connor McLau… Jesuit Stanford    
#>  6 62056 4593066    HighSchool    2020     491 Cayden Baker  Fort … North Carol…
#>  7 62104 4565556    HighSchool    2020     538 Michael Rank… Lenna… Georgia Tech
#>  8 62223 4431266    HighSchool    2020     658 Gerald Mincey Cardi… Florida     
#>  9 62662 4568715    HighSchool    2020    1097 Lloyd Willis  Killi… Florida Sta…
#> 10 62718 4429232    HighSchool    2020    1154 Bradley Ashm… Dunca… Vanderbilt  
#> # ℹ 16 more rows
#> # ℹ 11 more variables: position <chr>, height <int>, weight <int>, stars <int>,
#> #   rating <dbl>, city <chr>, state_province <chr>, country <chr>,
#> #   hometown_info_latitude <chr>, hometown_info_longitude <chr>,
#> #   hometown_info_fips_code <chr>
# }