VlrDevApi

search.search_players()

Search for players

Signature

import vlrdevapi as vlr

result = vlr.search.search_players(
    query: str,
    timeout: float = 5.0
) -> list[SearchPlayerResult]

Parameters

Prop

Type

Return Value

Type: list[SearchPlayerResult]

Returns a list of player search results.

Prop

Type

Examples

Search for Players

Search for players
import vlrdevapi as vlr

# Search for players
players = vlr.search.search_players("tenz")

print(f"Found {len(players)} players")
for p in players:
    print(f"{p.ign} ({p.real_name})")
    print(f"  Country: {p.country}")
    print(f"  URL: {p.url}")

Get Player Details

Get player details
import vlrdevapi as vlr

# Search and get full profile
players = vlr.search.search_players("aspas")

for player in players:
    print(f"\nFound: {player.ign}")
    
    # Get detailed profile
    profile = vlr.players.profile(player.player_id)
    if profile:
        print(f"  Real Name: {profile.real_name}")
        print(f"  Country: {profile.country}")
        if profile.current_teams:
            teams = ", ".join(t.name for t in profile.current_teams if t.name)
            print(f"  Current Teams: {teams}")

Error Handling

  • Network failures: Returns an empty list []
  • No results found: Returns an empty list []
  • Empty query: 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/search/?q={query}&type=players