Skip to main content

MLB dataset loaders — NCAA (stats.ncaa.org)

load_ncaa_baseball_pbp​

Release: ncaa_baseball_pbp · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_baseball_pbp/ncaa_baseball_pbp_{season}.parquet

Returns​

col_nametypedescription
contest_idStringstats.ncaa.org contest (game) identifier.
inningInt64Inning number.
inning_top_botStringHalf-inning ("top" or "bot").
battingStringWhether the situation applies to batting stats.
fieldingStringWhether the situation applies to fielding stats.
play_numberInt64
score_awayInt64
score_homeInt64
batterStringMLBAM player id of the batter.
play_typeStringPlay category the NCAA baseball parser classified from the play text: single, double, triple, home_run, strikeout, walk, hit_by_pitch, groundout, flyout, lineout, out, double_play, fielders_choice, reached_on_error, stolen_base, wild_pitch, passed_ball, runner_advance, substitution, other, or unknown when the clause could not be classified.
hit_trajectoryStringBatted-ball trajectory: one of ground, line, fly, pop, foul.
fielded_positionStringFree-text description of where/how the ball was fielded or the runner advanced, as written by the scorer.
is_hitBooleanWhether the plate appearance resulted in a hit.
is_outBooleanWhether the play recorded at least one out.
strikeout_typeStringHow the strikeout ended: 'swinging' or 'looking'.
is_sacrificeBooleanWhether the play was scored as a sacrifice.
sac_typeStringKind of sacrifice when one was scored: 'fly' or 'bunt'.
is_double_playBooleanWhether the play resulted in a double play.
rbiInt64Runs batted in.
count_ballsInt64Ball count when the plate appearance resolved.
count_strikesInt64Strike count when the plate appearance resolved.
pitch_sequenceStringPer-pitch result string for the plate appearance (e.g. 'BBKKS'), one character per pitch.
error_positionStringFielding position credited with the error, as the feed labels it (e.g. 'ss', 'rf', 'c').
unearnedBooleanWhether the run(s) on the play were scored as unearned.
runs_scoredInt64Runs that scored on the play.
scoring_runnersList(String)List of runner names who scored on the play.
runners_advancedList(String)List of 'runner->base' strings describing each runner's advance on the play.
outs_on_playInt64Number of outs recorded on the play (0-3).
is_scoring_playBooleanFlag indicating that the play put points on the board (1 = scoring play, 0 = not).
descriptionStringLong-form description text.
sourceStringSource.
espn_game_idString
game_keyStringNCAA contest identifier for the game the row belongs to; the join key to the other ncaa_baseball_* tables.
game_dateStringGame date (YYYY-MM-DD).
locationStringTeam city/region (e.g. "Los Angeles").
attendanceInt64Reported attendance (NA on the redesigned page).
seasonInt64Season year.
load_ncaa_baseball_pbp(seasons=2023)

load_ncaa_baseball_schedule​

Release: ncaa_baseball_schedules · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_baseball_schedules/ncaa_baseball_schedule_{season}.parquet

Returns​

col_nametypedescription
team_idStringUnique ESPN team identifier.
team_nameStringTeam name.
dateStringDate in YYYY-MM-DD format.
game_numberInt64Game number within a doubleheader.
opponent_idStringUnique identifier for opponent.
opponentString
resultStringWin/loss/tie result for team_id.
outcomeStringResult for the team the row is keyed to: 'W', 'L' or 'T'.
team_scoreInt64Team's score / final score.
opponent_scoreInt64Opponent score.
contest_idStringstats.ncaa.org contest (game) identifier.
attendanceInt64Reported attendance (NA on the redesigned page).
divisionInt64NCAA division (1, 2, 3).
seasonInt64Season year.
load_ncaa_baseball_schedule(seasons=2023)

load_ncaa_baseball_teams​

Release: ncaa_baseball_teams · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_baseball_teams/ncaa_baseball_teams_{season}.parquet

Returns​

col_nametypedescription
team_idStringUnique ESPN team identifier.
team_nameStringTeam name.
divisionInt64NCAA division (1, 2, 3).
seasonInt64Season year.
load_ncaa_baseball_teams(seasons=2025)

load_ncaa_baseball_rosters​

Release: ncaa_baseball_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_baseball_rosters/ncaa_baseball_rosters_{season}.parquet

Returns​

