Skip to main content
Version: 0.1.5

MLB — MLB Stats API

sportsdataverse.mlb — 64 endpoints.

All​

FunctionSummary
mlb_all_star_ballotView All-Star Ballots per league.
mlb_all_star_write_insView All-Star Write-ins per league.
mlb_all_star_final_voteView All-Star Final Vote per league.

Draft​

FunctionSummary
mlb_draftGET /api/v1/draft/{year} — draft results for a year (optionally one round).
mlb_draft_latestView latest player drafted, endpoint best used when draft is currently open.

Game​

FunctionSummary
mlb_game_context_metricsGET /api/v1/game/{gamePk}/contextMetrics — WP, leverage index, in-game context.
mlb_game_contentGET /api/v1/game/{gamePk}/content — articles, highlights, editorial content.
mlb_game_timestampsRetrieve all of the play timecodes for a game in GUMBO feed.
mlb_game_changesView corrected non Statcast information for games
mlb_game_guidsView Statcast data for a specific game.
mlb_game_colorView game color commentary info.
mlb_game_color_diffView game color feed.
mlb_game_color_timestampsView all of the color timecodes for a game.
mlb_game_paceView time of game info.

Home​

FunctionSummary
mlb_home_run_derbyView a home run derby object based on gamePk.
mlb_home_run_derby_bracketView a home run derby object based on bracket.
mlb_home_run_derby_poolView a home run derby object based on pool.

Play​

FunctionSummary
mlb_play_by_playGET /api/v1/game/{gamePk}/playByPlay — play-by-play with at-bat detail.
mlb_play_analyticsView Statcast data for a specific play.
mlb_play_context_metrics_averagesView Statcast contextMetrics data for a specific play.

Schedule​

FunctionSummary
mlb_schedule_postseasonGET /api/v1/schedule/postseason — postseason-only schedule for a season.
mlb_schedule_tiedView tied game schedule info.
mlb_schedule_postseason_seriesView schedule info for postseason based on series.
mlb_schedule_postseason_tuneinView schedule info for the tuneIn application.

Team​

FunctionSummary
mlb_teamGET /api/v1/teams/{teamId} — single team detail.
mlb_team_rosterGET /api/v1/teams/{teamId}/roster — team roster.
mlb_team_alumniGET /api/v1/teams/{teamId}/alumni — players who played for this team in a season.
mlb_team_affiliatesGET /api/v1/teams/affiliates — org affiliates (MLB parent → minor league chain).
mlb_teams_historyView historical records for a list of teams.
mlb_teams_statsView team stats.
mlb_teams_stats_leadersView leaders for a statistic.
mlb_team_coachesView biographical information on all coaches for a given club.
mlb_team_personnelView biographical information on all personnel for a given club.
mlb_team_roster_typeView biographical and statistical information for a club's roster based on roster type.

Other​

FunctionSummary
mlb_pbpGET /api/v1.1/game/{gamePk}/feed/live — live firehose (v1.1).
mlb_boxscoreGET /api/v1/game/{gamePk}/boxscore — team + player boxscore for one game.
mlb_linescoreGET /api/v1/game/{gamePk}/linescore — inning-by-inning + current game state.
mlb_win_probabilityGET /api/v1/game/{gamePk}/winProbability — per-play WP timeline.
mlb_peopleGET /api/v1/people?personIds=... — bulk person lookup by MLBAM id.
mlb_personGET /api/v1/people/{personId} — single person detail.
mlb_person_game_statsGET /api/v1/people/{personId}/stats/game/{gamePk} — one player, one game.
mlb_sport_playersGET /api/v1/sports/{sportId}/players — every player in a sport for a season.
mlb_sportsGET /api/v1/sports — list known sports (MLB, MiLB, KBO, NPB, …).
mlb_leaguesGET /api/v1/leagues — list leagues.
mlb_seasonGET /api/v1/seasons/{seasonId} — single season detail.
mlb_venuesGET /api/v1/venues — list venues.
mlb_venueGET /api/v1/venues/{venueId} — single venue detail.
mlb_metaGET /api/v1/{metaType} — enum lookup (the API's self-describing surface).
mlb_awardsGET /api/v1/awards — list award IDs (call with no params to enumerate).
mlb_award_recipientsGET /api/v1/awards/{awardId}/recipients — historical winners of one award.
mlb_umpiresGET /api/v1/jobs/umpires — current umpire crew assignments.
mlb_conferencesView all PCL conferences.
mlb_conferenceView PCL conferences by conferenceId.
mlb_analytics_gamesView timestamps of most recent data corrections made to games.
mlb_analytics_guidsView timestamps of most recent data corrections made to GUIDs.
mlb_high_lowView high/low stats by player or team.
mlb_free_agentsView biographical information and stats for Free Agents.
mlb_jobsView directory by jobType.
mlb_datacastersView datacasters directory.
mlb_official_scorersView official scorer directory.
mlb_umpire_gamesGet umpires and associated game for umpireId.
mlb_seasons_allView information for all seasons based on id.
mlb_sportView information for any given sportId.
mlb_stats_metricsView Statcast stats.