recruiting — native provider reference

• namespace: sdv.recruiting (standalone — not an ESPN league)
• families: 247Sports
• wrappers: 25 native

recruiting is a cross-sport provider namespace (no ESPN {sport}/{league} nesting). Every method is exposed under BOTH its snake_case name (<family>_<endpoint>, py/R parity) and a camelCase canonical name (<family><Endpoint>) on sdv.recruiting. Pass { parsed: true } to any endpoint to get tidy rows instead of raw JSON.

import sdv from 'sportsdataverse';

// 247Sports recruiting rankings (pass your own JWT via `headers`):
await sdv.recruiting.recruiting_rankings({
  sport_key: 'football', year: 2025,
  headers: { Authorization: `Bearer ${process.env.SPORTS247_TOKEN}` },
});

Native API — 247Sports

Flat (non-ESPN) wrappers for the 247Sports recruiting database. Host: https://api.247sports.com. Each method is exposed under BOTH recruiting_<endpoint> (snake_case, py/R parity) and recruiting<Endpoint> (camelCase canonical) on sdv.recruiting. Pass { parsed: true } to run the payload through its tidy.js parser; omit it for the raw response.

Method	HTTP	Path params	Query params	Parser	Auth
recruiting_archived_player_rankings / recruitingArchivedPlayerRankings	https://api.247sports.com/rdb/v1/rankings/{ranking_key}/archivedPlayerRankings	ranking_key*	page_size → pagesize, page	parse_recruiting_list	—
recruiting_biggest_movers / recruitingBiggestMovers	https://api.247sports.com/rdb/v1/rankings/{ranking_key}/biggestMovers	ranking_key*	page_size → pageSize	parse_recruiting_list	—
recruiting_coaches / recruitingCoaches	https://api.247sports.com/rdb/v1/coaches	—	sport_key → sportKey, year, page, page_size → pageSize	parse_recruiting_list	—
recruiting_current_target_predictions / recruitingCurrentTargetPredictions	https://api.247sports.com/rdb/v1/sites/{site_key}/years/{year}/sports/{sport_key}/currentTargetPredictions	site_key*, year*, sport_key*	page, page_size → pageSize	parse_recruiting_list	—
recruiting_institution_groups / recruitingInstitutionGroups	https://api.247sports.com/rdb/v1/institutionGroups	—	—	parse_recruiting_list	—
recruiting_institution_rankings / recruitingInstitutionRankings	https://api.247sports.com/rdb/v1/rankings/{sport_key}/{year}/institutionrankings	sport_key*, year*	institution_key → institutionKey, ranking_type → rankingType, conference_abbreviation → conferenceAbbreviation, use_composite → useComposite, institutions, page_size → pagesize, page	parse_recruiting_institution_rankings	—
recruiting_player_sport_rankings / recruitingPlayerSportRankings	https://api.247sports.com/rdb/v1/playerSportRankings	—	state_abbreviation → stateAbbreviation, position_abbreviation → positionAbbreviation, ranking_key → rankingKey, year, sport, institution_group → institutionGroup, player_sport_rating → playerSportRating, page_size → pagesize, page	parse_recruiting_list	—
recruiting_players_under_special_evaluation / recruitingPlayersUnderSpecialEvaluation	https://api.247sports.com/rdb/v1/rankings/{ranking_key}/playerSportsUnderSpecialEvaluation	ranking_key*	—	parse_recruiting_list	—
recruiting_positions / recruitingPositions	https://api.247sports.com/rdb/v1/positions	—	ranking_key → rankingKey, sport_key → sportKey, year	parse_recruiting_list	—
recruiting_rankings / recruitingRankings	https://api.247sports.com/rdb/v1/rankings	—	year, sport_key → sportKey, ranking_type → rankingType, ranking_version → rankingVersion	parse_recruiting_list	—
recruiting_rankings_composite_team_feed / recruitingRankingsCompositeTeamFeed	https://api.247sports.com/rdb/v1/rankings/{sport_key}/{year}/compositeTeamRankingFeed	sport_key*, year*	page_size → pageSize	parse_recruiting_ranking_feed	—
recruiting_rankings_transfer_portal_player_feed / recruitingRankingsTransferPortalPlayerFeed	https://api.247sports.com/rdb/v1/rankings/{sport_key}/{year}/transferPortalPlayerfeed	sport_key*, year*	page_size → pageSize	parse_recruiting_ranking_feed	—
recruiting_rankings_transfer_portal_team_feed / recruitingRankingsTransferPortalTeamFeed	https://api.247sports.com/rdb/v1/rankings/{sport_key}/{year}/transferPortalOnlyTeamFeed	sport_key*, year*	page_size → pageSize	parse_recruiting_ranking_feed	—
recruiting_recruits / recruitingRecruits	https://api.247sports.com/rdb/v1/recruits	—	sport_key → sportKey, year, min_date → minDate, page, page_size → pageSize	parse_recruiting_list	—
recruiting_sport_years / recruitingSportYears	https://api.247sports.com/rdb/v1/sports/{sport_key}/year	sport_key*	—	parse_recruiting_list	—
recruiting_sports / recruitingSports	https://api.247sports.com/rdb/v1/sports	—	ranking_key → rankingKey	parse_recruiting_list	—
recruiting_tags_autocomplete / recruitingTagsAutocomplete	https://api.247sports.com/rdb/v1/tags/autocomplete	—	default_name → defaultName, items	parse_recruiting_list	—
recruiting_tags_photos_by_key / recruitingTagsPhotosByKey	https://api.247sports.com/rdb/v1/tags/{prefixed_key}/photos	prefixed_key*	page, page_size → pageSize	parse_recruiting_paged_list	—
recruiting_tags_photos_by_type / recruitingTagsPhotosByType	https://api.247sports.com/rdb/v1/tags/{type}/{key}/photos	type*, key*	page, page_size → pageSize	parse_recruiting_paged_list	—
recruiting_teams / recruitingTeams	https://api.247sports.com/rdb/v1/teams	—	sport_key → sportKey, year, institution_type → institutionType	parse_recruiting_list	—
recruiting_transfer_player_sport_rankings / recruitingTransferPlayerSportRankings	https://api.247sports.com/rdb/v1/transferPlayerSportRankings	—	state_abbreviation → stateAbbreviation, position_abbreviation → positionAbbreviation, ranking_key → rankingKey, year, sport, institution_group → institutionGroup, player_sport_rating → playerSportRating, page_size → pagesize, page	parse_recruiting_list	—
recruiting_transfers / recruitingTransfers	https://api.247sports.com/rdb/v1/transfers	—	sport_key → sportKey, year, list_type → listType, position_group_key → positionGroupKey, position_key → positionKey, eligibility, institution_key → institutionKey, status, page_size → pageSize, page	parse_recruiting_list	—
recruiting_unranked_recruits / recruitingUnrankedRecruits	https://api.247sports.com/rdb/v1/unrankedRecruits	—	state_abbreviation → stateAbbreviation, position_abbreviation → positionAbbreviation, ranking_key → rankingKey, year, sport, institution_group → institutionGroup, player_sport_rating → playerSportRating, list_type → listType, page_size → pagesize, page	parse_recruiting_list	—
recruiting_unranked_transfers / recruitingUnrankedTransfers	https://api.247sports.com/rdb/v1/transferrankings/{ranking_key}/unrankedtransfers	ranking_key*	state_abbreviation → stateAbbreviation, position_abbreviation → positionAbbreviation, page_size → pagesize, page	parse_recruiting_list	—
recruiting_year / recruitingYear	https://api.247sports.com/rdb/v1/year	—	ranking_key → rankingKey	parse_recruiting_list	—