col_nametypedescription
team_idStringUnique ESPN team identifier.
team_nameStringTeam name.
player_idStringstats.ncaa.org player identifier.
player_nameStringPlayer name.
jerseyStringJersey number worn by the player.
statcrew_jerseyStringStatCrew jersey number; present in the schema but entirely unpopulated in the published asset.
player_classStringClass year as the feed reports it (Fr., So., Jr., Sr.); '---' when unreported.
positionStringPosition the NCAA baseball feed reports for the player.
heightStringHeight (feet and inches).
weightInt64Weight in pounds.
hometownString
high_schoolString
games_playedInt64Games played.
games_startedInt64Games started.
seasonInt64Season year.
load_ncaa_baseball_rosters(seasons=2025)

load_ncaa_baseball_linescore​

Release: ncaa_baseball_linescore · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_baseball_linescore/ncaa_baseball_linescore_{season}.parquet

Returns​

col_nametypedescription
contest_idStringstats.ncaa.org contest (game) identifier.
teamStringTeam.
home_awayStringVenue label for the team ('home' or 'away').
inningStringInning number.
runsInt64Runs scored.
runs_totalInt64Total runs scored by the team across the whole game.
hitsInt64Hits.
errorsInt64Fielding errors.
game_dateStringGame date (YYYY-MM-DD).
venueString
attendanceInt64Reported attendance (NA on the redesigned page).
sourceStringSource.
espn_game_idString
game_keyStringNCAA contest identifier for the game the row belongs to; the join key to the other ncaa_baseball_* tables.
locationStringTeam city/region (e.g. "Los Angeles").
seasonInt64Season year.
load_ncaa_baseball_linescore(seasons=2025)

load_ncaa_baseball_team_stats​

Release: ncaa_baseball_team_stats · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_baseball_team_stats/ncaa_baseball_team_stats_{season}.parquet

Returns​

col_nametypedescription
contest_idStringstats.ncaa.org contest (game) identifier.
categoryStringCategory label.
statString
periodStringInning number.
away_teamStringAway team name.
away_valueStringAway team's value for the stat named by the row, as a string (the table is long/tidy, one stat per row).
home_teamStringHome team name.
home_valueStringHome team's value for the stat named by the row, as a string (the table is long/tidy, one stat per row).
sourceStringSource.
espn_game_idString
game_keyStringNCAA contest identifier for the game the row belongs to; the join key to the other ncaa_baseball_* tables.
game_dateStringGame date (YYYY-MM-DD).
locationStringTeam city/region (e.g. "Los Angeles").
attendanceInt64Reported attendance (NA on the redesigned page).
seasonInt64Season year.
load_ncaa_baseball_team_stats(seasons=2025)

load_ncaa_baseball_player_stats​

Release: ncaa_baseball_player_stats · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_baseball_player_stats/ncaa_baseball_player_stats_{season}.parquet

Returns​

col_nametypedescription
contest_idStringstats.ncaa.org contest (game) identifier.
team_idStringUnique ESPN team identifier.
numberStringJersey number.
nameStringDisplay name.
positionStringPosition the NCAA baseball feed reports for the player.
rStringRuns scored.
abStringAt-bats.
hStringHits.
2bStringDoubles hit by the batter.
3bStringTriples hit by the batter.
tbStringTotal bases accumulated by the batter.
hrStringHome runs hit by the batter over the covered sample.
rbiStringRuns batted in.
bbStringBases on balls (walks).
hbpStringTimes the batter was hit by a pitch.
sfStringSacrifice flies hit by the batter.
shStringSacrifice hits (bunts) laid down by the batter.
kStringStrikeouts.
opp_dpStringDouble plays turned by the opposing defense against this side.
csStringTimes the baserunner was caught stealing.
pickedStringTimes the baserunner was picked off.
sbStringStolen bases by the baserunner.
ibbStringIntentional bases on balls drawn by the batter.
klStringStrikeouts looking -- called third strikes, as opposed to swinging strikeouts.
categoryStringCategory label.
sourceStringSource.
espn_game_idString
game_keyStringNCAA contest identifier for the game the row belongs to; the join key to the other ncaa_baseball_* tables.
game_dateStringGame date (YYYY-MM-DD).
locationStringTeam city/region (e.g. "Los Angeles").
attendanceInt64Reported attendance (NA on the redesigned page).
ipStringInnings pitched.
erStringEarned runs.
soStringStrikeouts: the batter's strikeouts on the batting line, the pitcher's strikeouts recorded on the pitching line.
bfStringBatters faced by the pitcher.
2b_aStringDoubles allowed by the pitcher.
3b_aStringTriples allowed by the pitcher.
bkStringBalks charged to the pitcher.
hr_aStringHome runs allowed by the pitcher.
wpStringWild pitches charged to the pitcher.
hbStringBatters hit by a pitch from this pitcher.
inh_runStringInherited runners on base when this relief pitcher entered.
inh_run_scoreStringInherited runners who subsequently scored.
shaStringSacrifice hits allowed by the pitcher.
sfaStringSacrifice flies allowed by the pitcher.
tuerStringTeam unearned runs scored while this pitcher was in the game.
pickoffsStringPickoffs.
poStringPutouts recorded by the fielder.
aStringFielding assists credited to the player.
tcStringTotal chances for the fielder (putouts + assists + errors).
eStringErrors charged to the fielder.
ciStringTimes the batter reached base on catcher's interference.
pbStringPassed balls charged to the catcher.
sbaStringStolen bases allowed while this catcher was behind the plate.
csbStringRunners caught stealing while this catcher was behind the plate.
idpStringTimes the batter grounded into a double play.
tpStringTriple plays the player took part in.
sbapctStringStolen-base success rate allowed by the catcher, as a PROPORTION on 0-1 (e.g. 0.625), not a percentage.
seasonInt64Season year.
load_ncaa_baseball_player_stats(seasons=2025)

