NCAA APIstats.ncaa.org ↗

"""NCAA Statistics API — search players, teams, coaches; view scoreboards and box scores."""
from parse_apis.NCAA_Statistics_API import NCAA, Sport, Division, PlayerNotFound

client = NCAA()

# Search players by name
for player in client.players.search(query="Williams", limit=5):
    team_names = ", ".join(t.team_name for t in player.teams) if player.teams else "N/A"
    print(f"{player.name} | seasons: {player.seasons} | teams: {team_names}")

# Search for a team by name
team = client.teams.search(term="Kentucky", limit=1).first()
if team:
    print(f"Team: {team.label} (vid={team.vid})")

# Search coaches filtered by sport enum
coach = client.coaches.search(query="Williams", sport=Sport.MBB, limit=1).first()
if coach:
    print(f"Coach: {coach.name} | record: {coach.wins}-{coach.losses} ({coach.wl_pct})")

# Get scoreboard games and drill into sub-resources
game = client.games.list(date="01/15/2025", sport=Sport.MBA, division=Division.D1, limit=1).first()
if game:
    print(f"{game.team1_name} {game.team1_score} vs {game.team2_name} {game.team2_score}")
    # Box score for that game
    for team_box in game.box_score.get(limit=2):
        print(f"  {team_box.team_name}: {len(team_box.players)} players")
    # Play-by-play
    play = game.plays.list(limit=1).first()
    if play:
        print(f"  Play: [{play.period}] {play.team} - {play.event} ({play.score})")

# Ranking categories for a sport/division
ranking = client.ranking_categories.list(sport=Sport.MBB, division=Division.D1, limit=1).first()
if ranking:
    print(f"Ranking: {ranking.stat_name} (seq={ranking.stat_seq})")

# Typed error handling
try:
    client.players.search(query="zzzzxyznonexistent", limit=1).first()
except PlayerNotFound as exc:
    print(f"Not found: {exc.query}")

print("exercised: players.search / teams.search / coaches.search / games.list / box_score.get / plays.list / ranking_categories.list")