AltSportsLeagues Python SDK

Python SDK for AltSportsLeagues.ai — discover, evaluate, and integrate with 150+ alternative sports leagues worldwide.

Installation

pip install altsportsleagues

Quick Start

from altsportsleagues import AltSportsLeagues

# Initialize (or set ALTSPORTSLEAGUES_API_KEY env var)
client = AltSportsLeagues(api_key="your_api_key")

# Browse leagues
leagues = client.leagues.list(limit=10)
for league in leagues:
    print(f"{league.name}  [{league.tier}]  {league.sport}")

# Get a specific league
league = client.leagues.get("premier-lacrosse-league")
print(league.name, league.tier, league.country)

# Evaluate a league's business value
valuation = client.valuations.evaluate(league_id="premier-lacrosse-league")
print(f"Tier: {valuation.tier}")
print(f"Annual Value: ${valuation.estimated_annual_value:,.0f}")
print(f"Confidence: {valuation.confidence}%")

# See tier definitions
for tier in client.valuations.tiers():
    print(tier)

Filtering & Search

# Filter by sport bucket
combat = client.leagues.list(sport_bucket="combat")
racing = client.leagues.list(sport_bucket="racing")

# Filter by tier
elite = client.leagues.list(tier="tier-1")

# Search by name
results = client.leagues.list(search="lacrosse")

# Find similar leagues
similar = client.leagues.similar("premier-lacrosse-league")

Valuations

# Evaluate with default weights
val = client.valuations.evaluate(league_id="premier-lacrosse-league")

# Evaluate with custom weights
val = client.valuations.evaluate(
    league_id="premier-lacrosse-league",
    custom_weights={
        "market_size": 0.25,
        "technical_feasibility": 0.20,
        "growth_potential": 0.15,
        "revenue_opportunity": 0.20,
        "strategic_fit": 0.10,
        "competitive_landscape": 0.05,
        "risk_factor": 0.05,
    }
)

# Evaluate ad-hoc league data (no league_id needed)
val = client.valuations.evaluate(
    league_data={
        "leagueName": "My New League",
        "primarySport": "Pickleball",
        "numberOfTeams": 16,
        "region": "North America",
    }
)

Platform Statistics

stats = client.leagues.stats()
print(f"Total leagues: {stats.total_leagues}")
print(f"Tiers: {stats.tier_breakdown}")
print(f"Sports: {stats.sport_bucket_breakdown}")

Error Handling

from altsportsleagues import (
    AltSportsLeagues,
    AuthenticationError,
    NotFoundError,
    RateLimitError,
)

client = AltSportsLeagues(api_key="your_key")

try:
    league = client.leagues.get("nonexistent-league")
except NotFoundError:
    print("League not found")
except AuthenticationError:
    print("Invalid API key")
except RateLimitError as e:
    print(f"Rate limited — retry after {e.retry_after}s")

Configuration

import os

# Via environment variable
os.environ["ALTSPORTSLEAGUES_API_KEY"] = "your_key"
client = AltSportsLeagues()  # picks up env var automatically

# Custom base URL (for self-hosted or staging)
client = AltSportsLeagues(
    api_key="your_key",
    base_url="https://staging-api.altsportsleagues.ai",
    timeout=60,
)

API Resources

Links

• Homepage
• API Docs
• PyPI

License

MIT