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 ─────── recruitR 0.0.3 ──
#>  Data updated: 2022-12-13 04:02:00 UTC
#> # A tibble: 29 × 19
#>    id    athlete_id recruit_…¹  year ranking name  school commi…² posit…³ height
#>    <chr> <chr>      <chr>      <int>   <int> <chr> <chr>  <chr>   <chr>    <dbl>
#>  1 42926 4362077    HighSchool  2018      19 Cade… Steele Texas   S         73  
#>  2 42931 4362086    HighSchool  2018      24 B.J.… Angle… Texas   S         73  
#>  3 42954 4362074    HighSchool  2018      47 Jale… Heigh… Texas   CB        72  
#>  4 42959 4362088    HighSchool  2018      52 DeMa… Arp    Texas   S         76  
#>  5 42968 4362107    HighSchool  2018      61 Bren… Alief… Texas   WR        75.5
#>  6 42971 4362076    HighSchool  2018      64 Anth… Lamar  Texas   CB        72  
#>  7 43003 4362079    HighSchool  2018      96 Josh… Yoakum Texas   WR        73  
#>  8 43011 NA         HighSchool  2018     104 Al'v… Lamar  Texas   WR        73  
#>  9 43022 NA         HighSchool  2018     115 D'sh… Lamar  Texas   CB        70  
#> 10 43026 4362091    HighSchool  2018     119 Ayod… IMG A… Texas   ILB       72  
#> # … with 19 more rows, 9 more variables: 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>, and abbreviated variable names
#> #   ¹​recruit_type, ²​committed_to, ³​position

  try(cfbd_recruiting_player(2016, recruit_type = "JUCO"))
#> ── Player recruiting info from CollegeFootballData.com ─────── recruitR 0.0.3 ──
#>  Data updated: 2022-12-13 04:02:00 UTC
#> # A tibble: 476 × 19
#>    id    athlete_id recruit_…¹  year ranking name  school commi…² posit…³ height
#>    <chr> <chr>      <chr>      <int>   <int> <chr> <chr>  <chr>   <chr>    <dbl>
#>  1 55123 NA         JUCO        2016       1 Jona… Arizo… Tennes… SDE       77.5
#>  2 55124 NA         JUCO        2016       2 Char… ASA C… Alabama OT        77  
#>  3 55125 -1039929   JUCO        2016       3 Gare… Snow … Utah    OT        77  
#>  4 55126 NA         JUCO        2016       4 Malc… Nassa… Ohio S… OT        80  
#>  5 55127 4057659    JUCO        2016       5 Mark… Dodge… Florida RB        74  
#>  6 55128 4038530    JUCO        2016       6 Taj … Iowa … TCU     WR        75  
#>  7 55129 556465     JUCO        2016       7 Jero… Trini… Virgin… DUAL      76  
#>  8 55130 NA         JUCO        2016       8 Tyre… Highl… TCU     OLB       72  
#>  9 55131 NA         JUCO        2016       9 Ryan… Tyler… TCU     WR        74  
#> 10 55132 545367     JUCO        2016      10 Derr… Trini… Texas … WR        76  
#> # … with 466 more rows, 9 more variables: 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>, and abbreviated variable names
#> #   ¹​recruit_type, ²​committed_to, ³​position

  try(cfbd_recruiting_player(2020, recruit_type = "HighSchool", position = "OT", state = "FL"))
#> ── Player recruiting info from CollegeFootballData.com ─────── recruitR 0.0.3 ──
#>  Data updated: 2022-12-13 04:02:01 UTC
#> # A tibble: 26 × 19
#>    id    athlete_id recruit_…¹  year ranking name  school commi…² posit…³ height
#>    <chr> <chr>      <chr>      <int>   <int> <chr> <chr>  <chr>   <chr>    <int>
#>  1 61676 4429039    HighSchool  2020     110 Marc… St. T… LSU     OT          77
#>  2 61695 4429010    HighSchool  2020     128 Jale… Oakle… Miami   OT          78
#>  3 61724 NA         HighSchool  2020     157 Issi… Norla… Florida OT          76
#>  4 61838 NA         HighSchool  2020     271 Josh… Suwan… Florida OT          78
#>  5 61885 4433873    HighSchool  2020     318 Conn… Jesuit Stanfo… OT          79
#>  6 62056 4593066    HighSchool  2020     491 Cayd… Fort … North … OT          78
#>  7 62104 4565556    HighSchool  2020     538 Mich… Lenna… Georgi… OT          77
#>  8 62223 4431266    HighSchool  2020     658 Gera… Cardi… Florida OT          77
#>  9 62662 4568715    HighSchool  2020    1097 Lloy… Killi… Florid… OT          79
#> 10 62718 4429232    HighSchool  2020    1154 Brad… Dunca… Vander… OT          78
#> # … with 16 more rows, 9 more variables: 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>, and abbreviated variable names
#> #   ¹​recruit_type, ²​committed_to, ³​position
# }