Olympics APIolympics.com ↗

"""Walkthrough: Olympics.com SDK — explore games, medals, disciplines, and athletes."""
from parse_apis.olympics_com_api import Olympics, GamesSlug, NotFound

client = Olympics()

# List all Olympic Games editions, take the first few
for game in client.games.list(limit=5):
    print(game.title, game.year, game.season)

# Construct a specific Game by slug and explore its disciplines
paris = client.game(slug="paris-2024")
for discipline in paris.disciplines.list(limit=5):
    print(discipline.title, discipline.slug)

# Get the medal table for Paris 2024
for entry in paris.medal_entries.list(limit=3):
    print(entry.country, entry.gold, entry.silver, entry.bronze, entry.total)

# List events for a discipline using the GamesSlug enum
event = client.events.list(games_slug=GamesSlug.PARIS_2024, discipline_slug="athletics", limit=1).first()
if event:
    print(event.title, event.gender)

# Get event results with medal winners
result = client.eventresults.list(games_slug=GamesSlug.TOKYO_2020, discipline_slug="swimming", limit=1).first()
if result:
    print(result.event_title)
    for award in result.awards:
        print(award.medal_type, award.athlete_name, award.country_code)

# Browse featured athletes and drill into a profile
preview = client.athletepreviews.list(limit=1).first()
if preview:
    try:
        athlete = preview.details()
        print(athlete.display_name, athlete.gender, athlete.year_of_birth)
        print(athlete.medals.GOLD, athlete.medals.SILVER, athlete.medals.BRONZE)
    except NotFound as exc:
        print(f"Athlete not found: {exc}")

print("exercised: games.list / game.disciplines.list / game.medal_entries.list / events.list / eventresults.list / athletepreviews.list / preview.details")