playerelo APIplayerelo.football ↗

"""Walkthrough: PlayerElo Football API — browse leaderboard, search, and drill into full profiles."""
from parse_apis.playerelo_football_api import PlayerElo, PlayerNotFound

client = PlayerElo()

# Browse the global leaderboard — top 5 players by Elo.
for entry in client.leaderboard_entries.list(limit=5):
    print(f"#{entry.rank} {entry.player_name} ({entry.team}) — Elo {entry.elo}, 28d change: {entry.elo_change_28d}")

# Search for a player by name and drill into their full profile.
result = client.player_summaries.search(query="Haaland", limit=1).first()
if result is not None:
    player = result.details()
    print(f"\n{player.player_name} — {player.current_team}, {player.current_league}")
    print(f"  Elo: {player.current_elo} (peak: {player.peak_elo} on {player.peak_elo_date})")
    print(f"  EAR career: {player.ear_career} ({player.ear_label})")
    print(f"  Games played: {player.games_played}")

    # Show the most recent matches from rating history.
    for match in player.rating_history[-3:]:
        print(f"  {match.date}: {match.team} vs {match.opponent} ({match.result}) — Elo {match.elo_change:+.1f}")

# Get top players for a specific team.
for tp in client.team_players.list(team="Arsenal", limit=3):
    print(f"  #{tp.team_rank} {tp.player_name} ({tp.position}) — Elo {tp.elo}, global #{tp.global_rank}")

# Point lookup by known ID with error handling.
try:
    specific = client.players.get(player_id="1100")
    print(f"\nDirect lookup: {specific.player_name}, rank #{specific.current_rank}")
except PlayerNotFound as e:
    print(f"Player not found: {e.player_id}")

print("\nexercised: leaderboard_entries.list / player_summaries.search / details / team_players.list / players.get")