load_ncaa_baseball_situational_stats​

Release: ncaa_baseball_situational_stats · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_baseball_situational_stats/ncaa_baseball_situational_stats_{season}.parquet

Returns​

col_nametypedescription
contest_idStringstats.ncaa.org contest (game) identifier.
team_seqInt64Side indicator for the row: 0 and 1 distinguish the two teams in the contest.
playerString
positionStringPosition the NCAA baseball feed reports for the player.
with_runrsStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- plate appearances with runners on base.
hits_scoreposStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- at-bats with runners in scoring position.
vs_lhpStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- batting against left-handed pitching.
vs_rhpStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- batting against right-handed pitching.
leadoff_pctStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- leadoff batters reaching base; despite the name it is a pair string, not a percentage.
rbi3rdStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- chances to drive in a runner from third.
h_pinchitStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- pinch-hitting appearances.
adv_opsStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- advancing-opportunity situations.
with_2_outsStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- plate appearances with two outs.
with_runrs2StringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- secondary runners-on split emitted by the feed.
with_scorepos2StringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- secondary runners-in-scoring-position split emitted by the feed.
bases_emptyStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- plate appearances with the bases empty.
bases_loadedStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- plate appearances with the bases loaded.
categoryStringCategory label.
sourceStringSource.
espn_game_idString
game_keyStringNCAA contest identifier for the game the row belongs to; the join key to the other ncaa_baseball_* tables.
game_dateStringGame date (YYYY-MM-DD).
locationStringTeam city/region (e.g. "Los Angeles").
attendanceInt64Reported attendance (NA on the redesigned page).
runnersStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- plate appearances with runners on base.
vs_lhbStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- pitching against left-handed batters.
with_2outsStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- two-out split under the feed's second, unpunctuated key (distinct column from with_2_outs).
emtpyStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- bases-empty split under the upstream feed's misspelled key ('emtpy', sic).
with_scoreposStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- plate appearances with runners in scoring position.
with_runners2StringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- secondary runners-on split emitted by the feed alongside with_runrs2.
vs_rhbStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- pitching against right-handed batters.
field_pctStringSituational split as a 'successes-opportunities' pair string (e.g. '5-13'), not a numeric rate -- fielding chances handled cleanly; despite the name it is a pair string, not a fielding percentage.
seasonInt64Season year.
load_ncaa_baseball_situational_stats(seasons=2025)

load_ncaa_baseball_games​

Release: ncaa_baseball_games · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_baseball_games/ncaa_baseball_games_{season}.parquet

Returns​

col_nametypedescription
game_keyStringNCAA contest identifier for the game the row belongs to; the join key to the other ncaa_baseball_* tables.
contest_idStringstats.ncaa.org contest (game) identifier.
game_pbp_idInt64stats.ncaa.org play-by-play (contest) identifier.
seasonInt64Season year.
sourceStringSource.
espn_game_idString
away_teamStringAway team name.
away_finalInt64Final runs scored by the away team.
home_teamStringHome team name.
home_finalInt64Final runs scored by the home team.
load_ncaa_baseball_games(seasons=2024)

load_ncaa_baseball_groups​

Release: ncaa_baseball_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_baseball_groups/ncaa_baseball_groups.parquet

Coverage

One season-less file: one row per group lineage (the league, subdivisions, conferences, divisions) with the first and last season it had members. group_id is SDV's own id (e.g. ncaa_baseball:acc) and names a lineage: a rename that keeps continuity keeps the id, a new body gets a new one, and notes records each call. Seasons are the calendar year.

Returns​

