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. Required if team not provided
- team
(String optional): D-I Team. Required if year not provided
- 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_idAthlete 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.
See also
Other CFBD Recruiting:
cfbd_recruiting_position(),
cfbd_recruiting_team(),
cfbd_recruiting_transfer_portal()
Examples
# \donttest{
try(cfbd_recruiting_player(2018, team = "Texas"))
#> ── Player recruiting info from CollegeFootballData.com ─────── cfbfastR 2.0.0 ──
#> ℹ Data updated: 2025-08-30 00:56:02 UTC
#> # A tibble: 28 × 19
#> id athlete_id recruit_type year ranking name school committed_to
#> <chr> <chr> <chr> <int> <int> <chr> <chr> <chr>
#> 1 126288 4362077 HighSchool 2018 19 Caden Sterns Steele Texas
#> 2 126293 4362086 HighSchool 2018 24 B.J. Foster Angle… Texas
#> 3 126316 4362074 HighSchool 2018 47 Jalen Green Heigh… Texas
#> 4 126321 4362088 HighSchool 2018 52 DeMarvion O… Arp Texas
#> 5 126330 4362107 HighSchool 2018 61 Brennan Eag… Alief… Texas
#> 6 126333 4362076 HighSchool 2018 64 Anthony Cook Lamar Texas
#> 7 126365 NA HighSchool 2018 96 Joshua Moore Yoakum Texas
#> 8 126373 4362109 HighSchool 2018 104 Al'vonte Wo… Lamar Texas
#> 9 126384 4362082 HighSchool 2018 115 D'Shawn Jam… Lamar Texas
#> 10 126388 4362091 HighSchool 2018 119 Ayodele Ade… IMG A… Texas
#> # ℹ 18 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 <dbl>, hometown_info_longitude <dbl>,
#> # hometown_info_fips_code <chr>
try(cfbd_recruiting_player(2016, recruit_type = "JUCO"))
#> ── Player recruiting info from CollegeFootballData.com ─────── cfbfastR 2.0.0 ──
#> ℹ Data updated: 2025-08-30 00:56:02 UTC
#> # A tibble: 470 × 19
#> id athlete_id recruit_type year ranking name school committed_to
#> <chr> <chr> <chr> <int> <int> <chr> <chr> <chr>
#> 1 185438 NA JUCO 2016 1 Jonathan Ko… Arizo… Tennessee
#> 2 185439 NA JUCO 2016 2 Charles Bal… ASA C… Alabama
#> 3 185440 -1039929 JUCO 2016 3 Garett Boll… Snow … Utah
#> 4 185441 NA JUCO 2016 4 Malcolm Pri… Nassa… Ohio State
#> 5 185442 4057659 JUCO 2016 5 Mark Thomps… Dodge… Florida
#> 6 185443 4038530 JUCO 2016 6 Taj Williams Iowa … TCU
#> 7 185444 556465 JUCO 2016 7 Jerod Evans Trini… Virginia Te…
#> 8 185445 NA JUCO 2016 8 Tyree Horton Highl… TCU
#> 9 185446 NA JUCO 2016 9 Ryan Parker Tyler… TCU
#> 10 185447 545367 JUCO 2016 10 Derrick Wil… Trini… Texas Tech
#> # ℹ 460 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 <dbl>, hometown_info_longitude <dbl>,
#> # hometown_info_fips_code <chr>
try(cfbd_recruiting_player(2020, recruit_type = "HighSchool", position = "OT", state = "FL"))
#> ── Player recruiting info from CollegeFootballData.com ─────── cfbfastR 2.0.0 ──
#> ℹ Data updated: 2025-08-30 00:56:02 UTC
#> # A tibble: 25 × 19
#> id athlete_id recruit_type year ranking name school committed_to
#> <chr> <chr> <chr> <int> <int> <chr> <chr> <chr>
#> 1 118517 4429039 HighSchool 2020 110 Marcus Dume… St. T… LSU
#> 2 118535 4429010 HighSchool 2020 128 Jalen Rivers Oakle… Miami
#> 3 118565 NA HighSchool 2020 158 Issiah Walk… Norla… Florida
#> 4 118687 4429177 HighSchool 2020 280 Joshua Braun Suwan… Florida
#> 5 118711 4433873 HighSchool 2020 304 Connor McLa… Jesuit Stanford
#> 6 118886 4593066 HighSchool 2020 483 Cayden Baker Fort … North Carol…
#> 7 118939 4565556 HighSchool 2020 533 Michael Ran… Lenna… Georgia Tech
#> 8 119485 NA HighSchool 2020 1090 Lloyd Willis Killi… NA
#> 9 119526 NA HighSchool 2020 1131 Bradley Ash… Dunca… NA
#> 10 119570 NA HighSchool 2020 1167 Cade Kootso… Crest… NA
#> # ℹ 15 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 <dbl>, hometown_info_longitude <dbl>,
#> # hometown_info_fips_code <chr>
# }