Skip to main content
Breaking in 4.0.0
  • Integer id columns are decimal strings — Every id column of integers (id, *_id, game_pk, playerId, …) comes back as exact decimal strings on every surface — parsers, producers, loaders, HockeyTech analytics. Compare and join ids as strings; Number(row.game_id) for a safe number back. (changelog)
  • 400 / 422 raise InvalidParameterError — For every family (it was AssetFetchError), never retried; the message names host, path and status with a redacted excerpt of the body. (changelog)
  • Typed returns — generated row types for parsed: true — TypeScript only. A wrapper's raw payload resolves to unknown (was any); verified endpoints resolve to their row interfaces; the summary dispatchers to ParsedTables. Narrow or cast a raw payload. (changelog)
  • Typed wrapper params and loader rows; strict mode — TypeScript only. A param the endpoint does not have, a missing required path param or a non-boolean bool param is a type error; parser rows are Record<string, unknown>; loader rows are their generated row types. (changelog)
  • Wrapper failures raise NoDataError / AssetFetchError — Instead of raw axios errors. NoDataError = the fetch worked and there is nothing there (404, ESPN { code: 404 }); AssetFetchError = the fetch failed (403 / 429 / 5xx after retries, network). Retries follow DEFAULT_RETRY_STATUSES with backoff. (changelog)

sports247 — native provider reference

  • namespace: sdv.sports247 (standalone — not an ESPN league)
  • families: 247Sports RDB, 247Sports site pages
  • wrappers: 47 native

sports247 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.sports247. Pass { parsed: true } to any endpoint to get tidy rows instead of raw JSON.

import sdv from 'sportsdataverse';

// 247Sports: a free guest token is minted for you; needs `npm install impit`
// (both hosts block plain HTTP clients). sport_key 1 = football, 2 = basketball.
await sdv.sports247.sports247InstitutionRankings({ year: 2026, parsed: true });
await sdv.sports247.sports247SitePagesInstitution({ key: 24099, parsed: true });

Native API — 247Sports RDB​

Flat (non-ESPN) wrappers for the 247Sports Recruit Database (ipa.247sports.com). Host: https://ipa.247sports.com. Each method is exposed under BOTH its snake_case name sports247_<endpoint> (sdv-py's name, py/R parity) and its camelCase form (canonical) on sdv.sports247. Pass { parsed: true } to run the payload through its tidy.js parser; omit it for the raw response. Auth: this family mints a bearer token automatically before each call (no credentials required). Transport: the host fingerprint-blocks plain HTTP clients, so this family uses the browser-impersonating transport — npm install impit (without it, calls reject with TransportUnavailableError).

MethodHTTPPath paramsQuery paramsParserAuth
sports247_coaches / sports247Coacheshttps://ipa.247sports.com/rdb/v1/coaches/—sport_key → sportKey, year, page_size → pageSize, pageparse_sports247_result_setyes
sports247_composite_team_ranking_feed / sports247CompositeTeamRankingFeedhttps://ipa.247sports.com/rdb/v1/rankings/{sport_key}/{year}/compositeTeamRankingFeed/year*, sport_keypage_size → pageSizeparse_sports247_result_setyes
sports247_institution_rankings / sports247InstitutionRankingshttps://ipa.247sports.com/rdb/v1/rankings/{sport_key}/{year}/institutionrankings/year*, sport_keypage_size → pagesize, page, use_composite → useComposite, conference_abbreviation → conferenceAbbreviation, institution_key → institutionKeyparse_sports247_institution_rankingsyes
sports247_positions / sports247Positionshttps://ipa.247sports.com/rdb/v1/positions/—sport_key → sportKey, year, ranking_key → rankingKeyparse_sports247_result_setyes
sports247_recruits / sports247Recruitshttps://ipa.247sports.com/rdb/v1/recruits/—sport_key → sportKey, year, page_size → pagesize, page, position_abbreviation → positionAbbreviation, state_abbreviation → stateAbbreviationparse_sports247_result_setyes
sports247_sport_years / sports247SportYearshttps://ipa.247sports.com/rdb/v1/sports/{sport_key}/year/sport_key—parse_sports247_result_setyes
sports247_tags_autocomplete / sports247TagsAutocompletehttps://ipa.247sports.com/rdb/v1/tags/autocomplete/—default_name → defaultName, itemsparse_sports247_result_setyes
sports247_target_predictions / sports247TargetPredictionshttps://ipa.247sports.com/rdb/v1/sites/{site_key}/years/{year}/sports/{sport_key}/currentTargetPredictions/site_key*, year*, sport_keypage_size → pageSizeparse_sports247_result_setyes
sports247_teams / sports247Teamshttps://ipa.247sports.com/rdb/v1/teams/—sport_key → sportKey, year, institution_type → institutionTypeparse_sports247_teamsyes
sports247_transfer_portal_player_feed / sports247TransferPortalPlayerFeedhttps://ipa.247sports.com/rdb/v1/rankings/{sport_key}/{year}/transferPortalPlayerfeed/year*, sport_keypage_size → pageSizeparse_sports247_result_setyes
sports247_transfer_portal_team_feed / sports247TransferPortalTeamFeedhttps://ipa.247sports.com/rdb/v1/rankings/{sport_key}/{year}/transferPortalOnlyTeamFeed/year*, sport_keypage_size → pageSizeparse_sports247_result_setyes
sports247_transfers / sports247Transfershttps://ipa.247sports.com/rdb/v1/transfers/—sport_key → sportKey, year, page_size → pagesize, pageparse_sports247_result_setyes

Returns — sports247_coaches / sports247Coaches​

col_nametypedescription
keyinteger247Sports coach key.
cbs_keyintegerLegacy CBS coach key.
first_namecharacterGiven name of the coach.
last_namecharacterFamily (surname) of the coach.
profile_urlcharacter247sports.com path to the coach's profile.
default_asset_urlcharacterCDN URL of the coach's headshot.
composite_ratingcharacterCoach's composite recruiting rating (formula points).
current_jobdoubleCurrent-job program object when present; null (this scalar) otherwise (see current_job_* columns).
average_composite_ratingcharacterCoach's average composite recruit rating.
overall_rankcharacterCoach's national recruiting rank.
division_rankcharacterCoach's rank within the division.
conference_rankcharacterCoach's rank within the conference.
current_job_institution_keydouble247Sports institution key of the coach's current program.
current_job_team_keydouble247Sports RDB team key of the coach's current program.
current_job_cbs_keydoubleLegacy CBS key of the coach's current program.
current_job_namecharacterShort name of the coach's current program.
current_job_abbreviationcharacterAbbreviation of the coach's current program.
current_job_full_namecharacterFull name of the coach's current program.

Row type: Sports247Sports247CoachesRow (exported from the package root).

Returns — sports247_composite_team_ranking_feed / sports247CompositeTeamRankingFeed​

col_nametypedescription
namecharacterShort display name of the program.
full_namecharacterFull name of the program (school plus nickname).
state_abbreviationcharacterProgram's state abbreviation.
conference_namecharacterName of the athletic conference the program competes in.
keyinteger247Sports institution/team key.
logocharacterCDN URL of the program's logo.
alternate_logocharacterCDN URL of the program's alternate logo.
positionintegerRow position in the feed.
team_ranking_positionintegerRank in the high-school team recruiting class.
transfer_ranking_positionintegerRank in the transfer-portal team class.
overall_rankinteger247Sports overall national team-class rank.
composite_overall_rankintegerComposite overall national team-class rank.
conference_rankinteger247Sports class rank within the conference.
composite_conference_rankintegerComposite class rank within the conference.
five_starsintegerCount of 247Sports five-star commits.
composite_five_starsintegerCount of composite five-star commits.
four_starsintegerCount of 247Sports four-star commits.
composite_four_starsintegerCount of composite four-star commits.
three_starsintegerCount of 247Sports three-star commits.
composite_three_starsintegerCount of composite three-star commits.
average_ratingintegerAverage 247Sports commit rating.
composite_average_ratingdoubleAverage composite commit rating.
ratingintegerTotal 247Sports class rating (formula points).
composite_ratingdoubleTotal composite class rating (formula points).

Row type: Sports247Sports247CompositeTeamRankingFeedRow (exported from the package root).

Returns — sports247_institution_rankings / sports247InstitutionRankings​

col_nametypedescription
namecharacterShort display name of the institution as shown on the 247Sports class-ranking page (e.g. USC, Notre Dame).
full_namecharacterInstitution full name (school + nickname).
conference_rankinteger247Sports class rank within the conference.
conference_composite_rankintegerComposite class rank within the conference.
rankinteger247Sports national team-class rank.
composite_rankintegerIndustry-composite national team-class rank.
institution_keyinteger247Sports institution key (school-level).
team_keyinteger247Sports RDB team key (per-sport).
average_ratingdoubleAverage 247Sports rating of counted commits.
ratingdoubleTotal 247Sports class rating (team-ranking formula points).
composite_ratingdoubleTotal composite class rating (formula points).
average_composite_ratingdoubleAverage composite rating of counted commits.
default_assetcharacterCDN URL of the institution's default logo.
alternate_assetcharacterCDN URL of the institution's alternate logo.
light_assetcharacterCDN URL of the institution's light-background logo.
high_school_ranking_positioncharacterPosition of the class in the high-school-only ranking.
transfer_pointscharacterTransfer-portal points contributed to the class rating.
transfer_numberintegerNumber of incoming transfers counted in the class.
five_starsintegerCount of 247Sports five-star commits.
composite_five_starsintegerCount of composite five-star commits.
four_starsintegerCount of 247Sports four-star commits.
composite_four_starsintegerCount of composite four-star commits.
three_starsintegerCount of 247Sports three-star commits.
composite_three_starsintegerCount of composite three-star commits.
commitsintegerNumber of commits in the class.
site_keyinteger247Sports team-site key.
institution_root_pathcharacter247sports.com root path of the institution's team site.
ranking_datecharacterTimestamp the ranking row was last updated.
citycharacterInstitution city.
statecharacterFull name of the U.S. state where the institution is located.
state_abbreviationcharacterInstitution state abbreviation.
institution_ranking_urlcharacter247sports.com URL of the institution's class-ranking page.

Row type: Sports247Sports247InstitutionRankingsRow (exported from the package root).

Returns — sports247_positions / sports247Positions​