col_nametypedescription
leagueStringLeague code of the table ("ncaa_baseball"); the prefix of every group_id in it.
group_idStringSDV group id, {league}:{slug}. It names a lineage: renames that keep continuity keep the id, and a new body (a new conference, or a merger the sources treat as new) gets a new one.
levelStringHierarchy level of the group: "league", "subdivision", "conference" or "division".
first_seasonInt32First season in which the group had at least one member (calendar year).
last_seasonInt32Last season in which the group had at least one member (calendar year).
notesStringBuilder notes on the group: the lineage decisions behind its group_id and any source caveats.
load_ncaa_baseball_groups()

load_ncaa_baseball_group_seasons​

Release: ncaa_baseball_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_baseball_groups/ncaa_baseball_group_seasons.parquet

Coverage

One season-less file: one row per group per season it existed, with its name, short name, abbreviation and parent group AS OF that season (never today's label applied to the past) and its member count. season is the calendar year.

Returns​

col_nametypedescription
leagueStringLeague code of the table ("ncaa_baseball"); the prefix of every group_id in it.
group_idStringSDV group id, {league}:{slug}. It names a lineage: renames that keep continuity keep the id, and a new body (a new conference, or a merger the sources treat as new) gets a new one.
seasonInt32Season the row describes (calendar year).
levelStringHierarchy level of the group: "league", "subdivision", "conference" or "division".
nameStringFull name of the group as of that season -- the label in use then, not today's name.
short_nameStringShort display name of the group as of that season.
abbreviationStringAbbreviation of the group as of that season.
parent_group_idStringgroup_id one level up as of that season (division -> conference -> subdivision -> league); null at the top level or where no higher group applied that season.
n_teamsInt32Number of member teams in the group that season.
load_ncaa_baseball_group_seasons()

load_ncaa_baseball_group_aliases​

Release: ncaa_baseball_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_baseball_groups/ncaa_baseball_group_aliases.parquet

Coverage

One season-less file: every name, abbreviation, slug and source id that a source (ncaa, sdv) uses for a group, each with the seasons it is valid for (valid_from / valid_to, inclusive; null = unbounded). Match a source's conference or division label here to reach group_id.

Returns​

col_nametypedescription
leagueStringLeague code of the table ("ncaa_baseball"); the prefix of every group_id in it.
group_idStringSDV group id, {league}:{slug}. It names a lineage: renames that keep continuity keep the id, and a new body (a new conference, or a merger the sources treat as new) gets a new one.
sourceStringSource that uses this label or id (in this table: ncaa, sdv); "sdv" marks SDV's own labels.
source_idStringThe source's own id for the group (ESPN group id, NCAA conf_id, CFBD id, MLB division id) when it has one; null otherwise.
name_kindStringKind of label in value: "name", "short_name", "abbreviation", "slug" or "code".
valueStringThe label exactly as the source writes it; match a source's conference or division label against it to reach group_id.
valid_fromInt32First season the alias is valid for, inclusive (calendar year); null = unbounded.
valid_toInt32Last season the alias is valid for, inclusive (calendar year); null = unbounded (still in use).
load_ncaa_baseball_group_aliases()

load_ncaa_baseball_team_group_seasons​

Release: ncaa_baseball_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/ncaa_baseball_groups/ncaa_baseball_team_group_seasons_{season}.parquet

Coverage

One row per team per season: the SDV subdivision, conference and division group ids the team belonged to that season (null where a level does not apply), the team name as of that season, where the membership came from, and whether a second source agreed (null when only one source covers the season). team_id is a string: the stats.ncaa.org org id (not an ESPN id); team_id_source names the id space. season is the calendar year; seasons 2010-2026.

Returns​

col_nametypedescription
leagueStringLeague code of the table ("ncaa_baseball"); the prefix of every group_id in it.
seasonInt32Season of the membership (calendar year).
team_idStringTeam id as a string: the ESPN team id where ESPN covers the team, otherwise the league's own id; team_id_source says which.
team_id_sourceStringId space of team_id (in this table: ncaa_org).
team_nameStringTeam name as of that season, not today's.
subdivision_idStringSDV group_id of the team's subdivision that season (e.g. FBS / FCS, Division I); null where the league has no subdivision level.
conference_idStringSDV group_id of the team's conference that season; null where the team had no conference (an independent, or a season played without conferences).
division_idStringSDV group_id of the team's division that season; null where the level does not apply.
sourceStringSource the membership was taken from -- the most reliable per-season source for that era.
sources_agreeBooleanWhether a second source agreed on the membership; null when only one source covers the season.
notesStringBuilder notes on the team-season, such as a source disagreement or which of several listed memberships was kept.
load_ncaa_baseball_team_group_seasons(seasons=2024)