players.agent_stats()
Get agent statistics for a player
Signature
import vlrdevapi as vlr
result = vlr.players.agent_stats(
player_id: int,
timespan: str = "all",
timeout: float = 5.0
) -> list[AgentStats]Parameters
Prop
Type
Return Value
Type: list[AgentStats]
Returns a list of agent statistics. Each AgentStats object contains:
Prop
Type
Examples
Get Agent Statistics
import vlrdevapi as vlr
# Get all-time agent stats
stats = vlr.players.agent_stats(player_id=123)
print("Agent Statistics:")
for s in stats:
if s.agent:
print(f"\n{s.agent}:")
print(f" Usage: {s.usage_count} times ({s.usage_percent * 100:.1f}%)" if s.usage_percent else "")
print(f" Rating: {s.rating}")
print(f" ACS: {s.acs}")
print(f" K/D: {s.kd}")Get Recent Stats with Timespan
import vlrdevapi as vlr
# Get last 90 days of stats
stats = vlr.players.agent_stats(player_id=123, timespan="90d")
print("Last 90 Days - Top Agents:")
for s in stats[:5]: # Top 5 agents
if s.agent and s.rating:
print(f"{s.agent}: {s.rating} rating, {s.acs} ACS")Error Handling
- Network failures: Returns an empty list
[] - Invalid player ID: Returns an empty list
[] - No stats available: Returns an empty list
[]
The function never raises exceptions, making it safe to use without try-catch blocks.
Related
Source
Data scraped from: https://www.vlr.gg/player/{player_id}/?timespan={timespan}