VlrDevApi

teams.info()

Get team information

Signature

import vlrdevapi as vlr

result = vlr.teams.info(
    team_id: int,
    timeout: float = 5.0
) -> TeamInfo | None

Parameters

Prop

Type

Return Value

Type: TeamInfo | None

Returns team information or None if not found.

Prop

Type

Examples

Get Team Information

Get team information
import vlrdevapi as vlr

# Get team information
team = vlr.teams.info(team_id=1034)

if team:
    print(f"{team.name} ({team.tag})")
    print(f"Country: {team.country}")
    print(f"Active: {team.is_active}")
    
    # Show social links
    if team.socials:
        print("\nSocial Links:")
        for social in team.socials:
            print(f"  {social.label}: {social.url}")
else:
    print("Team not found")

Check Team Status

Check team status
import vlrdevapi as vlr

team = vlr.teams.info(team_id=1034)

if team:
    status = "Active" if team.is_active else "Inactive"
    print(f"{team.name} is {status}")
    
    # Check for team history
    if team.previous_team:
        print(f"Previously: {team.previous_team.name}")
    if team.current_team:
        print(f"Currently: {team.current_team.name}")

Get Multiple Teams

Get multiple teams
import vlrdevapi as vlr

team_ids = [1034, 2, 188]  # Example team IDs

for team_id in team_ids:
    team = vlr.teams.info(team_id)
    if team:
        print(f"{team.name} - {team.country} ({'Active' if team.is_active else 'Inactive'})")

Error Handling

  • Network failures: Returns None
  • Invalid team ID: Returns None
  • Team not found: Returns None

The function never raises exceptions, making it safe to use without try-catch blocks.

Tips

  • The socials field is always a list, never None - check with if team.socials:
  • All optional fields can be None - check before using
  • Use is_active to filter active teams
  • The previous_team and current_team fields track team renames/rebrands

Source

Data scraped from: https://www.vlr.gg/team/{team_id}