Skip to main content
Version: 0.1.5

CFB — On3 Recruit Database (api.on3.com) — Player

on3_player_all_rankings​

GET /rdb/v1/player/{personKey}/all-rankings

Endpoint URL: GET https://api.on3.com/public/rdb/v1/player/{person_key}/all-rankings

Valid URL: https://api.on3.com/public/rdb/v1/player/89617/all-rankings

API ParameterPythonPatternRequiredNullableDescription
person_keyperson_keyYperson_key path parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
typecharacterType label of the row (vocabulary depends on the endpoint).
linkcharacterSite-relative On3 link for the row, when any.
ranking_keyintegerOn3 key of the ranking cycle the row belongs to.
ranking_yearintegerRanking cycle year.
ranking_typecharacterRanking type (e.g. Player, TransferPortal, Team).
ratingnumericOn3 rating of the player (0-100 scale), when published.
sportcharacterNested On3 sport object for the ranking row (stringified).
class_yearintegerRecruiting class year the ranking covers.
state_rankintegerRank within the player's state in the ranking.
state_abbrcharacterTwo-letter abbreviation of the player's home state.
position_rankintegerRank at the player's position in the ranking.
position_abbrcharacterPosition abbreviation the ranking entry was assigned at.
overall_rankintegerOverall national rank in the ranking.
starsintegerStar rating (2-5).
five_star_pluslogicalWhether On3 designates the player a Five-Star Plus+ prospect.
nearly_five_star_pluslogicalOn3 flag that the player narrowly missed the Five-Star Plus+ designation.
change_1characterDirection of the rating change since the previous update (e.g. Increase); the numeric suffix is a json_normalize de-duplication artefact.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

on3_player_all_rankings(person_key=89617)

Last validated n/a.

on3_player_database_updates​

GET /rdb/v1/player/{personKey}/database-updates

Endpoint URL: GET https://api.on3.com/public/rdb/v1/player/{person_key}/database-updates

Valid URL: https://api.on3.com/public/rdb/v1/player/89617/database-updates

API ParameterPythonPatternRequiredNullableDescription
person_keyperson_keyYperson_key path parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
keyintegerOn3 RDB key for the database-update entry.
typecharacterType label of the row (vocabulary depends on the endpoint).
textcharacterText of the update as On3 displays it.
replacement_textcharacterRendered text of the update entry (with references substituted in).
linkcharacterSite-relative On3 link for the row, when any.
date_addedintegerDate the update entry was logged.
date_occurredintegerDate the underlying event occurred.
object_keyintegerOn3 key of the object the update refers to.
sport_keyintegerOn3 sport key the update is scoped to.
person_keyintegerOn3 person key of the player the update concerns.
organization_keyintegerOn3 organization key involved in the update, when any.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

on3_player_database_updates(person_key=89617)

Last validated n/a.

on3_player_images​

GET /rdb/v1/player/{personKey}/images

Endpoint URL: GET https://api.on3.com/public/rdb/v1/player/{person_key}/images

Valid URL: https://api.on3.com/public/rdb/v1/player/89617/images

API ParameterPythonPatternRequiredNullableDescription
person_keyperson_keyYperson_key path parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
keyintegerOn3 asset key for the image.
domain_overridecharacterOverride CDN domain for serving the image, when set.
domaincharacterCDN domain the image is served from.
source_overridecharacterOverride source attribution for the image, when set.
sourcecharacterCDN-relative source path of the image asset.
titlecharacterTitle of the row's record.
descriptioncharacterFree-text description or biography shipped by On3.
captioncharacterCaption text for the image.
categorycharacterCategory label On3 attaches to the row.
alt_textcharacterAlt text for the image.
heightintegerHeight as a formatted string (e.g. '6-3.5').
widthintegerImage width in pixels.
asset_typecharacterType of the asset (e.g. image) in On3's asset system.
file_systemcharacterStorage file system the asset lives on (On3 asset metadata).
pathcharacterStorage path of the image file.
typecharacterType label of the row (vocabulary depends on the endpoint).
thumbnailcharacterURL or path of the image's thumbnail rendition.
durationintegerDuration of the asset when it is a video (0 for images).
mime_typecharacterMIME type of the image file (e.g. image/jpeg).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

on3_player_images(person_key=89617)

Last validated n/a.

on3_player_organizations​

GET /rdb/v1/player/{personKey}/organizations

Endpoint URL: GET https://api.on3.com/public/rdb/v1/player/{person_key}/organizations

Valid URL: https://api.on3.com/public/rdb/v1/player/89617/organizations

API ParameterPythonPatternRequiredNullableDescription
person_keyperson_keyYperson_key path parameter.

Returns​

return_parsed=True (default) — the output of parse_on3_rdb; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no committed capture with rows, and the response type is only heuristically mapped (x-source: call-site); names derived from the OpenAPI response type matched parse_on3_rdb's output on only 7 of the 9 checkable endpoints, so none are published.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

on3_player_organizations(person_key=89617)

Last validated n/a.

on3_player_organizations_org_key​

GET /rdb/v1/player/{playerKey}/organizations/{orgKey}

Endpoint URL: GET https://api.on3.com/public/rdb/v1/player/{player_key}/organizations/{org_key}

Valid URL: https://api.on3.com/public/rdb/v1/player/89617/organizations/1867

API ParameterPythonPatternRequiredNullableDescription
player_keyplayer_keyYplayer_key path parameter.
org_keyorg_keyYorg_key path parameter.

Returns​

return_parsed=True (default) — the output of parse_on3_rdb; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no committed capture with rows, and the row has nested objects whose flattened column names depend on which are null in the data; names derived from the OpenAPI response type matched parse_on3_rdb's output on only 7 of the 9 checkable endpoints, so none are published.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

on3_player_organizations_org_key(org_key=1867, player_key=89617)

Last validated n/a.

on3_player_person_rankings​