col_nametypedescription
groupcharacterPosition group name (e.g. Quarterback, Running Back).
group_keyinteger247Sports position group key.
namecharacterFull position group name (e.g. Quarterback).
labelcharacterPosition abbreviation label (e.g. QB, RB).
valuecharacter247Sports position key (returned as a string).

Row type: Sports247Sports247PositionsRow (exported from the package root).

Returns — sports247_recruits / sports247Recruits​

col_nametypedescription
keyinteger247Sports player key of the recruit.
cbs_keyintegerLegacy CBS player key (0 when unmapped).
first_namecharacterGiven name of the recruit.
last_namecharacterFamily (surname) of the recruit.
profile_urlcharacter247sports.com path to the recruit's profile.
default_asset_urlcharacterCDN URL of the recruit's headshot.
primary_positioncharacterRecruit's primary position abbreviation.
composite_ratingdouble247Sports Composite rating (industry-blended 0-1 scale).
composite_star_ratinginteger247Sports Composite star rating (2-5).
composite_national_rankintegerComposite national rank.
composite_position_rankintegerComposite rank at the recruit's position.
composite_state_rankintegerComposite rank within the recruit's state.
signed_institutiondoubleSigned-program object when present; null (this scalar) for unsigned recruits (see signed_institution_* columns).
home_town_citycharacterRecruit's home-town city.
home_town_statecharacterRecruit's home-town state.
committed_institution_institution_keyinteger247Sports institution key of the program the recruit is committed to.
committed_institution_team_keyinteger247Sports RDB team key of the program the recruit is committed to.
committed_institution_cbs_keyintegerLegacy CBS key of the program the recruit is committed to.
committed_institution_namecharacterShort name of the program the recruit is committed to.
committed_institution_abbreviationcharacterAbbreviation of the program the recruit is committed to.
committed_institution_full_namecharacterFull name of the program the recruit is committed to.
current_institution_institution_keyinteger247Sports institution key of the recruit's current program.
current_institution_team_keydouble247Sports RDB team key of the recruit's current program.
current_institution_cbs_keydoubleLegacy CBS key of the recruit's current program.
current_institution_namecharacterShort name of the recruit's current program.
current_institution_abbreviationcharacterAbbreviation of the recruit's current program.
current_institution_full_namecharacterFull name of the recruit's current program.
signed_institution_institution_keydouble247Sports institution key of the program the recruit signed with.
signed_institution_team_keydouble247Sports RDB team key of the program the recruit signed with.
signed_institution_cbs_keydoubleLegacy CBS key of the program the recruit signed with.
signed_institution_namecharacterShort name of the program the recruit signed with.
signed_institution_abbreviationcharacterAbbreviation of the program the recruit signed with.
signed_institution_full_namecharacterFull name of the program the recruit signed with.

Row type: Sports247Sports247RecruitsRow (exported from the package root).

Returns — sports247_sport_years / sports247SportYears​

col_nametypedescription
valueintegerA class year for which the 247Sports RDB has data for the sport.

Row type: Sports247Sports247SportYearsRow (exported from the package root).

Returns — sports247_tags_autocomplete / sports247TagsAutocomplete​

col_nametypedescription
idcharacter247Sports tag id (prefixed key, e.g. Player_46151084).
namecharacterDisplay name of the tagged entity.
typecharacterTag entity type (Player, Team, Institution, ...).
annotationcharacterDisambiguating annotation (e.g. class year, position, school).

Row type: Sports247Sports247TagsAutocompleteRow (exported from the package root).

Returns — sports247_target_predictions / sports247TargetPredictions​

col_nametypedescription
player_keyinteger247Sports player key of the recruit the prediction is about.
player_institution_keyinteger247Sports institution key predicted for the recruit.
prediction_typeintegerNumeric prediction-type discriminator.
ratingdoubleRecruit's 247Sports rating at prediction time.
star_ratingintegerRecruit's star rating (2-5).
positioncharacterRecruit's position abbreviation.
weightdoubleRecruit's weight in pounds.
heightcharacterRecruit's height as a formatted string.
predictioncharacterPredicted destination program name.
prediction_levelintegerExpert confidence level of the prediction.
imagecharacterCDN URL of the predicted program's logo.
alt_imagecharacterCDN URL of the predicted program's alternate logo.
light_imagecharacterCDN URL of the predicted program's light-background logo.
player_namecharacterRecruit's full name.
player_imagecharacterCDN URL of the recruit's headshot.
prediction_datecharacterTimestamp the prediction was made.
expert_namecharacterName of the expert who made the prediction.
expert_aliascharacter247Sports handle of the expert.
expert_keyinteger247Sports key of the expert.
expert_rolecharacterExpert's role/title.
expert_imagecharacterCDN URL of the expert's avatar.
expert_prediction_yearintegerClass year the expert's accuracy stats cover.
expert_yearly_total_correctintegerExpert's correct predictions this year.
expert_yearly_total_madeintegerExpert's total predictions made this year.
expert_all_time_total_correctintegerExpert's correct predictions all-time.
expert_all_time_total_madeintegerExpert's total predictions made all-time.
prediction_page_urlcharacter247sports.com path to the prediction detail.

Row type: Sports247Sports247TargetPredictionsRow (exported from the package root).

Returns — sports247_teams / sports247Teams​

col_nametypedescription
namecharacterTeam display name (school + nickname).
team_idinteger247Sports RDB team id (per-sport).
institution_keyinteger247Sports institution key (school-level, sport-agnostic).
conferencecharacterFull name of the athletic conference the team competes in (e.g. ACC, Big Ten).
conference_abbreviationcharacterConference abbreviation.
sportcharacterSport name (Football, Basketball, ...).
typecharacterInstitution type (College, ...).

Row type: Sports247Sports247TeamsRow (exported from the package root).

Returns — sports247_transfer_portal_player_feed / sports247TransferPortalPlayerFeed​

col_nametypedescription
keyinteger247Sports player key.
target_institutioncharacterName of the program the player is targeting / committed to.
target_institution_keycharacter247Sports institution key of the target program.
full_namecharacterFull name of the transfer player.
position_abbrcharacterPosition abbreviation.
current_institutioncharacterName of the player's current program.
current_institution_keyinteger247Sports institution key of the current program.
current_institution_state_abbreviationcharacterState abbreviation of the current program.
current_institution_citycharacterCity of the current program.
first_namecharacterGiven name of the transfer player.
last_namecharacterFamily (surname) of the transfer player.
state_abbreviationcharacterPlayer's state abbreviation.
player_imagecharacterCDN URL of the player's headshot.
star_ratinginteger247Sports star rating (2-5).
group_rankintegerRank within the transfer position group.
position_rankintegerRank at the player's position among transfers.
state_rankintegerRank within the player's state.
formatted_heightcharacterHeight as a formatted string.
weightdoubleWeight in pounds.

Row type: Sports247Sports247TransferPortalPlayerFeedRow (exported from the package root).

Returns — sports247_transfer_portal_team_feed / sports247TransferPortalTeamFeed​

col_nametypedescription
namecharacterDisplay name of the program.
keyinteger247Sports institution/team key.
logocharacterCDN URL of the program's logo.
alternate_logocharacterCDN URL of the program's alternate logo.
positionintegerRank in the transfer-portal team class.
number_of_transfersintegerNumber of incoming transfers in the class.
transfer_pointsdoubleTotal transfer-portal class rating points.

Row type: Sports247Sports247TransferPortalTeamFeedRow (exported from the package root).

Returns — sports247_transfers / sports247Transfers​

col_nametypedescription
player_keyinteger247Sports player key of the transfer.
player_first_namecharacterGiven name of the transfer player.
player_last_namecharacterFamily (surname) of the transfer player.
player_avatarcharacterCDN URL of the transfer's headshot.
player_transfer_datecharacterTimestamp the player entered the transfer portal.
player_transfer_ratingdouble247Sports transfer rating.
player_high_school_ratingdoubleThe player's original high-school recruiting rating.
player_ratingdouble247Sports current rating.
player_star_ratingdouble247Sports star rating (2-5).
player_transfer_rankdoubleNational rank among transfers.
player_high_school_rankdoubleThe player's original high-school national rank.
player_rankdouble247Sports current national rank.
player_rank_trenddoubleChange in rank since the previous update.
player_institution_statuscharacterTransfer status relative to institutions (e.g. Entered, Committed).
player_positioncharacterPosition abbreviation.
player_position_keyinteger247Sports position key.
player_eligibility_typecharacterEligibility classification (e.g. Grad, Underclassman).
player_eligibility_yearsdoubleYears of eligibility remaining.
player_state_rankdoubleRank within the player's state.
player_statuscharacterPortal status label.
player_status_datecharacterTimestamp of the latest status change.
player_transfer_source_institutioncharacterName of the program the player is transferring from.
player_transfer_source_institution_keyinteger247Sports institution key of the source program.
player_transfer_source_logocharacterCDN URL of the source program's logo.
player_transfer_source_default_assetcharacterCDN URL of the source program's default logo asset.
player_transfer_source_alternate_assetcharacterCDN URL of the source program's alternate logo asset.
player_transfer_source_light_assetcharacterCDN URL of the source program's light-background logo asset.
player_transfer_source_institution_root_pathcharacter247sports.com root path of the source program's team site.
player_transfer_destinationcharacterName of the program the player is transferring to (null if uncommitted).
player_position_group_keyinteger247Sports position-group key.
player_position_group_namecharacterPosition-group name (e.g. Quarterback).
player_position_rankdoubleRank at the player's position among transfers.
player_last_update_datecharacterTimestamp of the last record update.
player_transfer_commit_date_timecharacterTimestamp of the transfer commitment (null if uncommitted).
player_weightintegerWeight in pounds.
player_heightcharacterHeight as a formatted string.
player_player_profile_urlcharacter247sports.com path to the player's profile.
player_start_datecharacterStart date of the transfer window record.
player_end_datecharacterEnd date of the transfer window record.

Row type: Sports247Sports247TransfersRow (exported from the package root).

Native API — 247Sports site pages​

Flat (non-ESPN) wrappers for the 247sports.com *.json page models. Host: https://247sports.com. Each method is exposed under BOTH its snake_case name sports247_site_pages_<endpoint> (sdv-py's name, py/R parity) and its camelCase form (canonical) on sdv.sports247. Pass { parsed: true } to run the payload through its tidy.js parser; omit it for the raw response. No auth. Transport: browser-impersonating (npm install impit), as for sports247. Nested entities arrive as bare integer keys — walk each through its own .json route.

MethodHTTPPath paramsQuery paramsParserAuth
sports247_site_pages_coach / sports247SitePagesCoachhttps://247sports.com/Coach/{key}.jsonkey*—parse_sports247_site_page—
sports247_site_pages_coach_alma_mater / sports247SitePagesCoachAlmaMaterhttps://247sports.com/Coach/{key}/AlmaMater.jsonkey*—parse_sports247_site_page—
sports247_site_pages_coach_hometown / sports247SitePagesCoachHometownhttps://247sports.com/Coach/{key}/Hometown.jsonkey*—parse_sports247_site_page—
sports247_site_pages_coach_ranking / sports247SitePagesCoachRankinghttps://247sports.com/CoachRanking/{key}.jsonkey*—parse_sports247_site_page—
sports247_site_pages_coach_rankings / sports247SitePagesCoachRankingshttps://247sports.com/Coach/{key}/CoachRankings.jsonkey*—parse_sports247_site_page—
sports247_site_pages_event / sports247SitePagesEventhttps://247sports.com/Event/{slug}.jsonslug*—parse_sports247_site_page—
sports247_site_pages_institution / sports247SitePagesInstitutionhttps://247sports.com/Institution/{key}.jsonkey*—parse_sports247_site_page—
sports247_site_pages_institution_list / sports247SitePagesInstitutionListhttps://247sports.com/Institution.json—itemsparse_sports247_site_page—
sports247_site_pages_institution_location / sports247SitePagesInstitutionLocationhttps://247sports.com/Institution/{key}/Location.jsonkey*—parse_sports247_site_page—
sports247_site_pages_institution_timeline_events / sports247SitePagesInstitutionTimelineEventshttps://247sports.com/college/{school_slug}/Institution/{key}/TimelineEvents.jsonschool_slug*, key*—parse_sports247_site_page—
sports247_site_pages_league_draft_picks / sports247SitePagesLeagueDraftPickshttps://247sports.com/League/{league_slug}/DraftPicks/ConfigureEmbed/.jsonleague_slug*year, roundparse_sports247_site_page—
sports247_site_pages_league_institutions / sports247SitePagesLeagueInstitutionshttps://247sports.com/League/{league_id}/Institutions.jsonleague_id*itemsparse_sports247_site_page—
sports247_site_pages_page_feeds / sports247SitePagesPageFeedshttps://247sports.com/Page/{page_id}/Feeds.jsonpage_id*—parse_sports247_site_page—
sports247_site_pages_player / sports247SitePagesPlayerhttps://247sports.com/Player/{key}.jsonkey*—parse_sports247_site_page—
sports247_site_pages_player_current_institution / sports247SitePagesPlayerCurrentInstitutionhttps://247sports.com/Player/{key}/CurrentPlayerInstitution.jsonkey*—parse_sports247_site_page—
sports247_site_pages_player_high_school / sports247SitePagesPlayerHighSchoolhttps://247sports.com/Player/{key}/PlayerHighSchool.jsonkey*—parse_sports247_site_page—
sports247_site_pages_player_institution / sports247SitePagesPlayerInstitutionhttps://247sports.com/PlayerInstitution/{key}.jsonkey*—parse_sports247_site_page—
sports247_site_pages_player_institution_evaluation / sports247SitePagesPlayerInstitutionEvaluationhttps://247sports.com/PlayerInstitutionEvaluation/{key}.jsonkey*—parse_sports247_site_page—
sports247_site_pages_player_primary_sport / sports247SitePagesPlayerPrimarySporthttps://247sports.com/Player/{key}/PrimaryPlayerSport.jsonkey*—parse_sports247_site_page—
sports247_site_pages_player_search / sports247SitePagesPlayerSearchhttps://247sports.com/Player.json—first_name → FirstName, last_name → LastNameparse_sports247_site_page—
sports247_site_pages_playersport / sports247SitePagesPlayersporthttps://247sports.com/playersport/{key}.jsonkey*—parse_sports247_site_page—
sports247_site_pages_playersport_institution / sports247SitePagesPlayersportInstitutionhttps://247sports.com/PlayerSport/{key}/PlayerInstitution.jsonkey*—parse_sports247_site_page—
sports247_site_pages_playersport_rank_history / sports247SitePagesPlayersportRankHistoryhttps://247sports.com/PlayerSport/{key}/RecruitRankHistory.jsonkey*—parse_sports247_site_page—
sports247_site_pages_position_rankings / sports247SitePagesPositionRankingshttps://247sports.com/Position/{key}/playersportrankings.jsonkey*—parse_sports247_site_page—
sports247_site_pages_recruit_interest / sports247SitePagesRecruitInteresthttps://247sports.com/RecruitInterest/{key}.jsonkey*—parse_sports247_site_page—
sports247_site_pages_recruitment_final_choice / sports247SitePagesRecruitmentFinalChoicehttps://247sports.com/Recruitment/{key}/FinalChoice.jsonkey*—parse_sports247_site_page—
sports247_site_pages_recruitment_institution / sports247SitePagesRecruitmentInstitutionhttps://247sports.com/Recruitment/{key}/Institution.jsonkey*—parse_sports247_site_page—
sports247_site_pages_recruitment_interests / sports247SitePagesRecruitmentInterestshttps://247sports.com/Recruitment/{key}/Interests.jsonkey*—parse_sports247_site_page—
sports247_site_pages_recruitment_offers / sports247SitePagesRecruitmentOffershttps://247sports.com/Recruitment/{key}/Offers.jsonkey*—parse_sports247_site_page—
sports247_site_pages_recruitment_player_sport / sports247SitePagesRecruitmentPlayerSporthttps://247sports.com/Recruitment/{key}/PlayerSport.jsonkey*—parse_sports247_site_page—
sports247_site_pages_season_current_expert_predictions / sports247SitePagesSeasonCurrentExpertPredictionshttps://247sports.com/Season/{season}/CurrentExpertPredictions.jsonseason*—parse_sports247_site_page—
sports247_site_pages_season_recruit_interest_events / sports247SitePagesSeasonRecruitInterestEventshttps://247sports.com/Season/{season}/RecruitInterestEvents.jsonseason*—parse_sports247_site_page—
sports247_site_pages_season_recruit_interests / sports247SitePagesSeasonRecruitInterestshttps://247sports.com/Season/{season}/RecruitInterests.jsonseason*—parse_sports247_site_page—
sports247_site_pages_season_recruits / sports247SitePagesSeasonRecruitshttps://247sports.com/Season/{season}/Recruits.jsonseason*items → Items, page → Page, player_full_name → Player.FullName, institution → Institutionparse_sports247_site_page—
sports247_site_pages_season_roster_embed / sports247SitePagesSeasonRosterEmbedhttps://247sports.com/Season/{season}/Roster/Embed.jsonseason*—parse_sports247_site_page—

Returns — sports247_site_pages_coach / sports247SitePagesCoach​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
first_namecharacter
last_namecharacter
full_namecharacter
birthdatecharacter
hometowninteger
alma_materintegerSchool the coach graduated from, per 247Sports.
cbs_keyintegerCBS Sports identifier for the coach (247Sports is a CBS Sports property).
twitter_contactcharacterCoach's Twitter/X handle on the 247Sports profile.
predictions_lockedcharacter247Sports flag that Crystal Ball prediction entries tied to the coach are locked.
primary_coach_jobintegerNested 247Sports record for the coach's current job (stringified).
default_assetintegerNested 247Sports image asset for the coach's headshot (stringified).
hero_assetcharacterNested 247Sports hero (banner) image asset for the coach page (stringified).
quote_assetcharacterNested 247Sports image asset used alongside the coach's quote block (stringified).
default_namecharacterServer-rendered display label for the entity.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_coach_alma_mater / sports247SitePagesCoachAlmaMater​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
namecharacter
typecharacterInstitution type code (college / pro / high school).
groupcharacterInstitution group (division/level) bitmask code.
locationintegerFK -> Location (/Institution/\{Location\}/Location.json).
stateintegerFK -> State entity.
latitudenumeric
longitudenumeric
rankablecharacterWhether the institution participates in class rankings.
mascotcharacter
abbreviationcharacter
primary_colorcharacter
secondary_colorcharacter
is_foreigncharacterWhether the institution is located outside the United States.
siteintegerFK -> team Site (network site key).
default_assetnumericNested 247Sports image asset for the institution's primary logo (stringified).
alternate_assetnumericNested 247Sports image asset for the institution's alternate logo (stringified).
light_assetnumericNested 247Sports image asset for the light-background logo variant (stringified).
default_namecharacterServer-rendered display label for the entity.
addresscharacterInstitution's street address.
telephonecharacterInstitution's telephone number.
websitecharacterInstitution's website URL.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_coach_hometown / sports247SitePagesCoachHometown​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
postal_codecharacter
citycharacter
stateintegerU.S. state of the location record, per 247Sports.
latitudenumeric
longitudenumeric
county_tax_ratenumericCounty income-tax rate for the location, carried on the 247Sports location record.
city_tax_ratenumericCity income-tax rate for the location, carried on the 247Sports location record.
special_tax_ratenumericSpecial-district tax rate for the location, carried on the 247Sports location record.
region_namecharacterName of the region (state/province) for the location.
default_namecharacterServer-rendered display label for the entity.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_coach_ranking / sports247SitePagesCoachRanking​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
coachinteger
institutionintegerNested 247Sports institution the coach recruited for during the ranking cycle (stringified).
conferenceinteger
rankingintegerFK -> the Ranking snapshot this row belongs to.
sportintegerNested 247Sports sport the ranking covers (stringified).
recruitmentcharacterNested 247Sports recruitment record credited to the coach on this row (stringified).
ratingnumericOverall rating score for the coach's recruiting haul in the 247Sports coach ranking.
scout_ratingnumericTotal 247Sports in-house (scout) rating points credited to the coach's commits.
composite_ratingnumericComposite class rating for the coach's haul.
commitsintegerNumber of commits credited to the coach in the ranking.
totalintegerTotal ranking score for the coach's class, as reported by 247Sports.
composite_totalintegerTotal 247Sports Composite rating points credited to the coach's commits.
five_starsintegerNumber of five-star commits credited to the coach.
scout_five_starsintegerNumber of five-star commits by 247Sports' own (scout) rating.
composite_five_starsintegerNumber of five-star commits by the 247Sports Composite rating.
four_starsintegerNumber of four-star commits credited to the coach.
scout_four_starsintegerNumber of four-star commits by 247Sports' own (scout) rating.
composite_four_starsintegerNumber of four-star commits by the 247Sports Composite rating.
three_starsintegerNumber of three-star commits credited to the coach.
scout_three_starsintegerNumber of three-star commits by 247Sports' own (scout) rating.
composite_three_starsintegerNumber of three-star commits by the 247Sports Composite rating.
two_starsintegerNumber of two-star commits credited to the coach.
scout_two_starsintegerNumber of two-star commits by 247Sports' own (scout) rating.
composite_two_starsintegerNumber of two-star commits by the 247Sports Composite rating.
average_ratingnumericAverage rating across the coach's credited commits.
average_scout_ratingintegerAverage 247Sports in-house (scout) rating across the credited commits.
composite_average_ratingnumericAverage 247Sports Composite rating across the credited commits.
overall_rankintegerOverall national coach-recruiting rank.
composite_overall_rankintegerCoach's national recruiter rank by Composite points.
scout_overall_rankintegerCoach's national recruiter rank by 247Sports' own (scout) points.
division_rankintegerCoach's recruiter rank within the division.
scout_division_rankintegerCoach's division recruiter rank by 247Sports' own (scout) points.
composite_division_rankintegerCoach's division recruiter rank by Composite points.
conference_rankintegerRank within conference.
scout_conference_rankintegerCoach's conference recruiter rank by 247Sports' own (scout) points.
composite_conference_rankintegerCoach's conference recruiter rank by Composite points.
previous_coach_rankingnumericNested prior-cycle recruiter-ranking row for the coach (stringified).
default_nameintegerServer-rendered display label for the entity.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_coach_rankings / sports247SitePagesCoachRankings​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
coachinteger
institutionintegerNested 247Sports institution the coach recruited for during the ranking cycle (stringified).
conferenceinteger
rankingintegerFK -> the Ranking snapshot this row belongs to.
sportintegerNested 247Sports sport the ranking covers (stringified).
recruitmentcharacterNested 247Sports recruitment record credited to the coach on this row (stringified).
ratingnumericOverall rating score for the coach's recruiting haul in the 247Sports coach ranking.
scout_ratingnumericTotal 247Sports in-house (scout) rating points credited to the coach's commits.
composite_ratingnumericComposite class rating for the coach's haul.
commitsintegerNumber of commits credited to the coach in the ranking.
totalintegerTotal ranking score for the coach's class, as reported by 247Sports.
composite_totalintegerTotal 247Sports Composite rating points credited to the coach's commits.
five_starsintegerNumber of five-star commits credited to the coach.
scout_five_starsintegerNumber of five-star commits by 247Sports' own (scout) rating.
composite_five_starsintegerNumber of five-star commits by the 247Sports Composite rating.
four_starsintegerNumber of four-star commits credited to the coach.
scout_four_starsintegerNumber of four-star commits by 247Sports' own (scout) rating.
composite_four_starsintegerNumber of four-star commits by the 247Sports Composite rating.
three_starsintegerNumber of three-star commits credited to the coach.
scout_three_starsintegerNumber of three-star commits by 247Sports' own (scout) rating.
composite_three_starsintegerNumber of three-star commits by the 247Sports Composite rating.
two_starsintegerNumber of two-star commits credited to the coach.
scout_two_starsintegerNumber of two-star commits by 247Sports' own (scout) rating.
composite_two_starsintegerNumber of two-star commits by the 247Sports Composite rating.
average_ratingnumericAverage rating across the coach's credited commits.
average_scout_ratingintegerAverage 247Sports in-house (scout) rating across the credited commits.
composite_average_ratingnumericAverage 247Sports Composite rating across the credited commits.
overall_rankintegerOverall national coach-recruiting rank.
composite_overall_rankintegerCoach's national recruiter rank by Composite points.
scout_overall_rankintegerCoach's national recruiter rank by 247Sports' own (scout) points.
division_rankintegerCoach's recruiter rank within the division.
scout_division_rankintegerCoach's division recruiter rank by 247Sports' own (scout) points.
composite_division_rankintegerCoach's division recruiter rank by Composite points.
conference_rankintegerRank within conference.
scout_conference_rankintegerCoach's conference recruiter rank by 247Sports' own (scout) points.
composite_conference_rankintegerCoach's conference recruiter rank by Composite points.
previous_coach_rankingnumericNested prior-cycle recruiter-ranking row for the coach (stringified).
default_nameintegerServer-rendered display label for the entity.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_event / sports247SitePagesEvent​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
namecharacter
event_groupintegerGrouping or series the event belongs to (e.g. a camp circuit) on 247Sports.
event_typeintegerNumeric code for the kind of 247Sports recruiting event on this row.
event_datecharacter
default_assetintegerNested 247Sports image asset for the event (stringified).
primary_colorcharacter
yearinteger
default_namecharacterServer-rendered display label for the entity.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_institution / sports247SitePagesInstitution​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
namecharacter
typecharacterInstitution type code (college / pro / high school).
groupcharacterInstitution group (division/level) bitmask code.
locationintegerFK -> Location (/Institution/\{Location\}/Location.json).
stateintegerFK -> State entity.
latitudenumeric
longitudenumeric
rankablecharacterWhether the institution participates in class rankings.
mascotcharacter
abbreviationcharacter
primary_colorcharacter
secondary_colorcharacter
is_foreigncharacterWhether the institution is located outside the United States.
siteintegerFK -> team Site (network site key).
default_assetnumericNested 247Sports image asset for the institution's primary logo (stringified).
alternate_assetnumericNested 247Sports image asset for the institution's alternate logo (stringified).
light_assetnumericNested 247Sports image asset for the light-background logo variant (stringified).
default_namecharacterServer-rendered display label for the entity.
addresscharacterInstitution's street address.
telephonecharacterInstitution's telephone number.
websitecharacterInstitution's website URL.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_institution_list / sports247SitePagesInstitutionList​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
namecharacter
typecharacterInstitution type code (college / pro / high school).
groupcharacterInstitution group (division/level) bitmask code.
locationintegerFK -> Location (/Institution/\{Location\}/Location.json).
stateintegerFK -> State entity.
latitudenumeric
longitudenumeric
rankablecharacterWhether the institution participates in class rankings.
mascotcharacter
abbreviationcharacter
primary_colorcharacter
secondary_colorcharacter
is_foreigncharacterWhether the institution is located outside the United States.
siteintegerFK -> team Site (network site key).
default_assetnumericNested 247Sports image asset for the institution's primary logo (stringified).
alternate_assetnumericNested 247Sports image asset for the institution's alternate logo (stringified).
light_assetnumericNested 247Sports image asset for the light-background logo variant (stringified).
default_namecharacterServer-rendered display label for the entity.
addresscharacterInstitution's street address.
telephonecharacterInstitution's telephone number.
websitecharacterInstitution's website URL.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_institution_location / sports247SitePagesInstitutionLocation​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
postal_codecharacter
citycharacter
stateintegerU.S. state of the location record, per 247Sports.
latitudenumeric
longitudenumeric
county_tax_ratenumericCounty income-tax rate for the location, carried on the 247Sports location record.
city_tax_ratenumericCity income-tax rate for the location, carried on the 247Sports location record.
special_tax_ratenumericSpecial-district tax rate for the location, carried on the 247Sports location record.
region_namecharacterName of the region (state/province) for the location.
default_namecharacterServer-rendered display label for the entity.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_institution_timeline_events / sports247SitePagesInstitutionTimelineEvents​

col_nametypedescription
bodycharacterText body of the timeline entry.
datecharacterDate of the institution timeline entry, per 247Sports.
author_first_namecharacterFirst name of the entry's author.
author_last_namecharacterLast name of the entry's author.
author_affiliationcharacterOutlet or site the author writes for, per 247Sports.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_league_draft_picks / sports247SitePagesLeagueDraftPicks​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
pro_teamintegerNested 247Sports record for the professional team that made the pick (stringified).
pro_team_namecharacterName of the professional team that made the pick.
yearinteger
roundintegerDraft round number (1-based) the pick belongs to.
pickintegerPick number within the round.
overall_pickintegerOverall selection number in the draft.
playerinteger
player_first_namecharacter
player_last_namecharacter
college_teaminteger
college_team_namecharacterName of the college the player was drafted out of.
position_abbreviationcharacterPlayer's position at draft.
traded_from_teamcharacterTeam the pick was traded from, when it changed hands.
pick_typecharacterType of the selection (e.g. regular, compensatory, supplemental).
leagueinteger
mockcharacterWhether this is a mock-draft projection vs an actual pick.
default_nameintegerServer-rendered display label for the entity.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_league_institutions / sports247SitePagesLeagueInstitutions​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
namecharacter
typecharacterInstitution type code (college / pro / high school).
groupcharacterInstitution group (division/level) bitmask code.
locationintegerFK -> Location (/Institution/\{Location\}/Location.json).
stateintegerFK -> State entity.
latitudenumeric
longitudenumeric
rankablecharacterWhether the institution participates in class rankings.
mascotcharacter
abbreviationcharacter
primary_colorcharacter
secondary_colorcharacter
is_foreigncharacterWhether the institution is located outside the United States.
siteintegerFK -> team Site (network site key).
default_assetnumericNested 247Sports image asset for the institution's primary logo (stringified).
alternate_assetnumericNested 247Sports image asset for the institution's alternate logo (stringified).
light_assetnumericNested 247Sports image asset for the light-background logo variant (stringified).
default_namecharacterServer-rendered display label for the entity.
addresscharacterInstitution's street address.
telephonecharacterInstitution's telephone number.
websitecharacterInstitution's website URL.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_page_feeds / sports247SitePagesPageFeeds​

