Skip to contents

Get player recruiting rankings from the CollegeBasketballData API.

Get team recruiting rankings from the CollegeBasketballData API.

Get transfer portal data from the CollegeBasketballData API.

Usage

cbbd_recruiting_players(
  year = NULL,
  team = NULL,
  conference = NULL,
  position = NULL
)

cbbd_recruiting_teams(year = NULL, team = NULL, conference = NULL)

cbbd_recruiting_portal(
  year = NULL,
  source_team = NULL,
  destination_team = NULL,
  source_conference = NULL,
  destination_conference = NULL,
  position = NULL
)

Arguments

year

(integer optional): Recruiting class year (e.g. 2024).

team

(character optional): Committed team filter.

conference

(character optional): Conference abbreviation filter.

position

(character optional): Position filter.

source_team

(character optional): Origin team filter.

destination_team

(character optional): Destination team filter.

source_conference

(character optional): Origin conference filter.

destination_conference

(character optional): Destination conference filter.

Value

A hoopR_data tibble with one row per recruit. The hometown and committed_to objects are flattened into prefixed columns:

col_nametypesdescription
idintegerRecruit id.
source_idcharacterSource (ESPN) recruit id.
positioncharacterRecruit position.
school_idintegerHigh school / club id.
schoolcharacterHigh school / club name.
athlete_idintegerAthlete id (once enrolled).
yearintegerRecruiting class year.
namecharacterRecruit name.
height_inchesnumericHeight in inches.
weight_poundsintegerWeight in pounds.
starsintegerStar rating.
ratingnumericNumeric recruit rating.
rankingintegerOverall ranking.

A hoopR_data tibble with one row per team:

col_nametypesdescription
team_idintegerCollegeBasketballData team id.
teamcharacterTeam name.
conferencecharacterConference name.
yearintegerRecruiting class year.
rankingintegerTeam recruiting ranking.
ratingnumericTeam recruiting rating.

A hoopR_data tibble with one row per transfer. The origin and destination objects are flattened into prefixed columns:

col_nametypesdescription
idintegerTransfer id.
source_idcharacterSource (ESPN) athlete id.
yearintegerTransfer class year.
first_namecharacterPlayer first name.
last_namecharacterPlayer last name.
positioncharacterPlayer position.
eligibilitycharacterEligibility status.
years_remainingintegerYears of eligibility remaining.
starsintegerStar rating.
ratingnumericNumeric rating.

Examples

# \donttest{
  try(cbbd_recruiting_players(year = 2024))
#>  2026-08-27 17:46:34.563571: Invalid arguments or no recruiting players available!
#>  Args: year = 2024, team = NULL, conference = NULL, position = NULL
#>  Error: api.collegebasketballdata.com requires an API key.        See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }
# \donttest{
  try(cbbd_recruiting_teams(year = 2024))
#>  2026-08-27 17:46:34.573898: Invalid arguments or no team recruiting rankings available!
#>  Args: year = 2024, team = NULL, conference = NULL
#>  Error: api.collegebasketballdata.com requires an API key.        See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }
# \donttest{
  try(cbbd_recruiting_portal(year = 2024))
#>  2026-08-27 17:46:34.584083: Invalid arguments or no transfer portal data available!
#>  Args: year = 2024, source_team = NULL, destination_team = NULL, source_conference = NULL, destination_conference = NULL, position = NULL
#>  Error: api.collegebasketballdata.com requires an API key.        See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }