Player information lookup
Arguments
- search_term
(String required): Search term for the player you are trying to look up
- position
(string optional): Position of the player you are searching for. Position Group - options include:
Offense: QB, RB, FB, TE, OL, G, OT, C, WR
Defense: DB, CB, S, LB, DE, DT, NT, DL
Special Teams: K, P, LS, PK
- team
(String optional): Team - Select a valid team, D1 football
- year
(Integer optional): Year, 4 digit format (YYYY). If left NULL, API default will only provide results for most recent year of final rosters: 2020
Value
cfbd_player_info() - A data frame with 12 variables:
| col_name | types | description |
| athlete_id | character | Unique CFBD player identifier. |
| team | character | Team of the player. |
| name | character | Player full name. |
| first_name | character | Player first name. |
| last_name | character | Player last name. |
| weight | integer | Player weight in pounds. |
| height | integer | Player height in inches. |
| jersey | integer | Player jersey number. |
| position | character | Player position abbreviation (e.g. QB, RB, WR). |
| home_town | character | Player home town. |
| team_color | character | Player team primary color (hex code). |
| team_color_secondary | character | Player team secondary color (hex code). |
See also
Other CFBD Players:
cfbd_player_returning(),
cfbd_player_usage()
Examples
# \donttest{
try(cfbd_player_info(search_term = "James", position = "DB", team = "Florida State", year = 2017))
#> ── Player information from CollegeFootballData.com ─────────── cfbfastR 2.3.0 ──
#> ℹ Data updated: 2026-06-13 04:19:51 UTC
#> # A tibble: 1 × 12
#> athlete_id team name first_name last_name weight height jersey position
#> <chr> <chr> <chr> <chr> <chr> <int> <int> <int> <chr>
#> 1 3691739 Florida S… Derw… Derwin James 211 75 3 DB
#> # ℹ 3 more variables: home_town <chr>, team_color <chr>,
#> # team_color_secondary <chr>
try(cfbd_player_info(search_term = "Lawrence", team = "Clemson"))
#> ── Player information from CollegeFootballData.com ─────────── cfbfastR 2.3.0 ──
#> ℹ Data updated: 2026-06-13 04:19:51 UTC
#> # A tibble: 2 × 12
#> athlete_id team name first_name last_name weight height jersey position
#> <chr> <chr> <chr> <chr> <chr> <int> <int> <int> <chr>
#> 1 4035483 Clemson Dexter … Dexter Lawrence 340 76 90 DT
#> 2 4360310 Clemson Trevor … Trevor Lawrence 220 78 16 QB
#> # ℹ 3 more variables: home_town <chr>, team_color <chr>,
#> # team_color_secondary <chr>
# }