col_nametypedescription
uidcharacter
update_datecharacterDate the feed item was published or updated.
title_textcharacterHeadline text of the feed item.
main_textcharacterBody text of the feed item.
redirection_urlcharacterURL the feed item links out to.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_player / sports247SitePagesPlayer​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
first_namecharacter
last_namecharacter
full_namecharacter
heightcharacter
weightnumeric
biocharacterPlayer biography text authored on 247Sports.
scout_evaluationcharacter247Sports scouting evaluation text for the player.
birthdatecharacter
modified_usercharacter247Sports user who last modified the player record.
modified_datecharacterDate the player record was last modified.
cbs_keyintegerCross-reference key into the CBS Sports id space.
urlcharacter
last_recruitment_player_institutionintegerNested player-institution record from the player's most recent recruitment (stringified).
current_player_institutionintegerFK -> PlayerInstitution (current school).
twitter_contactintegerNested 247Sports contact record for the player's Twitter/X account (stringified).
mobile_phone_contactcharacterPlayer's mobile phone contact field on the 247Sports record.
primary_player_sportintegerFK -> PlayerSport (/PlayerSport/\{id\}.json).
primary_recruitmentintegerNested 247Sports record for the player's primary recruitment (stringified).
default_namecharacterServer-rendered display label for the entity.
default_assetintegerNested 247Sports image asset for the player's headshot (stringified).
default_asset_urlcharacterURL of the player's headshot image.
hero_assetcharacterNested 247Sports hero (banner) image asset for the player page (stringified).
quote_assetcharacterNested 247Sports image asset used alongside the player's quote block (stringified).
usercharacter247Sports user account linked to the player profile (nested, stringified).
pro_stat_playerintegerReference tying the profile to a professional stats player record (247Sports field).
college_stat_playerintegerReference tying the profile to a college stats player record (247Sports field).
bio_or_defaultcharacterPlayer bio text, falling back to a default blurb when none is authored.
ratinginteger247Sports numeric rating (0-1 scale) for the primary sport.
star_ratingintegerStar tier (2-5) derived from the rating.
national_rankintegerOverall national rank in the recruit's class.
position_rankintegerRank within position for the class.
state_rankintegerRank within home state for the class.
hometown_statecharacter
hometown_citycharacter
player_high_school_namecharacterName of the player's high school.
primary_player_position_abbreviationcharacterAbbreviation of the player's primary position.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_player_current_institution / sports247SitePagesPlayerCurrentInstitution​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
playerinteger
institutionintegerNested 247Sports institution for the stint (stringified).
stateintegerNested 247Sports state record for the institution's location (stringified).
agentcharacter
end_yearinteger
end_datecharacter
early_enrolleecharacterWhether the player enrolled early at the institution.
early_signeecharacterWhether the player signed in the early signing period.
heightnumeric
weightnumeric
transfer_institutioncharacterNested institution involved in the player's transfer, for transfer-portal stints (stringified).
transfer_seasoncharacterSeason of the player's transfer, when applicable.
transfer_eligibilitycharacterPlayer's eligibility status for the transfer, per 247Sports.
created_datecharacterDate the player-institution record was created.
modified_datecharacterDate the player-institution record was last modified.
lead_expertinteger247Sports expert assigned as the lead on the recruitment (nested, stringified).
player_institution_evaluationintegerNested 247Sports evaluation attached to this player-institution stint (stringified).
primary_player_sportintegerNested 247Sports player-sport profile the stint belongs to (stringified).
default_assetintegerNested 247Sports image asset for the stint (stringified).
hero_assetcharacterNested 247Sports hero (banner) image asset for the stint (stringified).
primary_recruitmentintegerNested 247Sports record for the recruitment behind the stint (stringified).
default_namecharacterServer-rendered display label for the entity.
end_year_or_currentintegerStint's end year, or the current year for an active stint.
start_year_or_expectedintegerStint's start year, or the expected start year for a future stint.
end_year_or_expectedintegerStint's end year, or the expected end year for an active stint.
next_institution_typecharacterLevel of the player's next institution (e.g. college, professional), per 247Sports.
next_institution_groupcharacterGrouping (e.g. conference/division) of the player's next institution, per 247Sports.
start_yearinteger
start_datecharacter

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_player_high_school / sports247SitePagesPlayerHighSchool​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
playerinteger
institutionintegerNested 247Sports institution for the stint (stringified).
stateintegerNested 247Sports state record for the institution's location (stringified).
agentcharacter
end_yearinteger
end_datecharacter
early_enrolleecharacterWhether the player enrolled early at the institution.
early_signeecharacterWhether the player signed in the early signing period.
heightnumeric
weightnumeric
transfer_institutioncharacterNested institution involved in the player's transfer, for transfer-portal stints (stringified).
transfer_seasoncharacterSeason of the player's transfer, when applicable.
transfer_eligibilitycharacterPlayer's eligibility status for the transfer, per 247Sports.
created_datecharacterDate the player-institution record was created.
modified_datecharacterDate the player-institution record was last modified.
lead_expertinteger247Sports expert assigned as the lead on the recruitment (nested, stringified).
player_institution_evaluationintegerNested 247Sports evaluation attached to this player-institution stint (stringified).
primary_player_sportintegerNested 247Sports player-sport profile the stint belongs to (stringified).
default_assetintegerNested 247Sports image asset for the stint (stringified).
hero_assetcharacterNested 247Sports hero (banner) image asset for the stint (stringified).
primary_recruitmentintegerNested 247Sports record for the recruitment behind the stint (stringified).
default_namecharacterServer-rendered display label for the entity.
end_year_or_currentintegerStint's end year, or the current year for an active stint.
start_year_or_expectedintegerStint's start year, or the expected start year for a future stint.
end_year_or_expectedintegerStint's end year, or the expected end year for an active stint.
next_institution_typecharacterLevel of the player's next institution (e.g. college, professional), per 247Sports.
next_institution_groupcharacterGrouping (e.g. conference/division) of the player's next institution, per 247Sports.
start_yearinteger
start_datecharacter

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_player_institution / sports247SitePagesPlayerInstitution​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
playerinteger
institutionintegerNested 247Sports institution for the stint (stringified).
stateintegerNested 247Sports state record for the institution's location (stringified).
agentcharacter
end_yearinteger
end_datecharacter
early_enrolleecharacterWhether the player enrolled early at the institution.
early_signeecharacterWhether the player signed in the early signing period.
heightnumeric
weightnumeric
transfer_institutioncharacterNested institution involved in the player's transfer, for transfer-portal stints (stringified).
transfer_seasoncharacterSeason of the player's transfer, when applicable.
transfer_eligibilitycharacterPlayer's eligibility status for the transfer, per 247Sports.
created_datecharacterDate the player-institution record was created.
modified_datecharacterDate the player-institution record was last modified.
lead_expertinteger247Sports expert assigned as the lead on the recruitment (nested, stringified).
player_institution_evaluationintegerNested 247Sports evaluation attached to this player-institution stint (stringified).
primary_player_sportintegerNested 247Sports player-sport profile the stint belongs to (stringified).
default_assetintegerNested 247Sports image asset for the stint (stringified).
hero_assetcharacterNested 247Sports hero (banner) image asset for the stint (stringified).
primary_recruitmentintegerNested 247Sports record for the recruitment behind the stint (stringified).
default_namecharacterServer-rendered display label for the entity.
end_year_or_currentintegerStint's end year, or the current year for an active stint.
start_year_or_expectedintegerStint's start year, or the expected start year for a future stint.
end_year_or_expectedintegerStint's end year, or the expected end year for an active stint.
next_institution_typecharacterLevel of the player's next institution (e.g. college, professional), per 247Sports.
next_institution_groupcharacterGrouping (e.g. conference/division) of the player's next institution, per 247Sports.
start_yearinteger
start_datecharacter

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_player_institution_evaluation / sports247SitePagesPlayerInstitutionEvaluation​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
player_institutionintegerNested player-institution stint the evaluation is attached to (stringified).
userinteger247Sports user account of the evaluator (nested, stringified).
evaluated_datecharacterDate the evaluation was written.
comparison_playerintegerEstablished player the evaluator compares the prospect to.
projectioncharacterEvaluator's projection for the player (e.g. draft round or college level).
primarycharacterWhether this is the primary (featured) evaluation for the stint.
scout_evaluationcharacterFull text of the 247Sports scouting evaluation.
eventcharacter
default_nameintegerServer-rendered display label for the entity.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_player_primary_sport / sports247SitePagesPlayerPrimarySport​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
playerinteger
player_institutionintegerNested player-institution stint the player-sport profile points to (stringified).
stateintegerHome state of the recruit, per 247Sports.
sportintegerNested 247Sports sport for the profile (stringified).
ratinginteger247Sports rating string (0-1).
rating_or_defaultinteger247Sports in-house rating, falling back to a default value when unrated.
local_indexinteger247Sports' own industry-index value for the player, alongside the Rivals and ESPN indexes.
rivals_gradenumericRivals source grade (industry composite input).
rivals_rankintegerPlayer's rank in the Rivals industry ranking, as tracked by 247Sports.
rivals_indexnumericRivals index value for the player, as tracked by 247Sports.
espn_gradeintegerESPN source grade (industry composite input).
espn_rankintegerPlayer's rank in the ESPN industry ranking, as tracked by 247Sports.
espn_indexnumericESPN index value for the player, as tracked by 247Sports.
composite_strengthintegerComposite strength points (team-ranking weight).
composite_ratingnumeric247Sports Composite rating (industry blend).
composite_rating_or_defaultnumeric247Sports Composite rating, falling back to a default value when unrated.
average_ranknumericPlayer's average rank across the tracked industry services.
previous_recruitmentintegerNested record for the player's previous recruitment (stringified).
primarycharacterWhether this is the player's primary sport.
class_year_overridecharacterOverride of the player's recruiting class year, when 247Sports reassigns it.
class_yearcharacterRecruiting class year.
recruitmentintegerFK -> Recruitment aggregate for this player-sport.
primary_institution_predictionnumericNested leading Crystal Ball institution prediction for the player (stringified).
secondary_institution_predictionintegerNested second-place Crystal Ball institution prediction (stringified).
primary_institution_prediction_percentagenumericShare of Crystal Ball predictions favoring the leading institution.
show_unranked_ratingcharacter247Sports display flag to show the rating even while the player is unranked.
current_player_sport_yearnumericCurrent ranking-cycle year for the player-sport profile.
unpublished_player_sport_rankingnumericNested not-yet-published ranking row for the player (stringified).
current_player_sport_rankingnumericNested current published ranking row for the player (stringified).
primary_player_positionintegerNested 247Sports record for the player's primary position (stringified).
primary_positionintegerPlayer's primary position on the 247Sports profile.
primary_position_groupintegerPosition group the player's primary position belongs to.
default_namecharacterServer-rendered display label for the entity.
star_ratingintegerStar tier (2-5).
secondary_institution_prediction_percentagenumericShare of Crystal Ball predictions favoring the second-place institution.
jerseycharacter

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_player_search / sports247SitePagesPlayerSearch​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
first_namecharacter
last_namecharacter
full_namecharacter
heightcharacter
weightnumeric
biocharacterPlayer biography text authored on 247Sports.
scout_evaluationcharacter247Sports scouting evaluation text for the player.
birthdatecharacter
modified_usercharacter247Sports user who last modified the player record.
modified_datecharacterDate the player record was last modified.
cbs_keyintegerCross-reference key into the CBS Sports id space.
urlcharacter
last_recruitment_player_institutionintegerNested player-institution record from the player's most recent recruitment (stringified).
current_player_institutionintegerFK -> PlayerInstitution (current school).
twitter_contactintegerNested 247Sports contact record for the player's Twitter/X account (stringified).
mobile_phone_contactcharacterPlayer's mobile phone contact field on the 247Sports record.
primary_player_sportintegerFK -> PlayerSport (/PlayerSport/\{id\}.json).
primary_recruitmentintegerNested 247Sports record for the player's primary recruitment (stringified).
default_namecharacterServer-rendered display label for the entity.
default_assetintegerNested 247Sports image asset for the player's headshot (stringified).
default_asset_urlcharacterURL of the player's headshot image.
hero_assetcharacterNested 247Sports hero (banner) image asset for the player page (stringified).
quote_assetcharacterNested 247Sports image asset used alongside the player's quote block (stringified).
usercharacter247Sports user account linked to the player profile (nested, stringified).
pro_stat_playerintegerReference tying the profile to a professional stats player record (247Sports field).
college_stat_playerintegerReference tying the profile to a college stats player record (247Sports field).
bio_or_defaultcharacterPlayer bio text, falling back to a default blurb when none is authored.
ratinginteger247Sports numeric rating (0-1 scale) for the primary sport.
star_ratingintegerStar tier (2-5) derived from the rating.
national_rankintegerOverall national rank in the recruit's class.
position_rankintegerRank within position for the class.
state_rankintegerRank within home state for the class.
hometown_statecharacter
hometown_citycharacter
player_high_school_namecharacterName of the player's high school.
primary_player_position_abbreviationcharacterAbbreviation of the player's primary position.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_playersport / sports247SitePagesPlayersport​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
playerinteger
player_institutionintegerNested player-institution stint the player-sport profile points to (stringified).
stateintegerHome state of the recruit, per 247Sports.
sportintegerNested 247Sports sport for the profile (stringified).
ratinginteger247Sports rating string (0-1).
rating_or_defaultinteger247Sports in-house rating, falling back to a default value when unrated.
local_indexinteger247Sports' own industry-index value for the player, alongside the Rivals and ESPN indexes.
rivals_gradenumericRivals source grade (industry composite input).
rivals_rankintegerPlayer's rank in the Rivals industry ranking, as tracked by 247Sports.
rivals_indexnumericRivals index value for the player, as tracked by 247Sports.
espn_gradeintegerESPN source grade (industry composite input).
espn_rankintegerPlayer's rank in the ESPN industry ranking, as tracked by 247Sports.
espn_indexnumericESPN index value for the player, as tracked by 247Sports.
composite_strengthintegerComposite strength points (team-ranking weight).
composite_ratingnumeric247Sports Composite rating (industry blend).
composite_rating_or_defaultnumeric247Sports Composite rating, falling back to a default value when unrated.
average_ranknumericPlayer's average rank across the tracked industry services.
previous_recruitmentintegerNested record for the player's previous recruitment (stringified).
primarycharacterWhether this is the player's primary sport.
class_year_overridecharacterOverride of the player's recruiting class year, when 247Sports reassigns it.
class_yearcharacterRecruiting class year.
recruitmentintegerFK -> Recruitment aggregate for this player-sport.
primary_institution_predictionnumericNested leading Crystal Ball institution prediction for the player (stringified).
secondary_institution_predictionintegerNested second-place Crystal Ball institution prediction (stringified).
primary_institution_prediction_percentagenumericShare of Crystal Ball predictions favoring the leading institution.
show_unranked_ratingcharacter247Sports display flag to show the rating even while the player is unranked.
current_player_sport_yearnumericCurrent ranking-cycle year for the player-sport profile.
unpublished_player_sport_rankingnumericNested not-yet-published ranking row for the player (stringified).
current_player_sport_rankingnumericNested current published ranking row for the player (stringified).
primary_player_positionintegerNested 247Sports record for the player's primary position (stringified).
primary_positionintegerPlayer's primary position on the 247Sports profile.
primary_position_groupintegerPosition group the player's primary position belongs to.
default_namecharacterServer-rendered display label for the entity.
star_ratingintegerStar tier (2-5).
secondary_institution_prediction_percentagenumericShare of Crystal Ball predictions favoring the second-place institution.
jerseycharacter

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_playersport_institution / sports247SitePagesPlayersportInstitution​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
playerinteger
institutionintegerNested 247Sports institution for the stint (stringified).
stateintegerNested 247Sports state record for the institution's location (stringified).
agentcharacter
end_yearinteger
end_datecharacter
early_enrolleecharacterWhether the player enrolled early at the institution.
early_signeecharacterWhether the player signed in the early signing period.
heightnumeric
weightnumeric
transfer_institutioncharacterNested institution involved in the player's transfer, for transfer-portal stints (stringified).
transfer_seasoncharacterSeason of the player's transfer, when applicable.
transfer_eligibilitycharacterPlayer's eligibility status for the transfer, per 247Sports.
created_datecharacterDate the player-institution record was created.
modified_datecharacterDate the player-institution record was last modified.
lead_expertinteger247Sports expert assigned as the lead on the recruitment (nested, stringified).
player_institution_evaluationintegerNested 247Sports evaluation attached to this player-institution stint (stringified).
primary_player_sportintegerNested 247Sports player-sport profile the stint belongs to (stringified).
default_assetintegerNested 247Sports image asset for the stint (stringified).
hero_assetcharacterNested 247Sports hero (banner) image asset for the stint (stringified).
primary_recruitmentintegerNested 247Sports record for the recruitment behind the stint (stringified).
default_namecharacterServer-rendered display label for the entity.
end_year_or_currentintegerStint's end year, or the current year for an active stint.
start_year_or_expectedintegerStint's start year, or the expected start year for a future stint.
end_year_or_expectedintegerStint's end year, or the expected end year for an active stint.
next_institution_typecharacterLevel of the player's next institution (e.g. college, professional), per 247Sports.
next_institution_groupcharacterGrouping (e.g. conference/division) of the player's next institution, per 247Sports.
start_yearinteger
start_datecharacter

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_playersport_rank_history / sports247SitePagesPlayersportRankHistory​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
rankingintegerFK -> Ranking snapshot.
sportintegerNested 247Sports sport the ranking row covers (stringified).
player_sportintegerNested player-sport profile the ranking row belongs to (stringified).
committed_institutionintegerFK -> committed Institution (null if uncommitted).
orderintegerDisplay order of the entry within the 247Sports ranking list.
positioninteger
position_groupinteger
platooninteger247Sports platoon (side-of-ball grouping) identifier on the ranking row.
stateintegerNested 247Sports state record for the recruit's home state (stringified).
regionintegerNested 247Sports region record for the recruit's home region (stringified).
institutionintegerNested institution the player was committed or signed to at ranking time (stringified).
institution_groupcharacterGrouping (e.g. conference/division) of the player's institution, per 247Sports.
ratingintegerNested 247Sports rating record attached to the ranking row (stringified).
composite_strengthinteger247Sports field describing the strength of the industry inputs behind the Composite rating.
composite_ratingnumericPlayer's 247Sports Composite rating, blending the major services' ratings.
overall_rankintegerOverall national rank in the snapshot.
composite_overall_rankintegerPlayer's national rank by 247Sports Composite rating.
group_rankinteger
composite_group_rankintegerPlayer's rank within their position group by Composite rating.
position_rankintegerRank within position.
previous_player_sport_rankingnumericNested prior-cycle ranking row for the player (stringified).
composite_position_rankintegerPlayer's rank at their position by Composite rating.
state_rankintegerRank within home state.
composite_state_rankintegerPlayer's rank within their home state by Composite rating.
default_namecharacterServer-rendered display label for the entity.
position_group_rankintegerPlayer's rank within their position group in the 247Sports ranking.
region_rankinteger

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_position_rankings / sports247SitePagesPositionRankings​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
rankingintegerFK -> Ranking snapshot.
sportintegerNested 247Sports sport the ranking row covers (stringified).
player_sportintegerNested player-sport profile the ranking row belongs to (stringified).
committed_institutionintegerFK -> committed Institution (null if uncommitted).
orderintegerDisplay order of the entry within the 247Sports ranking list.
positioninteger
position_groupinteger
platooninteger247Sports platoon (side-of-ball grouping) identifier on the ranking row.
stateintegerNested 247Sports state record for the recruit's home state (stringified).
regionintegerNested 247Sports region record for the recruit's home region (stringified).
institutionintegerNested institution the player was committed or signed to at ranking time (stringified).
institution_groupcharacterGrouping (e.g. conference/division) of the player's institution, per 247Sports.
ratingintegerNested 247Sports rating record attached to the ranking row (stringified).
composite_strengthinteger247Sports field describing the strength of the industry inputs behind the Composite rating.
composite_ratingnumericPlayer's 247Sports Composite rating, blending the major services' ratings.
overall_rankintegerOverall national rank in the snapshot.
composite_overall_rankintegerPlayer's national rank by 247Sports Composite rating.
group_rankinteger
composite_group_rankintegerPlayer's rank within their position group by Composite rating.
position_rankintegerRank within position.
previous_player_sport_rankingnumericNested prior-cycle ranking row for the player (stringified).
composite_position_rankintegerPlayer's rank at their position by Composite rating.
state_rankintegerRank within home state.
composite_state_rankintegerPlayer's rank within their home state by Composite rating.
default_namecharacterServer-rendered display label for the entity.
position_group_rankintegerPlayer's rank within their position group in the 247Sports ranking.
region_rankinteger

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_recruit_interest / sports247SitePagesRecruitInterest​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
recruitmentintegerFK -> parent Recruitment.
player_sportintegerNested player-sport profile the interest entry belongs to (stringified).
recruit_stateinteger247Sports status of the recruit's interest entry for the school (e.g. committed, signed, decommitted).
institutionintegerFK -> the interested/interesting Institution.
lock_predictioncharacterCrystal Ball lock-prediction value for the school on this recruitment (247Sports field).
recruits_interestcharacterRecruit's stated interest level in the school, per 247Sports.
primary_coachnumericLead recruiting coach at the school for this recruit.
secondary_coachcharacterSecondary recruiting coach at the school for this recruit.
keeper_coachcharacterCoach designated as the keeper contact for the recruitment (247Sports field).
institutions_interestcharacterSchool's interest level in the recruit, per 247Sports.
positioninteger
position_groupinteger
platooninteger247Sports platoon (side-of-ball grouping) identifier on the interest entry.
offeredcharacterWhether the school has extended an offer.
gray_shirtcharacterWhether the offer or commitment is a grayshirt (delayed enrollment) arrangement.
walk_oncharacterWhether the recruit would join the program as a walk-on.
official_visitnumericDate of the recruit's official visit to the school.
second_official_visitcharacterDate of the recruit's second official visit to the school.
soft_commitcharacterWhether 247Sports marks the commitment as a soft commit.
hard_commitnumericFK -> the RecruitInterestEvent marking a hard commit.
signing_datenumericDate the recruit signed with the school.
enrollment_datenumericDate the recruit enrolled at the school.
decommitcharacterDate the recruit decommitted from the school, when applicable.
offercharacterWhether the school has extended a scholarship offer to the recruit.
highest_recruit_interest_eventnumericNested highest-signal event on the interest timeline (e.g. commitment) (stringified).
commit_statuscharacterCommitment status label (e.g. Committed, Signed).
default_namecharacterServer-rendered display label for the entity.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_recruitment_final_choice / sports247SitePagesRecruitmentFinalChoice​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
playerinteger
player_institutionintegerNested player-institution stint the player-sport profile points to (stringified).
stateintegerHome state of the recruit, per 247Sports.
sportintegerNested 247Sports sport for the profile (stringified).
ratinginteger247Sports rating string (0-1).
rating_or_defaultinteger247Sports in-house rating, falling back to a default value when unrated.
local_indexinteger247Sports' own industry-index value for the player, alongside the Rivals and ESPN indexes.
rivals_gradenumericRivals source grade (industry composite input).
rivals_rankintegerPlayer's rank in the Rivals industry ranking, as tracked by 247Sports.
rivals_indexnumericRivals index value for the player, as tracked by 247Sports.
espn_gradeintegerESPN source grade (industry composite input).
espn_rankintegerPlayer's rank in the ESPN industry ranking, as tracked by 247Sports.
espn_indexnumericESPN index value for the player, as tracked by 247Sports.
composite_strengthintegerComposite strength points (team-ranking weight).
composite_ratingnumeric247Sports Composite rating (industry blend).
composite_rating_or_defaultnumeric247Sports Composite rating, falling back to a default value when unrated.
average_ranknumericPlayer's average rank across the tracked industry services.
previous_recruitmentintegerNested record for the player's previous recruitment (stringified).
primarycharacterWhether this is the player's primary sport.
class_year_overridecharacterOverride of the player's recruiting class year, when 247Sports reassigns it.
class_yearcharacterRecruiting class year.
recruitmentintegerFK -> Recruitment aggregate for this player-sport.
primary_institution_predictionnumericNested leading Crystal Ball institution prediction for the player (stringified).
secondary_institution_predictionintegerNested second-place Crystal Ball institution prediction (stringified).
primary_institution_prediction_percentagenumericShare of Crystal Ball predictions favoring the leading institution.
show_unranked_ratingcharacter247Sports display flag to show the rating even while the player is unranked.
current_player_sport_yearnumericCurrent ranking-cycle year for the player-sport profile.
unpublished_player_sport_rankingnumericNested not-yet-published ranking row for the player (stringified).
current_player_sport_rankingnumericNested current published ranking row for the player (stringified).
primary_player_positionintegerNested 247Sports record for the player's primary position (stringified).
primary_positionintegerPlayer's primary position on the 247Sports profile.
primary_position_groupintegerPosition group the player's primary position belongs to.
default_namecharacterServer-rendered display label for the entity.
star_ratingintegerStar tier (2-5).
secondary_institution_prediction_percentagenumericShare of Crystal Ball predictions favoring the second-place institution.
jerseycharacter

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_recruitment_institution / sports247SitePagesRecruitmentInstitution​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
namecharacter
typecharacterInstitution type code (college / pro / high school).
groupcharacterInstitution group (division/level) bitmask code.
locationintegerFK -> Location (/Institution/\{Location\}/Location.json).
stateintegerFK -> State entity.
latitudenumeric
longitudenumeric
rankablecharacterWhether the institution participates in class rankings.
mascotcharacter
abbreviationcharacter
primary_colorcharacter
secondary_colorcharacter
is_foreigncharacterWhether the institution is located outside the United States.
siteintegerFK -> team Site (network site key).
default_assetnumericNested 247Sports image asset for the institution's primary logo (stringified).
alternate_assetnumericNested 247Sports image asset for the institution's alternate logo (stringified).
light_assetnumericNested 247Sports image asset for the light-background logo variant (stringified).
default_namecharacterServer-rendered display label for the entity.
addresscharacterInstitution's street address.
telephonecharacterInstitution's telephone number.
websitecharacterInstitution's website URL.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_recruitment_interests / sports247SitePagesRecruitmentInterests​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
namecharacter
typecharacterInstitution type code (college / pro / high school).
groupcharacterInstitution group (division/level) bitmask code.
locationintegerFK -> Location (/Institution/\{Location\}/Location.json).
stateintegerFK -> State entity.
latitudenumeric
longitudenumeric
rankablecharacterWhether the institution participates in class rankings.
mascotcharacter
abbreviationcharacter
primary_colorcharacter
secondary_colorcharacter
is_foreigncharacterWhether the institution is located outside the United States.
siteintegerFK -> team Site (network site key).
default_assetnumericNested 247Sports image asset for the institution's primary logo (stringified).
alternate_assetnumericNested 247Sports image asset for the institution's alternate logo (stringified).
light_assetnumericNested 247Sports image asset for the light-background logo variant (stringified).
default_namecharacterServer-rendered display label for the entity.
addresscharacterInstitution's street address.
telephonecharacterInstitution's telephone number.
websitecharacterInstitution's website URL.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_recruitment_offers / sports247SitePagesRecruitmentOffers​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
namecharacter
typecharacterInstitution type code (college / pro / high school).
groupcharacterInstitution group (division/level) bitmask code.
locationintegerFK -> Location (/Institution/\{Location\}/Location.json).
stateintegerFK -> State entity.
latitudenumeric
longitudenumeric
rankablecharacterWhether the institution participates in class rankings.
mascotcharacter
abbreviationcharacter
primary_colorcharacter
secondary_colorcharacter
is_foreigncharacterWhether the institution is located outside the United States.
siteintegerFK -> team Site (network site key).
default_assetnumericNested 247Sports image asset for the institution's primary logo (stringified).
alternate_assetnumericNested 247Sports image asset for the institution's alternate logo (stringified).
light_assetnumericNested 247Sports image asset for the light-background logo variant (stringified).
default_namecharacterServer-rendered display label for the entity.
addresscharacterInstitution's street address.
telephonecharacterInstitution's telephone number.
websitecharacterInstitution's website URL.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_recruitment_player_sport / sports247SitePagesRecruitmentPlayerSport​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
playerinteger
player_institutionintegerNested player-institution stint the player-sport profile points to (stringified).
stateintegerHome state of the recruit, per 247Sports.
sportintegerNested 247Sports sport for the profile (stringified).
ratinginteger247Sports rating string (0-1).
rating_or_defaultinteger247Sports in-house rating, falling back to a default value when unrated.
local_indexinteger247Sports' own industry-index value for the player, alongside the Rivals and ESPN indexes.
rivals_gradenumericRivals source grade (industry composite input).
rivals_rankintegerPlayer's rank in the Rivals industry ranking, as tracked by 247Sports.
rivals_indexnumericRivals index value for the player, as tracked by 247Sports.
espn_gradeintegerESPN source grade (industry composite input).
espn_rankintegerPlayer's rank in the ESPN industry ranking, as tracked by 247Sports.
espn_indexnumericESPN index value for the player, as tracked by 247Sports.
composite_strengthintegerComposite strength points (team-ranking weight).
composite_ratingnumeric247Sports Composite rating (industry blend).
composite_rating_or_defaultnumeric247Sports Composite rating, falling back to a default value when unrated.
average_ranknumericPlayer's average rank across the tracked industry services.
previous_recruitmentintegerNested record for the player's previous recruitment (stringified).
primarycharacterWhether this is the player's primary sport.
class_year_overridecharacterOverride of the player's recruiting class year, when 247Sports reassigns it.
class_yearcharacterRecruiting class year.
recruitmentintegerFK -> Recruitment aggregate for this player-sport.
primary_institution_predictionnumericNested leading Crystal Ball institution prediction for the player (stringified).
secondary_institution_predictionintegerNested second-place Crystal Ball institution prediction (stringified).
primary_institution_prediction_percentagenumericShare of Crystal Ball predictions favoring the leading institution.
show_unranked_ratingcharacter247Sports display flag to show the rating even while the player is unranked.
current_player_sport_yearnumericCurrent ranking-cycle year for the player-sport profile.
unpublished_player_sport_rankingnumericNested not-yet-published ranking row for the player (stringified).
current_player_sport_rankingnumericNested current published ranking row for the player (stringified).
primary_player_positionintegerNested 247Sports record for the player's primary position (stringified).
primary_positionintegerPlayer's primary position on the 247Sports profile.
primary_position_groupintegerPosition group the player's primary position belongs to.
default_namecharacterServer-rendered display label for the entity.
star_ratingintegerStar tier (2-5).
secondary_institution_prediction_percentagenumericShare of Crystal Ball predictions favoring the second-place institution.
jerseycharacter

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_season_current_expert_predictions / sports247SitePagesSeasonCurrentExpertPredictions​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
player_institutionintegerNested player-institution stint the Crystal Ball prediction targets (stringified).
institutionintegerFK -> predicted destination Institution.
userinteger247Sports user account of the predictor (nested, stringified).
updated_oncharacterDate the prediction was last updated.
prediction_statuscharacterCrystal-ball prediction status code.
days_correctnumericNumber of days the prediction has stood as correct.
premiumcharacter
scorenumericExpert accuracy score at time of prediction.
confidenceintegerExpert confidence 1-10.
parentcharacterParent prediction record this entry updates (247Sports field).
is_zero_zonecharacterWhether the prediction fell in 247Sports' zero zone (logged too close to the announcement to earn accuracy credit).
default_nameintegerServer-rendered display label for the entity.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_season_recruit_interest_events / sports247SitePagesSeasonRecruitInterestEvents​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
institutionintegerNested 247Sports institution the interest event involves (stringified).
recruitmentintegerNested 247Sports recruitment the event belongs to (stringified).
recruit_interestintegerNested recruit-interest record the event belongs to (stringified).
typecharacter
datecharacterDate of the recruiting-interest event, per 247Sports.
default_nameintegerServer-rendered display label for the entity.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_season_recruit_interests / sports247SitePagesSeasonRecruitInterests​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
recruitmentintegerFK -> parent Recruitment.
player_sportintegerNested player-sport profile the interest entry belongs to (stringified).
recruit_stateinteger247Sports status of the recruit's interest entry for the school (e.g. committed, signed, decommitted).
institutionintegerFK -> the interested/interesting Institution.
lock_predictioncharacterCrystal Ball lock-prediction value for the school on this recruitment (247Sports field).
recruits_interestcharacterRecruit's stated interest level in the school, per 247Sports.
primary_coachnumericLead recruiting coach at the school for this recruit.
secondary_coachcharacterSecondary recruiting coach at the school for this recruit.
keeper_coachcharacterCoach designated as the keeper contact for the recruitment (247Sports field).
institutions_interestcharacterSchool's interest level in the recruit, per 247Sports.
positioninteger
position_groupinteger
platooninteger247Sports platoon (side-of-ball grouping) identifier on the interest entry.
offeredcharacterWhether the school has extended an offer.
gray_shirtcharacterWhether the offer or commitment is a grayshirt (delayed enrollment) arrangement.
walk_oncharacterWhether the recruit would join the program as a walk-on.
official_visitnumericDate of the recruit's official visit to the school.
second_official_visitcharacterDate of the recruit's second official visit to the school.
soft_commitcharacterWhether 247Sports marks the commitment as a soft commit.
hard_commitnumericFK -> the RecruitInterestEvent marking a hard commit.
signing_datenumericDate the recruit signed with the school.
enrollment_datenumericDate the recruit enrolled at the school.
decommitcharacterDate the recruit decommitted from the school, when applicable.
offercharacterWhether the school has extended a scholarship offer to the recruit.
highest_recruit_interest_eventnumericNested highest-signal event on the interest timeline (e.g. commitment) (stringified).
commit_statuscharacterCommitment status label (e.g. Committed, Signed).
default_namecharacterServer-rendered display label for the entity.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_season_recruits / sports247SitePagesSeasonRecruits​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
player_institutionintegerNested player-institution stint behind the recruit row (stringified).
yearinteger
announcement_datecharacterDate the recruit announced their decision.
signed_institutionintegerNested institution the recruit signed with (stringified).
positioninteger
institutionintegerNested institution the recruit row is scoped to (stringified).
stateintegerHome state of the recruit, per 247Sports.
player_sportintegerNested player-sport profile for the recruit (stringified).
composite_strengthintegerComposite strength points contributed to team ranking.
final_choiceintegerWhether this entry represents the recruit's final school choice.
highest_recruit_interest_event_typecharacterType of the highest-signal event on the recruit's interest timeline (e.g. commit, signing).
highest_recruit_interest_eventintegerNested highest-signal event on the recruit's interest timeline (stringified).
committed_recruit_interestintegerNested interest record for the school the recruit committed to (stringified).
committed_institutionintegerFK -> committed Institution.
highest_recruit_interestintegerNested interest record carrying the recruit's highest interest signal (stringified).
primary_player_positionintegerNested 247Sports record for the recruit's primary position (stringified).
primary_positionintegerRecruit's primary position on the 247Sports profile.
default_namecharacterServer-rendered display label for the entity.
commited_institution_team_imagecharacterTeam image asset for the committed institution (the 'commited' spelling is 247Sports' own field name).
recruit_interest_countintegerNumber of tracked school interests.
recruit_interests_urlcharacterSite URL to the recruit's interest timeline.
player_keyintegerPrimary key of this entity (the id used in its .json route).
player_first_namecharacter
player_last_namecharacter
player_full_namecharacter
player_heightcharacter
player_weightnumeric
player_biocharacterPlayer biography text authored on 247Sports.
player_scout_evaluationcharacter247Sports scouting evaluation text for the player.
player_birthdatecharacterPlayer's date of birth, per 247Sports.
player_modified_usercharacter247Sports user who last modified the player record.
player_modified_datecharacterDate the player record was last modified.
player_cbs_keyintegerCross-reference key into the CBS Sports id space.
player_urlcharacter
player_last_recruitment_player_institutionintegerNested player-institution record from the player's most recent recruitment (stringified).
player_current_player_institutionintegerFK -> PlayerInstitution (current school).
player_twitter_contactnumericNested 247Sports contact record for the player's Twitter/X account (stringified).
player_mobile_phone_contactcharacterPlayer's mobile phone contact field on the 247Sports record.
player_primary_player_sportintegerFK -> PlayerSport (/PlayerSport/\{id\}.json).
player_primary_recruitmentintegerNested 247Sports record for the player's primary recruitment (stringified).
player_default_namecharacterServer-rendered display label for the entity.
player_default_assetintegerNested 247Sports image asset for the player's headshot (stringified).
player_default_asset_urlcharacterURL of the player's headshot image.
player_hero_assetcharacterNested 247Sports hero (banner) image asset for the player page (stringified).
player_quote_assetcharacterNested 247Sports image asset used alongside the player's quote block (stringified).
player_usercharacter247Sports user account linked to the player profile (nested, stringified).
player_pro_stat_playerintegerReference tying the profile to a professional stats player record (247Sports field).
player_college_stat_playerintegerReference tying the profile to a college stats player record (247Sports field).
player_bio_or_defaultcharacterPlayer bio text, falling back to a default blurb when none is authored.
player_ratinginteger247Sports numeric rating (0-1 scale) for the primary sport.
player_star_ratingintegerStar tier (2-5) derived from the rating.
player_national_rankintegerOverall national rank in the recruit's class.
player_position_rankintegerRank within position for the class.
player_state_rankintegerRank within home state for the class.
player_hometown_statecharacterState of the player's hometown.
player_hometown_citycharacterCity of the player's hometown.
player_player_high_school_namecharacterName of the player's high school.
player_primary_player_position_abbreviationcharacterAbbreviation of the player's primary position.

Rows are untyped Row[] (not parity-verified yet).

Returns — sports247_site_pages_season_roster_embed / sports247SitePagesSeasonRosterEmbed​

col_nametypedescription
keyintegerPrimary key of this entity (the id used in its .json route).
playerinteger
player_institutionintegerNested player-institution stint the player-sport profile points to (stringified).
stateintegerHome state of the recruit, per 247Sports.
sportintegerNested 247Sports sport for the profile (stringified).
ratinginteger247Sports rating string (0-1).
rating_or_defaultinteger247Sports in-house rating, falling back to a default value when unrated.
local_indexinteger247Sports' own industry-index value for the player, alongside the Rivals and ESPN indexes.
rivals_gradenumericRivals source grade (industry composite input).
rivals_rankintegerPlayer's rank in the Rivals industry ranking, as tracked by 247Sports.
rivals_indexnumericRivals index value for the player, as tracked by 247Sports.
espn_gradeintegerESPN source grade (industry composite input).
espn_rankintegerPlayer's rank in the ESPN industry ranking, as tracked by 247Sports.
espn_indexnumericESPN index value for the player, as tracked by 247Sports.
composite_strengthintegerComposite strength points (team-ranking weight).
composite_ratingnumeric247Sports Composite rating (industry blend).
composite_rating_or_defaultnumeric247Sports Composite rating, falling back to a default value when unrated.
average_ranknumericPlayer's average rank across the tracked industry services.
previous_recruitmentintegerNested record for the player's previous recruitment (stringified).
primarycharacterWhether this is the player's primary sport.
class_year_overridecharacterOverride of the player's recruiting class year, when 247Sports reassigns it.
class_yearcharacterRecruiting class year.
recruitmentintegerFK -> Recruitment aggregate for this player-sport.
primary_institution_predictionnumericNested leading Crystal Ball institution prediction for the player (stringified).
secondary_institution_predictionintegerNested second-place Crystal Ball institution prediction (stringified).
primary_institution_prediction_percentagenumericShare of Crystal Ball predictions favoring the leading institution.
show_unranked_ratingcharacter247Sports display flag to show the rating even while the player is unranked.
current_player_sport_yearnumericCurrent ranking-cycle year for the player-sport profile.
unpublished_player_sport_rankingnumericNested not-yet-published ranking row for the player (stringified).
current_player_sport_rankingnumericNested current published ranking row for the player (stringified).
primary_player_positionintegerNested 247Sports record for the player's primary position (stringified).
primary_positionintegerPlayer's primary position on the 247Sports profile.
primary_position_groupintegerPosition group the player's primary position belongs to.
default_namecharacterServer-rendered display label for the entity.
star_ratingintegerStar tier (2-5).
secondary_institution_prediction_percentagenumericShare of Crystal Ball predictions favoring the second-place institution.
jerseycharacter

Rows are untyped Row[] (not parity-verified yet).

Generated by tools/codegen/generate.mjs from tools/codegen/endpoints/sports247.yaml (vendored from sdv-py) + tools/codegen/endpoints/sports247_site_pages.yaml (vendored from sdv-py) — see How this library is built.