Returns — recruiting_archived_player_rankings / recruitingArchivedPlayerRankings

col_name	type	description
ranking_key	numeric	ranking key
key	numeric	key
index	numeric	index
order	numeric	order
current_rating	numeric	current rating
rating	numeric	rating
current_group_rank	numeric	current group rank
previous_group_rank	numeric	previous group rank
current_group_composite_rank	numeric	current group composite rank
current_overall_rank	numeric	current overall rank
current_overall_composite_rank	numeric	current overall composite rank
player_sport_rating	numeric	player sport rating
under_evaluation	logical	under evaluation
first_name	character	first name
last_name	character	last name
player_key	numeric	player key
player_institution_key	numeric	player institution key
position	character	position
city	character	city
state	character	state
current_order	character	current order
has_eval	logical	has eval
current_star_rating	numeric	current star rating
star_rating	numeric	star rating
player_sport_star_rating	numeric	player sport star rating
height	numeric	height
weight	numeric	weight
move	numeric	move
current_temp_rank	numeric	current temp rank
previous_temp_rank	numeric	previous temp rank

Returns — recruiting_biggest_movers / recruitingBiggestMovers

col_name	type	description
ranking_key	numeric	ranking key
key	numeric	key
index	numeric	index
order	numeric	order
current_rating	numeric	current rating
rating	numeric	rating
current_group_rank	numeric	current group rank
previous_group_rank	numeric	previous group rank
current_group_composite_rank	numeric	current group composite rank
current_overall_rank	numeric	current overall rank
current_overall_composite_rank	numeric	current overall composite rank
player_sport_rating	numeric	player sport rating
under_evaluation	logical	under evaluation
first_name	character	first name
last_name	character	last name
player_key	numeric	player key
player_institution_key	numeric	player institution key
position	character	position
city	character	city
state	character	state
current_order	character	current order
has_eval	logical	has eval
current_star_rating	numeric	current star rating
star_rating	numeric	star rating
player_sport_star_rating	numeric	player sport star rating
height	numeric	height
weight	numeric	weight
move	numeric	move
current_temp_rank	numeric	current temp rank
previous_temp_rank	numeric	previous temp rank

