StatMuse APIstatmuse.com ↗

"""Walkthrough: StatMuse SDK — ask sports questions, get structured stats."""
from parse_apis.statmuse_api import StatMuse, QueryFailed

client = StatMuse()

# Ask a general sports trivia question — returns a typed Answer.
answer = client.answers.ask(query="Who has the most points in NBA history?")
print(f"Q: {answer.query}")
print(f"A: {answer.answer}")

# Access structured stat tables from the answer.
for table in answer.tables:
    print(f"  Table: {table.title}, rows: {len(table.rows)}")

# Get a specific player's recent game log.
player_answer = client.answers.player_stats(player_name="Stephen Curry", timeframe="last 5 games")
print(f"\nPlayer query: {player_answer.query}")
print(f"Summary: {player_answer.answer}")
if player_answer.tables:
    first_row = player_answer.tables[0].rows[0]
    print(f"  First game: {first_row}")

# Get team info with a custom query type.
team_answer = client.answers.team_info(team_name="Lakers", query_type="historical record")
print(f"\nTeam query: {team_answer.query}")
print(f"Summary: {team_answer.answer}")

# Typed error handling — catch QueryFailed for bad queries.
try:
    client.answers.ask(query="xyznonexistent player stats career")
except QueryFailed as exc:
    print(f"\nQuery failed: {exc}")

# Autocomplete suggestions — discover players/teams before querying.
for section in client.suggestions.search(query="Giannis", limit=5):
    print(f"\nSection type: {section.type}")
    for s in section.suggestions:
        print(f"  {s.display} ({s.league}, {s.type})")

print("\nExercised: answers.ask / answers.player_stats / answers.team_info / suggestions.search")