GET /rdb/v1/player/{personKey}/rankings

Endpoint URL: GET https://api.on3.com/public/rdb/v1/player/{person_key}/rankings

Valid URL: https://api.on3.com/public/rdb/v1/player/89617/rankings

API ParameterPythonPatternRequiredNullableDescription
person_keyperson_keyYperson_key path parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
keyintegerOn3 RDB key for the player's ranking row.
ranking_keyintegerOn3 key of the ranking cycle the row belongs to.
ratingintegerOn3 rating of the player (0-100 scale), when published.
state_rankintegerRank within the player's state in the ranking.
state_abbrcharacterTwo-letter abbreviation of the player's home state.
position_rankintegerRank at the player's position in the ranking.
position_abbrcharacterPosition abbreviation the ranking entry was assigned at.
overall_rankintegerOverall national rank in the ranking.
starsintegerStar rating (2-5).
consensus_ratingnumericPlayer's industry-consensus rating (blend of the major recruiting services).
consensus_state_rankintegerPlayer's consensus rank within their home state.
consensus_position_rankintegerPlayer's consensus rank at their position.
consensus_overall_rankintegerPlayer's national consensus rank.
consensus_starsintegerPlayer's star rating under the industry consensus.
strengthintegerStrength score On3 attaches to the ranking entry.
five_star_pluslogicalWhether On3 designates the player a Five-Star Plus+ prospect.
ranking_typecharacterRanking type (e.g. Player, TransferPortal, Team).
ranking_key_2integerRanking key repeated from the nested ranking object (json_normalize de-duplication suffix).
ranking_sport_keyintegerOn3 numeric key of the sport the ranking is in.
ranking_sport_key_2integerOn3 numeric key of the sport the ranking is in (json_normalize de-duplication suffix).
ranking_sport_namecharacterName of the sport the ranking is in (e.g. Football).
ranking_yearintegerRanking cycle year.
change_38characterDirection of the On3 rating change since the previous update (e.g. Increase); the numeric suffix is a json_normalize de-duplication artefact.
consensus_change_41characterDirection of the consensus rating change since the previous update (e.g. Increase); the numeric suffix is a json_normalize de-duplication artefact.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

on3_player_person_rankings(person_key=89617)

Last validated n/a.

on3_player_profile​

GET /rdb/v1/player/{personKey}/profile

Endpoint URL: GET https://api.on3.com/public/rdb/v1/player/{person_key}/profile

Valid URL: https://api.on3.com/public/rdb/v1/player/89617/profile