Returns — recruiting_institution_rankings / recruitingInstitutionRankings

col_name	type	description
pagination_count	numeric	Paging context: count.
pagination_offset	numeric	Paging context: offset.
pagination_limit	numeric	Paging context: limit.
pagination_items_per_page	numeric	Paging context: items per page.
pagination_current_page	numeric	Paging context: current page.
pagination_page_count	numeric	Paging context: page count.
name	character	name of the institution
conference_rank	numeric	conference Transfer Rank
conference_composite_rank	numeric	conference Transfer Ranking Composite Rank
rank	numeric	Transfer Rank
composite_rank	numeric	Transfer Ranking Composite Rank
institution_key	numeric	unique identifier of the institution
team_key	numeric	unique identifier of the team
average_rating	numeric	average rating
rating	numeric	team rating
composite_rating	numeric	team composite rating
average_composite_rating	numeric	average composite rating
default_asset	character	institution default logo
alternate_asset	character	an alternate institution logo
high_school_ranking_position	numeric	high school rankingposition
transfer_points	numeric	transfer points for the institution
transfer_number	numeric	number of transfers for the institution
five_stars	numeric	five star count
composite_five_stars	numeric	composite five star count
four_stars	numeric	four star count
composite_four_stars	numeric	composite four star count
three_stars	numeric	three star count
composite_three_stars	numeric	composite three star count
commits	numeric	commit count
site_key	numeric	site key
institution_root_path	character	Team Site Url
ranking_date	character	ranking date
city	character	city
state	character	state
institution_ranking_url	character	institution ranking url

Returns — recruiting_player_sport_rankings / recruitingPlayerSportRankings

col_name	type	description
ranking_key	numeric	ranking key
key	numeric	key
index	numeric	index
order	numeric	order
current_rating	numeric	current rating
rating	numeric	rating
current_group_rank	numeric	current group rank
previous_group_rank	numeric	previous group rank
current_group_composite_rank	numeric	current group composite rank
current_overall_rank	numeric	current overall rank
current_overall_composite_rank	numeric	current overall composite rank
player_sport_rating	numeric	player sport rating
under_evaluation	logical	under evaluation
first_name	character	first name
last_name	character	last name
player_key	numeric	player key
player_institution_key	numeric	player institution key
position	character	position
city	character	city
state	character	state
current_order	character	current order
has_eval	logical	has eval
current_star_rating	numeric	current star rating
star_rating	numeric	star rating
player_sport_star_rating	numeric	player sport star rating
height	numeric	height
weight	numeric	weight
move	numeric	move
current_temp_rank	numeric	current temp rank
previous_temp_rank	numeric	previous temp rank

