Baseball-Reference APIbaseball-reference.com ↗

"""Walkthrough: Baseball-Reference SDK — bounded, re-runnable; every call capped."""
from parse_apis.baseball_reference_api import (
    BaseballReference, LeaderCategory, TeamId, ResourceNotFound
)

client = BaseballReference()

# Get a player's career stats by their Baseball-Reference ID.
player = client.players.get(player_id="ohtansh01")
print(f"Player: {player.name}, Born: {player.birth_date}, Bats/Throws: {player.bats_throws}")

# Inspect batting seasons — each row is one year of stats.
for season in player.batting_stats[:3]:
    print(f"  {season.year_id} ({season.team_name_abbr}): {season.b_hr} HR, {season.b_batting_avg} AVG")

# Get 2024 batting leaders using the LeaderCategory enum.
board = client.leaderboards.get(year=2024)
print(f"\n2024 {board.category} leaders:")
for stat_name, entries in list(board.leaders.items())[:2]:
    top = entries[0]
    print(f"  {stat_name}: {top.player} ({top.team}) — {top.value}")

# Construct a team by abbreviation and fetch its schedule.
dodgers = client.team(team_id=TeamId.LAD)
sched = dodgers.schedule(year=2024)
first_game = sched.schedule[0]
print(f"\nFirst game: vs {first_game.opp_ID}, Result: {first_game.win_loss_result} ({first_game.R}-{first_game.RA})")

# Typed-error catch: look up a non-existent player.
try:
    client.players.get(player_id="nonexist99")
except ResourceNotFound as exc:
    print(f"\nExpected error caught: {exc}")

# College: list SEC conference teams, then get one team's pitching.
sec = client.conferences.get(league_id="82d1384a")
print(f"\n{sec.league_name} — {len(sec.teams)} teams")
first_team_entry = sec.teams[0]
college_team = client.collegeteams.get(team_id=first_team_entry.id)
for pitcher in college_team.pitching[:2]:
    print(f"  {pitcher.player}: {pitcher.W}W-{pitcher.L}L, {pitcher.earned_run_avg} ERA")

print("\nExercised: players.get / leaderboards.get / team.schedule / conferences.get / collegeteams.get")