API ParameterPythonPatternRequiredNullableDescription
person_keyperson_keyYperson_key path parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
keyintegerOn3 RDB key for the player profile.
class_year_recruitment_keyintegerOn3 recruitment key for the player's recruiting-class cycle.
recruitment_keyintegerOn3 key of the player's active recruitment record.
person_can_manage_recruitmentlogicalWhether the athlete can self-manage the recruitment on On3.
ranking_keyintegerOn3 key of the ranking cycle the profile's rating belongs to.
person_sport_keyintegerOn3 key of the athlete-sport profile (person x sport).
oracle_keycharacterOn3's internal oracle identifier for the player record.
namecharacterDisplay name of the row's record.
slugcharacterURL slug of the row's record on On3.
high_school_namecharacterHigh-school display name (top-level field).
hometown_namecharacterPlayer's hometown, as listed by On3.
position_abbreviationcharacterPosition abbreviation on the record.
class_rankcharacterPlayer's rank within their recruiting class.
heightcharacterHeight as a formatted string (e.g. '6-3.5').
weightintegerWeight in pounds.
class_yearintegerPlayer's recruiting class year.
degreecharacterDegree the player earned or is pursuing, when listed.
ageintegerAge in years, when known.
sportscharacterSports the player is profiled in, as a stringified list.
descriptioncharacterFree-text description or biography shipped by On3.
bio_pro_prospectcharacterBio text framing the player as a pro prospect (On3 RDB).
bio_college_recruitcharacterBio text framing the player as a college recruit (On3 RDB).
organization_levelcharacterLevel of the player's current organization (e.g. high school, college, professional).
high_school_org_keyintegerOn3 organization key of the player's high school.
prep_school_org_keycharacterOn3 organization key of the player's prep school, when attended.
junior_college_org_keycharacterOn3 organization key of the player's junior college, when attended.
college_org_keyintegerOn3 organization key of the player's college.
nil_valueintegerPlayer's On3 NIL valuation in dollars.
athlete_verifiedlogicalWhether the athlete has verified their own On3 profile.
prospect_verifiedlogicalWhether On3 has verified the prospect's profile information.
is_coachlogicalWhether the person record is a coach.
is_athletelogicalWhether the person record is an athlete.
visibilitycharacterProfile visibility setting on On3.
tiercharacterOn3 profile tier classification for the player.
review_statuscharacterEditorial review status of the profile in the On3 database.
jersey_numberintegerJersey number, when listed.
badgecharacterProfile badge assigned by On3, when any.
ncaa_idcharacterPlayer's NCAA identifier, when known to On3.
managed_by_userlogicalOn3 user account that manages the player's profile, when claimed.
ranking_key_2integerRanking key repeated from the nested ranking object (json_normalize de-duplication suffix).
ranking_ratingnumericNumeric value of the ranking (0-100 scale).
ranking_starsintegerStar rating of the ranking (2-5).
ranking_national_rankintegerNational rank of the ranking.
ranking_position_rankintegerPosition rank of the ranking.
ranking_state_rankintegerState rank of the ranking.
ranking_position_abbrcharacterPosition abbreviation the ranking was assigned at.
ranking_state_abbrcharacterState abbreviation the ranking was assigned in.
ranking_five_star_pluslogicalFive-star-plus flag on the ranking.
high_school_keyintegerOn3 numeric key of the high school.
high_school_full_namecharacterFull name of the high school (with mascot).
high_school_name_2characterName field of the nested high-school object (json_normalize de-duplication of high_school_name).
high_school_known_ascharacterCommon short name of the high school, when On3 lists one.
high_school_mascotcharacterHigh-school mascot.
high_school_abbreviationcharacterHigh-school abbreviation.
high_school_asset_urlcharacterConvenience CDN URL of the high-school logo.
high_school_default_asset_keyintegerOn3 asset key of the high school's logo asset.
high_school_default_asset_domain_overridecharacterCDN domain override for the high school's logo asset (usually null).
high_school_default_asset_domaincharacterCDN domain serving the high school's logo asset.
high_school_default_asset_source_overridecharacterSource-path override for the high school's logo asset (usually null).
high_school_default_asset_sourcecharacterCDN-relative source path of the high school's logo asset.
high_school_default_asset_titlecharacterEditorial title attached to the high school's logo asset.
high_school_default_asset_descriptioncharacterEditorial description attached to the high school's logo asset (usually null).
high_school_default_asset_captioncharacterEditorial caption attached to the high school's logo asset (usually null).
high_school_default_asset_categorycharacterEditorial category label of the high school's logo asset (usually null).
high_school_default_asset_alt_textcharacterAccessibility alt text of the high school's logo asset (usually null).
high_school_default_asset_heightintegerPixel height of the high school's logo asset.
high_school_default_asset_widthintegerPixel width of the high school's logo asset.
high_school_default_asset_asset_typecharacterOn3 asset-type discriminator of the high school's logo asset (e.g. Image).
high_school_default_asset_file_systemcharacterStorage file-system flag of the high school's logo asset.
high_school_default_asset_pathcharacterStorage path of the high school's logo asset.
high_school_default_asset_typecharacterMedia type field of the high school's logo asset (file extension, e.g. png).
high_school_default_asset_thumbnailcharacterThumbnail variant of the high school's logo asset (video assets; usually null).
high_school_default_asset_durationintegerDuration of the high school's logo asset when it is a video (usually null or 0).
high_school_default_asset_mime_typecharacterMIME type of the high school's logo asset.
high_school_slugcharacterURL slug of the high school on On3.
high_school_primary_colorcharacterPrimary hex color of the high school.
high_school_org_typecharacterOrganization type label of the school (e.g. HighSchool).
high_school_org_type_enumcharacterOrganization type enum of the school.
high_school_divisioncharacterDivision or classification of the high school, when listed.
high_school_site_keyscharacterJSON-encoded On3 site keys covering the school (usually null).
high_school_url_slugcharacterURL slug variant of the high-school page, with the key appended.
hometown_state_keyintegerOn3 numeric key of the home-town state.
hometown_state_namecharacterName of the home-town state.
hometown_state_abbreviationcharacterTwo-letter abbreviation of the home-town state.
hometown_state_country_keyintegerOn3 numeric key of the home-town state's country.
current_state_keyintegerOn3 numeric key of the current state.
current_state_namecharacterName of the current state.
current_state_abbreviationcharacterTwo-letter abbreviation of the current state.
current_state_country_keyintegerOn3 numeric key of the current state's country.
default_asset_keyintegerOn3 asset key of the default asset.
default_asset_domain_overridecharacterCDN domain override for the record's default asset (usually null).
default_asset_domaincharacterCDN domain serving the default asset.
default_asset_source_overridecharacterSource-path override for the default asset (usually null).
default_asset_sourcecharacterCDN-relative source path of the default asset.
default_asset_titlecharacterEditorial title attached to the default asset.
default_asset_descriptioncharacterEditorial description attached to the default asset (usually null).
default_asset_captioncharacterEditorial caption attached to the default asset (usually null).
default_asset_categorycharacterEditorial category label of the default asset (usually null).
default_asset_alt_textcharacterAccessibility alt text of the default asset (usually null).
default_asset_heightintegerPixel height of the default asset.
default_asset_widthintegerPixel width of the default asset.
default_asset_asset_typecharacterOn3 asset-type discriminator of the default asset (e.g. Image).
default_asset_file_systemcharacterStorage file-system flag of the default asset.
default_asset_pathcharacterStorage path of the default asset.
default_asset_typecharacterMedia type field of the default asset (file extension, e.g. png).
default_asset_thumbnailcharacterThumbnail variant of the default asset (video assets; usually null).
default_asset_durationintegerDuration of the default asset when it is a video (usually null or 0).
default_asset_mime_typecharacterMIME type of the default asset.
primary_position_keyintegerOn3 numeric key of the primary position.
primary_position_namecharacterName of the primary position (e.g. Quarterback).
primary_position_abbreviationcharacterAbbreviation of the primary position (e.g. QB).
primary_position_sport_keyintegerOn3 numeric key of the primary position's sport.
primary_position_sport_key_2integerOn3 numeric key of the primary position's sport (json_normalize de-duplication suffix).
primary_position_sport_namecharacterName of the primary position's sport (e.g. Football).
primary_position_sport_slugcharacterURL slug of the primary position's sport.
primary_position_sport_abbreviationcharacterAbbreviation of the primary position's sport.
primary_position_sport_is_rankablelogicalWhether On3 ranks players in the primary position's sport.
primary_position_sport_is_industry_rankablelogicalWhether industry-consensus rankings exist for the primary position's sport.
primary_position_sport_is_scoutablelogicalWhether On3 scouting reports exist for the primary position's sport.
primary_position_position_typecharacterPosition type of the primary position (e.g. Offense, Defense).
default_sport_keyintegerOn3 numeric key of the primary sport.
default_sport_namecharacterName of the primary sport (e.g. Football).
player_status_typecharacterType of the player's recruiting status (e.g. Committed, Signed, Enrolled, None).
player_status_short_term_signeelogicalShort-term-signee flag of the player's recruiting status (null when not applicable).
player_status_datecharacterDate the player's recruiting status took effect (ISO timestamp string).
player_status_committed_asset_keyintegerOn3 numeric key of the player's recruiting status's committed-to program.
player_status_committed_asset_urlcharacterCDN URL of the player's recruiting status's committed-to program's logo.
player_status_committed_asset_slugcharacterURL slug of the player's recruiting status's committed-to program on On3.
player_status_committed_asset_full_namecharacterFull name of the player's recruiting status's committed-to program (e.g. 'Alabama Crimson Tide').
player_status_committed_asset_res_keyintegerOn3 asset key of the player's recruiting status's committed-to program's logo asset.
player_status_committed_asset_res_domain_overridecharacterCDN domain override for the player's recruiting status's committed-to program's logo asset (usually null).
player_status_committed_asset_res_domaincharacterCDN domain serving the player's recruiting status's committed-to program's logo asset.
player_status_committed_asset_res_source_overridecharacterSource-path override for the player's recruiting status's committed-to program's logo asset (usually null).
player_status_committed_asset_res_sourcecharacterCDN-relative source path of the player's recruiting status's committed-to program's logo asset.
player_status_committed_asset_res_titlecharacterEditorial title attached to the player's recruiting status's committed-to program's logo asset.
player_status_committed_asset_res_descriptioncharacterEditorial description attached to the player's recruiting status's committed-to program's logo asset (usually null).
player_status_committed_asset_res_captioncharacterEditorial caption attached to the player's recruiting status's committed-to program's logo asset (usually null).
player_status_committed_asset_res_categorycharacterEditorial category label of the player's recruiting status's committed-to program's logo asset (usually null).
player_status_committed_asset_res_alt_textcharacterAccessibility alt text of the player's recruiting status's committed-to program's logo asset (usually null).
player_status_committed_asset_res_heightintegerPixel height of the player's recruiting status's committed-to program's logo asset.
player_status_committed_asset_res_widthintegerPixel width of the player's recruiting status's committed-to program's logo asset.
player_status_committed_asset_res_asset_typecharacterOn3 asset-type discriminator of the player's recruiting status's committed-to program's logo asset (e.g. Image).
player_status_committed_asset_res_file_systemcharacterStorage file-system flag of the player's recruiting status's committed-to program's logo asset.
player_status_committed_asset_res_pathcharacterStorage path of the player's recruiting status's committed-to program's logo asset.
player_status_committed_asset_res_typecharacterMedia type field of the player's recruiting status's committed-to program's logo asset (file extension, e.g. png).
player_status_committed_asset_res_thumbnailcharacterThumbnail variant of the player's recruiting status's committed-to program's logo asset (video assets; usually null).
player_status_committed_asset_res_durationintegerDuration of the player's recruiting status's committed-to program's logo asset when it is a video (usually null or 0).
player_status_committed_asset_res_mime_typecharacterMIME type of the player's recruiting status's committed-to program's logo asset.
player_status_transferred_asset_keyintegerOn3 numeric key of the player's recruiting status's program transferred to.
player_status_transferred_asset_urlcharacterCDN URL of the player's recruiting status's program transferred to's logo.
player_status_transferred_asset_slugcharacterURL slug of the player's recruiting status's program transferred to on On3.
player_status_transferred_asset_full_namecharacterFull name of the player's recruiting status's program transferred to (e.g. 'Alabama Crimson Tide').
player_status_transferred_asset_res_keyintegerOn3 asset key of the player's recruiting status's program transferred to's logo asset.
player_status_transferred_asset_res_domain_overridecharacterCDN domain override for the player's recruiting status's program transferred to's logo asset (usually null).
player_status_transferred_asset_res_domaincharacterCDN domain serving the player's recruiting status's program transferred to's logo asset.
player_status_transferred_asset_res_source_overridecharacterSource-path override for the player's recruiting status's program transferred to's logo asset (usually null).
player_status_transferred_asset_res_sourcecharacterCDN-relative source path of the player's recruiting status's program transferred to's logo asset.
player_status_transferred_asset_res_titlecharacterEditorial title attached to the player's recruiting status's program transferred to's logo asset.
player_status_transferred_asset_res_descriptioncharacterEditorial description attached to the player's recruiting status's program transferred to's logo asset (usually null).
player_status_transferred_asset_res_captioncharacterEditorial caption attached to the player's recruiting status's program transferred to's logo asset (usually null).
player_status_transferred_asset_res_categorycharacterEditorial category label of the player's recruiting status's program transferred to's logo asset (usually null).
player_status_transferred_asset_res_alt_textcharacterAccessibility alt text of the player's recruiting status's program transferred to's logo asset (usually null).
player_status_transferred_asset_res_heightintegerPixel height of the player's recruiting status's program transferred to's logo asset.
player_status_transferred_asset_res_widthintegerPixel width of the player's recruiting status's program transferred to's logo asset.
player_status_transferred_asset_res_asset_typecharacterOn3 asset-type discriminator of the player's recruiting status's program transferred to's logo asset (e.g. Image).
player_status_transferred_asset_res_file_systemcharacterStorage file-system flag of the player's recruiting status's program transferred to's logo asset.
player_status_transferred_asset_res_pathcharacterStorage path of the player's recruiting status's program transferred to's logo asset.
player_status_transferred_asset_res_typecharacterMedia type field of the player's recruiting status's program transferred to's logo asset (file extension, e.g. png).
player_status_transferred_asset_res_thumbnailcharacterThumbnail variant of the player's recruiting status's program transferred to's logo asset (video assets; usually null).
player_status_transferred_asset_res_durationintegerDuration of the player's recruiting status's program transferred to's logo asset when it is a video (usually null or 0).
player_status_transferred_asset_res_mime_typecharacterMIME type of the player's recruiting status's program transferred to's logo asset.
player_status_committed_organization_keyintegerOn3 key of the committed-to program (the player's recruiting status).
player_status_committed_organization_full_namecharacterFull name of the player's recruiting status's committed-to program (e.g. 'Alabama Crimson Tide').
player_status_committed_organization_namecharacterShort name of the player's recruiting status's committed-to program.
player_status_committed_organization_mascotcharacterMascot of the player's recruiting status's committed-to program.
player_status_committed_organization_abbreviationcharacterAbbreviation of the player's recruiting status's committed-to program.
player_status_committed_organization_asset_urlcharacterCDN URL of the committed-to program's logo (the player's recruiting status).
player_status_committed_organization_asset_keyintegerOn3 asset key of the player's recruiting status's committed-to program's logo asset.
player_status_committed_organization_asset_domain_overridecharacterCDN domain override for the player's recruiting status's committed-to program's logo asset (usually null).
player_status_committed_organization_asset_domaincharacterCDN domain serving the player's recruiting status's committed-to program's logo asset.
player_status_committed_organization_asset_source_overridecharacterSource-path override for the player's recruiting status's committed-to program's logo asset (usually null).
player_status_committed_organization_asset_sourcecharacterCDN-relative source path of the player's recruiting status's committed-to program's logo asset.
player_status_committed_organization_asset_titlecharacterEditorial title attached to the player's recruiting status's committed-to program's logo asset.
player_status_committed_organization_asset_descriptioncharacterEditorial description attached to the player's recruiting status's committed-to program's logo asset (usually null).
player_status_committed_organization_asset_captioncharacterEditorial caption attached to the player's recruiting status's committed-to program's logo asset (usually null).
player_status_committed_organization_asset_categorycharacterEditorial category label of the player's recruiting status's committed-to program's logo asset (usually null).
player_status_committed_organization_asset_alt_textcharacterAccessibility alt text of the player's recruiting status's committed-to program's logo asset (usually null).
player_status_committed_organization_asset_heightintegerPixel height of the player's recruiting status's committed-to program's logo asset.
player_status_committed_organization_asset_widthintegerPixel width of the player's recruiting status's committed-to program's logo asset.
player_status_committed_organization_asset_asset_typecharacterOn3 asset-type discriminator of the player's recruiting status's committed-to program's logo asset (e.g. Image).
player_status_committed_organization_asset_file_systemcharacterStorage file-system flag of the player's recruiting status's committed-to program's logo asset.
player_status_committed_organization_asset_pathcharacterStorage path of the player's recruiting status's committed-to program's logo asset.
player_status_committed_organization_asset_typecharacterMedia type field of the player's recruiting status's committed-to program's logo asset (file extension, e.g. png).
player_status_committed_organization_asset_thumbnailcharacterThumbnail variant of the player's recruiting status's committed-to program's logo asset (video assets; usually null).
player_status_committed_organization_asset_durationintegerDuration of the player's recruiting status's committed-to program's logo asset when it is a video (usually null or 0).
player_status_committed_organization_asset_mime_typecharacterMIME type of the player's recruiting status's committed-to program's logo asset.
player_status_committed_organization_slugcharacterURL slug of the committed-to program (the player's recruiting status).
player_status_committed_organization_primary_colorcharacterPrimary hex color of the player's recruiting status's committed-to program.
player_status_class_rankcharacterAcademic class standing recorded on the player's recruiting status (e.g. Senior).
player_status_transfer_enteredcharacterDate the player entered the transfer portal (the player's recruiting status; null when never entered).
player_status_recruitment_yearcharacterRecruiting-cycle year the player's recruiting status belongs to.
player_status_decommitted_assetcharacterNested asset of the program decommitted from (the player's recruiting status; usually null).
player_status_transferlogicalTransfer flag of the player's recruiting status (null when not applicable).
player_status_expected_to_transferlogicalExpected-to-transfer flag of the player's recruiting status (null when not applicable).
player_status_recruitment_keyintegerOn3 key of the recruitment record the player's recruiting status belongs to.
player_status_withdrawn_transferlogicalWhether the player withdrew from the transfer portal (the player's recruiting status).
player_status_withdrawn_transfer_datecharacterDate the player withdrew from the transfer portal (the player's recruiting status; null when never withdrawn).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

on3_player_profile(person_key=89617)

Last validated n/a.

on3_player_team_targets​

GET /rdb/v1/player/{playerKey}/team-targets

Endpoint URL: GET https://api.on3.com/public/rdb/v1/player/{player_key}/team-targets

Valid URL: https://api.on3.com/public/rdb/v1/player/89617/team-targets

API ParameterPythonPatternRequiredNullableDescription
player_keyplayer_keyYplayer_key path parameter.

Returns​

return_parsed=True (default) — the output of parse_on3_rdb; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no committed capture with rows, and the row has nested objects whose flattened column names depend on which are null in the data; names derived from the OpenAPI response type matched parse_on3_rdb's output on only 7 of the 9 checkable endpoints, so none are published.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

on3_player_team_targets(player_key=89617)

Last validated n/a.

on3_player_verified​

GET /rdb/v1/player/verified

Endpoint URL: GET https://api.on3.com/public/rdb/v1/player/verified

Valid URL: https://api.on3.com/public/rdb/v1/player/verified

API ParameterPythonPatternRequiredNullableDescription
sportKeysport_keyYsportKey query parameter.
pagepageYpage query parameter.
pageSizepage_sizeYpageSize query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
keyintegerOn3 RDB key for the player profile.
class_year_recruitment_keycharacterOn3 recruitment key for the player's recruiting-class cycle.
recruitment_keyintegerOn3 key of the player's active recruitment record.
person_can_manage_recruitmentcharacterWhether the athlete can self-manage the recruitment on On3.
ranking_keyintegerOn3 key of the ranking cycle the profile's rating belongs to.
person_sport_keyintegerOn3 key of the athlete-sport profile (person x sport).
rankingcharacterNested ranking object (stringified; usually null).
oracle_keycharacterOn3's internal oracle identifier for the player record.
namecharacterDisplay name of the row's record.
slugcharacterURL slug of the row's record on On3.
high_school_namecharacterHigh-school display name (top-level field).
hometown_namecharacterPlayer's hometown, as listed by On3.
hometown_statecharacterHome-town state, when listed.
current_statecharacterState the player currently plays in, when listed.
position_abbreviationcharacterPosition abbreviation on the record.
primary_positioncharacterNested On3 object for the player's primary position (stringified).
class_rankcharacterPlayer's rank within their recruiting class.
heightcharacterHeight as a formatted string (e.g. '6-3.5').
weightintegerWeight in pounds.
class_yearintegerPlayer's recruiting class year.
degreecharacterDegree the player earned or is pursuing, when listed.
ageintegerAge in years, when known.
sportscharacterSports the player is profiled in, as a stringified list.
descriptioncharacterFree-text description or biography shipped by On3.
bio_pro_prospectcharacterBio text framing the player as a pro prospect (On3 RDB).
bio_college_recruitcharacterBio text framing the player as a college recruit (On3 RDB).
organization_levelcharacterLevel of the player's current organization (e.g. high school, college, professional).
high_school_org_keynumericOn3 organization key of the player's high school.
prep_school_org_keycharacterOn3 organization key of the player's prep school, when attended.
junior_college_org_keycharacterOn3 organization key of the player's junior college, when attended.
college_org_keycharacterOn3 organization key of the player's college.
nil_valueintegerPlayer's On3 NIL valuation in dollars.
athlete_verifiedlogicalWhether the athlete has verified their own On3 profile.
prospect_verifiedlogicalWhether On3 has verified the prospect's profile information.
player_statuscharacterPlayer's current status per On3 (e.g. active, transfer portal).
is_coachlogicalWhether the person record is a coach.
is_athletelogicalWhether the person record is an athlete.
visibilitycharacterProfile visibility setting on On3.
tiercharacterOn3 profile tier classification for the player.
review_statuscharacterEditorial review status of the profile in the On3 database.
jersey_numbercharacterJersey number, when listed.
badgecharacterProfile badge assigned by On3, when any.
ncaa_idcharacterPlayer's NCAA identifier, when known to On3.
managed_by_userlogicalOn3 user account that manages the player's profile, when claimed.
high_school_keyintegerOn3 numeric key of the high school.
high_school_full_namecharacterFull name of the high school (with mascot).
high_school_name_2characterName field of the nested high-school object (json_normalize de-duplication of high_school_name).
high_school_known_ascharacterCommon short name of the high school, when On3 lists one.
high_school_mascotcharacterHigh-school mascot.
high_school_abbreviationcharacterHigh-school abbreviation.
high_school_asset_urlcharacterConvenience CDN URL of the high-school logo.
high_school_default_asset_keyintegerOn3 asset key of the high school's logo asset.
high_school_default_asset_domain_overridecharacterCDN domain override for the high school's logo asset (usually null).
high_school_default_asset_domaincharacterCDN domain serving the high school's logo asset.
high_school_default_asset_source_overridecharacterSource-path override for the high school's logo asset (usually null).
high_school_default_asset_sourcecharacterCDN-relative source path of the high school's logo asset.
high_school_default_asset_titlecharacterEditorial title attached to the high school's logo asset.
high_school_default_asset_descriptioncharacterEditorial description attached to the high school's logo asset (usually null).
high_school_default_asset_captioncharacterEditorial caption attached to the high school's logo asset (usually null).
high_school_default_asset_categorycharacterEditorial category label of the high school's logo asset (usually null).
high_school_default_asset_alt_textcharacterAccessibility alt text of the high school's logo asset (usually null).
high_school_default_asset_heightintegerPixel height of the high school's logo asset.
high_school_default_asset_widthintegerPixel width of the high school's logo asset.
high_school_default_asset_asset_typecharacterOn3 asset-type discriminator of the high school's logo asset (e.g. Image).
high_school_default_asset_file_systemcharacterStorage file-system flag of the high school's logo asset.
high_school_default_asset_pathcharacterStorage path of the high school's logo asset.
high_school_default_asset_typecharacterMedia type field of the high school's logo asset (file extension, e.g. png).
high_school_default_asset_thumbnailcharacterThumbnail variant of the high school's logo asset (video assets; usually null).
high_school_default_asset_durationintegerDuration of the high school's logo asset when it is a video (usually null or 0).
high_school_default_asset_mime_typecharacterMIME type of the high school's logo asset.
high_school_slugcharacterURL slug of the high school on On3.
high_school_primary_colorcharacterPrimary hex color of the high school.
high_school_org_typecharacterOrganization type label of the school (e.g. HighSchool).
high_school_org_type_enumcharacterOrganization type enum of the school.
high_school_divisioncharacterDivision or classification of the high school, when listed.
high_school_site_keyscharacterJSON-encoded On3 site keys covering the school (usually null).
high_school_url_slugcharacterURL slug variant of the high-school page, with the key appended.
default_asset_keyintegerOn3 asset key of the default asset.
default_asset_domain_overridecharacterCDN domain override for the record's default asset (usually null).
default_asset_domaincharacterCDN domain serving the default asset.
default_asset_source_overridecharacterSource-path override for the default asset (usually null).
default_asset_sourcecharacterCDN-relative source path of the default asset.
default_asset_titlecharacterEditorial title attached to the default asset.
default_asset_descriptioncharacterEditorial description attached to the default asset (usually null).
default_asset_captioncharacterEditorial caption attached to the default asset (usually null).
default_asset_categorycharacterEditorial category label of the default asset (usually null).
default_asset_alt_textcharacterAccessibility alt text of the default asset (usually null).
default_asset_heightintegerPixel height of the default asset.
default_asset_widthintegerPixel width of the default asset.
default_asset_asset_typecharacterOn3 asset-type discriminator of the default asset (e.g. Image).
default_asset_file_systemcharacterStorage file-system flag of the default asset.
default_asset_pathcharacterStorage path of the default asset.
default_asset_typecharacterMedia type field of the default asset (file extension, e.g. png).
default_asset_thumbnailcharacterThumbnail variant of the default asset (video assets; usually null).
default_asset_durationintegerDuration of the default asset when it is a video (usually null or 0).
default_asset_mime_typecharacterMIME type of the default asset.
default_sport_keyintegerOn3 numeric key of the primary sport.
default_sport_namecharacterName of the primary sport (e.g. Football).
hometown_state_keynumericOn3 numeric key of the home-town state.
hometown_state_namecharacterName of the home-town state.
hometown_state_abbreviationcharacterTwo-letter abbreviation of the home-town state.
hometown_state_country_keynumericOn3 numeric key of the home-town state's country.
current_state_keynumericOn3 numeric key of the current state.
current_state_namecharacterName of the current state.
current_state_abbreviationcharacterTwo-letter abbreviation of the current state.
current_state_country_keynumericOn3 numeric key of the current state's country.
primary_position_keynumericOn3 numeric key of the primary position.
primary_position_namecharacterName of the primary position (e.g. Quarterback).
primary_position_abbreviationcharacterAbbreviation of the primary position (e.g. QB).
primary_position_sport_keynumericOn3 numeric key of the primary position's sport.
primary_position_sport_key_2numericOn3 numeric key of the primary position's sport (json_normalize de-duplication suffix).
primary_position_sport_namecharacterName of the primary position's sport (e.g. Football).
primary_position_sport_slugcharacterURL slug of the primary position's sport.
primary_position_sport_abbreviationcharacterAbbreviation of the primary position's sport.
primary_position_sport_is_rankablecharacterWhether On3 ranks players in the primary position's sport.
primary_position_sport_is_industry_rankablecharacterWhether industry-consensus rankings exist for the primary position's sport.
primary_position_sport_is_scoutablecharacterWhether On3 scouting reports exist for the primary position's sport.
primary_position_position_typecharacterPosition type of the primary position (e.g. Offense, Defense).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

on3_player_verified()

Last validated n/a.

on3_player_videos​

GET /rdb/v1/player/{personKey}/videos

Endpoint URL: GET https://api.on3.com/public/rdb/v1/player/{person_key}/videos

Valid URL: https://api.on3.com/public/rdb/v1/player/89617/videos

API ParameterPythonPatternRequiredNullableDescription
person_keyperson_keyYperson_key path parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
keyintegerOn3 RDB key for the video record.
source_urlcharacterSource URL of the hosted video.
titlecharacterTitle of the row's record.
thumbnailcharacterURL of the video's thumbnail image.
descriptioncharacterFree-text description or biography shipped by On3.
dateintegerPublication date of the video, per On3.
person_keyintegerOn3 person key of the featured athlete.
person_sportcharacterNested athlete-sport profile the video is attached to (stringified).
is_featuredlogicalWhether the video is featured on the player's On3 profile.
featured_ordercharacterDisplay order among featured videos, when featured.
category_keyintegerOn3 key of the video category.
category_valuecharacterVideo category label (e.g. Highlights).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

on3_player_videos(person_key=89617)

Last validated n/a.

on3_player_visit_center​

GET /rdb/v1/player/{playerKey}/visit-center

Endpoint URL: GET https://api.on3.com/public/rdb/v1/player/{player_key}/visit-center

Valid URL: https://api.on3.com/public/rdb/v1/player/89617/visit-center

API ParameterPythonPatternRequiredNullableDescription
player_keyplayer_keyYplayer_key path parameter.

Returns​

return_parsed=True (default) — the output of parse_on3_rdb; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no committed capture with rows, and the row has nested objects whose flattened column names depend on which are null in the data; names derived from the OpenAPI response type matched parse_on3_rdb's output on only 7 of the 9 checkable endpoints, so none are published.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

on3_player_visit_center(player_key=89617)

Last validated n/a.

on3_players_industry_comparision​

GET /rdb/v1/players/industry-comparision

Endpoint URL: GET https://api.on3.com/public/rdb/v1/players/industry-comparision

Valid URL: https://api.on3.com/public/rdb/v1/players/industry-comparision

API ParameterPythonPatternRequiredNullableDescription
sportKeysport_keyYsportKey query parameter.
yearyearYyear query parameter.
stateAbbrstate_abbrYstateAbbr query parameter.
positionAbbrposition_abbrYpositionAbbr query parameter.
pagepageYpage query parameter.
sortByIndustrysort_by_industryYsortByIndustry query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
ratingscharacterList of per-service rating entries (On3, Rivals, 247, ESPN) composing the industry comparison.
nil_valueintegerOn3 NIL valuation for the player (US dollars).
person_keyintegerOn3 numeric key of the person.
person_namecharacterDisplay name of the person.
person_slugcharacterURL slug of the person's On3 profile.
person_high_school_namecharacterHigh-school display name on the person's record.
person_high_school_keyintegerOn3 numeric key of the person's high school.
person_high_school_full_namecharacterFull name of the person's high school (e.g. 'Alabama Crimson Tide').
person_high_school_name_2characterHigh-school display name on the person's record (json_normalize de-duplication suffix).
person_high_school_known_ascharacterCommon short name of the person's high school, when On3 lists one.
person_high_school_mascotcharacterMascot of the person's high school.
person_high_school_abbreviationcharacterAbbreviation of the person's high school.
person_high_school_asset_urlcharacterConvenience CDN URL of the person's high school's logo.
person_high_school_default_asset_keyintegerOn3 asset key of the person's high school's logo asset.
person_high_school_default_asset_domain_overridecharacterCDN domain override for the person's high school's logo asset (usually null).
person_high_school_default_asset_domaincharacterCDN domain serving the person's high school's logo asset.
person_high_school_default_asset_source_overridecharacterSource-path override for the person's high school's logo asset (usually null).
person_high_school_default_asset_sourcecharacterCDN-relative source path of the person's high school's logo asset.
person_high_school_default_asset_titlecharacterEditorial title attached to the person's high school's logo asset.
person_high_school_default_asset_descriptioncharacterEditorial description attached to the person's high school's logo asset (usually null).
person_high_school_default_asset_captioncharacterEditorial caption attached to the person's high school's logo asset (usually null).
person_high_school_default_asset_categorycharacterEditorial category label of the person's high school's logo asset (usually null).
person_high_school_default_asset_alt_textcharacterAccessibility alt text of the person's high school's logo asset (usually null).
person_high_school_default_asset_heightintegerPixel height of the person's high school's logo asset.
person_high_school_default_asset_widthintegerPixel width of the person's high school's logo asset.
person_high_school_default_asset_asset_typecharacterOn3 asset-type discriminator of the person's high school's logo asset (e.g. Image).
person_high_school_default_asset_file_systemcharacterStorage file-system flag of the person's high school's logo asset.
person_high_school_default_asset_pathcharacterStorage path of the person's high school's logo asset.
person_high_school_default_asset_typecharacterMedia type field of the person's high school's logo asset (file extension, e.g. png).
person_high_school_default_asset_thumbnailcharacterThumbnail variant of the person's high school's logo asset (video assets; usually null).
person_high_school_default_asset_durationintegerDuration of the person's high school's logo asset when it is a video (usually null or 0).
person_high_school_default_asset_mime_typecharacterMIME type of the person's high school's logo asset.
person_high_school_slugcharacterURL slug of the person's high school on On3.
person_high_school_primary_colorcharacterPrimary hex color of the person's high school.
person_high_school_org_typecharacterOrganization type label of the person's high school (e.g. HighSchool, College).
person_high_school_org_type_enumcharacterOrganization type enum of the person's high school (same vocabulary as org_type).
person_high_school_divisioncharacterDivision or classification of the person's high school (e.g. NCAA-FB).
person_high_school_site_keyscharacterJSON-encoded On3 site keys covering the person's high school (usually null).
person_high_school_url_slugcharacterURL slug variant of the person's high school's page, with the key appended.
person_home_town_namecharacterHome town of the person as On3 lists it (e.g. 'Belleville, MI').
person_default_asset_urlcharacterConvenience CDN URL of the person's headshot.
person_default_asset_keyintegerOn3 asset key of the person's headshot asset.
person_default_asset_domain_overridecharacterCDN domain override for the person's headshot asset (usually null).
person_default_asset_domaincharacterCDN domain serving the person's headshot asset.
person_default_asset_source_overridecharacterSource-path override for the person's headshot asset (usually null).
person_default_asset_sourcecharacterCDN-relative source path of the person's headshot asset.
person_default_asset_titlecharacterEditorial title attached to the person's headshot asset.
person_default_asset_descriptioncharacterEditorial description attached to the person's headshot asset (usually null).
person_default_asset_captioncharacterEditorial caption attached to the person's headshot asset (usually null).
person_default_asset_categorycharacterEditorial category label of the person's headshot asset (usually null).
person_default_asset_alt_textcharacterAccessibility alt text of the person's headshot asset (usually null).
person_default_asset_heightintegerPixel height of the person's headshot asset.
person_default_asset_widthintegerPixel width of the person's headshot asset.
person_default_asset_asset_typecharacterOn3 asset-type discriminator of the person's headshot asset (e.g. Image).
person_default_asset_file_systemcharacterStorage file-system flag of the person's headshot asset.
person_default_asset_pathcharacterStorage path of the person's headshot asset.
person_default_asset_typecharacterMedia type field of the person's headshot asset (file extension, e.g. png).
person_default_asset_thumbnailcharacterThumbnail variant of the person's headshot asset (video assets; usually null).
person_default_asset_durationintegerDuration of the person's headshot asset when it is a video (usually null or 0).
person_default_asset_mime_typecharacterMIME type of the person's headshot asset.
person_early_signeelogicalWhether the person signed during the early signing period.
person_early_enrolleelogicalWhether the person early-enrolled at college.
person_position_abbreviationcharacterPosition abbreviation on the person's record.
person_heightnumericHeight of the person: a formatted string (e.g. '6-8') or inches, depending on the endpoint.
person_formatted_heightcharacterHuman-formatted height of the person (e.g. '6-3.5').
person_weightintegerWeight of the person in pounds.
person_class_yearintegerHigh-school graduating class year of the person.
person_athlete_verifiedlogicalWhether the person's athlete profile is verified by On3.
person_prospect_verifiedlogicalWhether the person's prospect measurables are verified by On3.
person_class_rankcharacterAcademic class standing of the person (e.g. Senior, RedShirt Senior).
person_recruitment_keyintegerOn3 key of the person's active recruitment record.
person_ageintegerAge of the person in years, when known.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

on3_players_industry_comparision()

Last validated n/a.

on3_players_industry_comparision_list​

GET /rdb/v1/players/industry-comparision-list

Endpoint URL: GET https://api.on3.com/public/rdb/v1/players/industry-comparision-list

Valid URL: https://api.on3.com/public/rdb/v1/players/industry-comparision-list

API ParameterPythonPatternRequiredNullableDescription
sportKeysport_keyYsportKey query parameter.
yearyearYyear query parameter.
pagepageYpage query parameter.
pageSizepage_sizeYpageSize query parameter.

Returns​

return_parsed=True (default) — the output of parse_on3_rdb; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no committed capture with rows, and the response type is only heuristically mapped (x-source: call-site); names derived from the OpenAPI response type matched parse_on3_rdb's output on only 7 of the 9 checkable endpoints, so none are published.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

on3_players_industry_comparision_list()

Last validated n/a.