Returns — recruiting_players_under_special_evaluation / recruitingPlayersUnderSpecialEvaluation

col_name	type	description
ranking_key	numeric	ranking key
key	numeric	key
index	numeric	index
order	numeric	order
current_rating	numeric	current rating
rating	numeric	rating
current_group_rank	numeric	current group rank
previous_group_rank	numeric	previous group rank
current_group_composite_rank	numeric	current group composite rank
current_overall_rank	numeric	current overall rank
current_overall_composite_rank	numeric	current overall composite rank
player_sport_rating	numeric	player sport rating
under_evaluation	logical	under evaluation
first_name	character	first name
last_name	character	last name
player_key	numeric	player key
player_institution_key	numeric	player institution key
position	character	position
city	character	city
state	character	state
current_order	character	current order
has_eval	logical	has eval
current_star_rating	numeric	current star rating
star_rating	numeric	star rating
player_sport_star_rating	numeric	player sport star rating
height	numeric	height
weight	numeric	weight
move	numeric	move
current_temp_rank	numeric	current temp rank
previous_temp_rank	numeric	previous temp rank

Returns — recruiting_positions / recruitingPositions

col_name	type	description
key	numeric	key
position_group_key	numeric	position group key
name	character	name
abbreviation	character	abbreviation
start_year	numeric	start year
end_year	numeric	end year
player_positions	character	player positions
player_sport_rankings	character	player sport rankings
position_group	character	position group

Returns — recruiting_rankings_composite_team_feed / recruitingRankingsCompositeTeamFeed

col_name	type	description
key	numeric	unique identifier of the institution
target_institution_logo	character	institution default logo
target_institution_name	character	name of the target institution
position	character	player's position
first_name	character	player's first name
last_name	character	player's last name
ranking_position	numeric	ranking position
previous_institution_name	character	name of the previous school
previous_institution_logo	character	name of the previous school logo

Returns — recruiting_rankings_transfer_portal_player_feed / recruitingRankingsTransferPortalPlayerFeed

col_name	type	description
key	numeric	unique identifier of the institution
target_institution_logo	character	institution default logo
target_institution_name	character	name of the target institution
position	character	player's position
first_name	character	player's first name
last_name	character	player's last name
ranking_position	numeric	ranking position
previous_institution_name	character	name of the previous school
previous_institution_logo	character	name of the previous school logo

Returns — recruiting_rankings_transfer_portal_team_feed / recruitingRankingsTransferPortalTeamFeed

col_name	type	description
key	numeric	unique identifier of the institution
target_institution_logo	character	institution default logo
target_institution_name	character	name of the target institution
position	character	player's position
first_name	character	player's first name
last_name	character	player's last name
ranking_position	numeric	ranking position
previous_institution_name	character	name of the previous school
previous_institution_logo	character	name of the previous school logo

Returns — recruiting_sports / recruitingSports

col_name	type	description
ranking_key	numeric	ranking key
label	character	label
value	character	value

Returns — recruiting_tags_autocomplete / recruitingTagsAutocomplete

col_name	type	description
id	character	id
name	character	name
type	character	type
annotation	character	annotation

Returns — recruiting_tags_photos_by_key / recruitingTagsPhotosByKey

col_name	type	description
key	numeric	key
user_key	numeric	user key
source_key	numeric	source key
date	character	date
name	character	name
description	character	description
thumbnail	character	thumbnail
file_type	character	file type
height	numeric	height
width	numeric	width
duration	numeric	duration
url	character	url

Returns — recruiting_tags_photos_by_type / recruitingTagsPhotosByType

