API Complete Reference

https://api.altsportsleagues.ai

// Firebase Auth Token
const token = await auth.currentUser.getIdToken()
 
// API Request
const response = await fetch('https://api.altsportsleagues.ai/v1/leagues', {
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  }
})

curl https://api.altsportsleagues.ai/

{
  "name": "AltSportsLeagues API",
  "version": "2.1.0",
  "status": "operational"
}

curl https://api.altsportsleagues.ai/health

{
  "status": "healthy",
  "timestamp": "2024-11-19T12:00:00Z"
}

curl https://api.altsportsleagues.ai/v1/leagues

{
  "leagues": [
    {
      "id": "nba",
      "name": "National Basketball Association",
      "sport": "basketball",
      "region": "north_america",
      "teams_count": 30
    }
  ],
  "total": 100,
  "limit": 50,
  "offset": 0
}

curl https://api.altsportsleagues.ai/v1/leagues/nba

{
  "id": "nba",
  "name": "National Basketball Association",
  "sport": "basketball",
  "founded": 1946,
  "teams": 30,
  "players": 450,
  "stats": {
    "games_per_season": 82,
    "playoffs_teams": 16
  }
}

curl "https://api.altsportsleagues.ai/v1/leagues/discovery?query=basketball&region=na"

curl https://api.altsportsleagues.ai/v1/teams?league_id=nba

curl https://api.altsportsleagues.ai/v1/teams/lakers

curl https://api.altsportsleagues.ai/v1/players?team_id=lakers

curl https://api.altsportsleagues.ai/v1/players/lebron-james

curl https://api.altsportsleagues.ai/v1/stats?league_id=nba&season=2024

curl https://api.altsportsleagues.ai/v1/markets?live=true

curl https://api.altsportsleagues.ai/v1/sportsbook-coverage/sports

curl -X POST https://api.altsportsleagues.ai/v1/rag/query \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What are the top basketball leagues?",
    "top_k": 5
  }'

curl -X POST https://api.altsportsleagues.ai/v1/league-intelligence/partnership-opportunities \
  -H "Content-Type: application/json" \
  -d '{
    "league_id": "nba",
    "criteria": {
      "market_size": "large",
      "region": "north_america"
    }
  }'

{
  "detail": "Error message",
  "status_code": 400,
  "timestamp": "2024-11-19T12:00:00Z"
}

{
  "items": [...],
  "total": 100,
  "limit": 20,
  "offset": 0,
  "has_more": true
}

import { AltSportsLeaguesClient } from '@altsportsleagues/sdk'
 
const client = new AltSportsLeaguesClient({
  apiUrl: 'https://api.altsportsleagues.ai',
  token: await auth.currentUser.getIdToken()
})
 
// Get leagues
const leagues = await client.leagues.list()
 
// Get league details
const nba = await client.leagues.get('nba')
 
// Search
const results = await client.leagues.search({
  query: 'basketball',
  region: 'north_america'
})

from altsportsleagues import Client
 
client = Client(
    api_url="https://api.altsportsleagues.ai",
    token=firebase_token
)
 
# Get leagues
leagues = client.leagues.list()
 
# Get league details
nba = client.leagues.get("nba")
 
# Search
results = client.leagues.search(
    query="basketball",
    region="north_america"
)

curl https://api.altsportsleagues.ai/openapi.json > openapi.json