VlrDevApi

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

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

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.

Source

Data scraped from: https://www.vlr.gg/player/{player_id}/?timespan={timespan}