col_name	type	description
key	numeric	key
user_key	numeric	user key
source_key	numeric	source key
date	character	date
name	character	name
description	character	description
thumbnail	character	thumbnail
file_type	character	file type
height	numeric	height
width	numeric	width
duration	numeric	duration
url	character	url

Returns — recruiting_teams / recruitingTeams

col_name	type	description
name	character	Team Name
team_id	numeric	Primary key of the team
institution_key	numeric	Key of the institution
conference	character	Name of the team's Conference
conference_abbreviation	character	Abbreviation of the team's Conference
sport	character	Name of Sport assoicated with the specific Team PK
type	character	Institutution Type (College or Pro)

Returns — recruiting_transfer_player_sport_rankings / recruitingTransferPlayerSportRankings

col_name	type	description
status	character	status
source	character	source
destination	character	destination
ranking_key	numeric	ranking key
key	numeric	key
index	numeric	index
order	numeric	order
current_rating	numeric	current rating
rating	numeric	rating
current_group_rank	numeric	current group rank
previous_group_rank	numeric	previous group rank
current_group_composite_rank	numeric	current group composite rank
current_overall_rank	numeric	current overall rank
current_overall_composite_rank	numeric	current overall composite rank
player_sport_rating	numeric	player sport rating
under_evaluation	logical	under evaluation
first_name	character	first name
last_name	character	last name
player_key	numeric	player key
player_institution_key	numeric	player institution key
position	character	position
city	character	city
state	character	state
current_order	character	current order
has_eval	logical	has eval
current_star_rating	numeric	current star rating
star_rating	numeric	star rating
player_sport_star_rating	numeric	player sport star rating
height	numeric	height
weight	numeric	weight
move	numeric	move
current_temp_rank	numeric	current temp rank
previous_temp_rank	numeric	previous temp rank

Returns — recruiting_unranked_recruits / recruitingUnrankedRecruits

col_name	type	description
ranking_key	numeric	ranking key
key	numeric	key
index	numeric	index
order	numeric	order
current_rating	numeric	current rating
rating	numeric	rating
current_group_rank	numeric	current group rank
previous_group_rank	numeric	previous group rank
current_group_composite_rank	numeric	current group composite rank
current_overall_rank	numeric	current overall rank
current_overall_composite_rank	numeric	current overall composite rank
player_sport_rating	numeric	player sport rating
under_evaluation	logical	under evaluation
first_name	character	first name
last_name	character	last name
player_key	numeric	player key
player_institution_key	numeric	player institution key
position	character	position
city	character	city
state	character	state
current_order	character	current order
has_eval	logical	has eval
current_star_rating	numeric	current star rating
star_rating	numeric	star rating
player_sport_star_rating	numeric	player sport star rating
height	numeric	height
weight	numeric	weight
move	numeric	move
current_temp_rank	numeric	current temp rank
previous_temp_rank	numeric	previous temp rank

Returns — recruiting_unranked_transfers / recruitingUnrankedTransfers

col_name	type	description
status	character	status
source	character	source
destination	character	destination
ranking_key	numeric	ranking key
key	numeric	key
index	numeric	index
order	numeric	order
current_rating	numeric	current rating
rating	numeric	rating
current_group_rank	numeric	current group rank
previous_group_rank	numeric	previous group rank
current_group_composite_rank	numeric	current group composite rank
current_overall_rank	numeric	current overall rank
current_overall_composite_rank	numeric	current overall composite rank
player_sport_rating	numeric	player sport rating
under_evaluation	logical	under evaluation
first_name	character	first name
last_name	character	last name
player_key	numeric	player key
player_institution_key	numeric	player institution key
position	character	position
city	character	city
state	character	state
current_order	character	current order
has_eval	logical	has eval
current_star_rating	numeric	current star rating
star_rating	numeric	star rating
player_sport_star_rating	numeric	player sport star rating
height	numeric	height
weight	numeric	weight
move	numeric	move
current_temp_rank	numeric	current temp rank
previous_temp_rank	numeric	previous temp rank

Returns — recruiting_year / recruitingYear

col_name	type	description
ranking_key	numeric	ranking key
label	character	label
value	character	value