search.search_teams()
Search for teams
Signature
import vlrdevapi as vlr
result = vlr.search.search_teams(
query: str,
timeout: float = 5.0
) -> list[SearchTeamResult]Parameters
Prop
Type
Return Value
Type: list[SearchTeamResult]
Returns a list of team search results.
Prop
Type
Examples
Search for Teams
import vlrdevapi as vlr
# Search for teams
teams = vlr.search.search_teams("sentinels")
print(f"Found {len(teams)} teams")
for t in teams:
status = "Inactive" if t.is_inactive else "Active"
print(f"{t.name} - {t.country} ({status})")
print(f" URL: {t.url}")Get Team Details
import vlrdevapi as vlr
import time
# Search and get full info
teams = vlr.search.search_teams("nrg")
for team in teams:
print(f"\nFound: {team.name}")
# Get detailed team info
team_info = vlr.teams.info(team.team_id)
roster = vlr.teams.roster(team.team_id)
if team_info:
print(f" Country: {team_info.country}")
print(f" Active: {team_info.is_active}")
print(f" Players: {len(roster)}")
if roster:
print(f" Roster: {', '.join(p.ign for p in roster[:5] if p.ign)}")
time.sleep(1) # Small delay to avoid overwhelming the serverFilter Active Teams
import vlrdevapi as vlr
# Search and filter for active teams only
all_teams = vlr.search.search_teams("valorant")
active_teams = [t for t in all_teams if not t.is_inactive]
print(f"Active teams: {len(active_teams)}/{len(all_teams)}")
for team in active_teams:
print(f" {team.name} - {team.country}")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.
Tips
- Team results are enriched with
teams.info()when available to fix name/country and set active status - Check list length before accessing results:
if teams: - All optional fields can be
None- check before using - Use the
team_idto fetch detailed information withteams.info() - The
is_inactivefield is always present (defaults toFalse)
Related
search.search()
Unified search across all types
search.search_players()
Search for players
search.search_events()
Search for events
Source
Data scraped from: https://www.vlr.gg/search/?q={query}&type=teams