AltSportsLeagues
API ReferenceDiscovery

Search Leagues

Search for leagues using full-text search

Search Leagues

GET /v1/discovery/search

Search for leagues across the discovery database using full-text search. Returns matching leagues with relevance scoring.

Query Parameters

ParameterTypeRequiredDescription
querystringYesSearch query string
sportstringNoFilter by sport type
limitintegerNoMaximum results (default: 20)

Request

cURL
curl -X GET "https://api.altsportsleagues.ai/v1/discovery/search?query=indoor+lacrosse&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

200 OK
{
  "data": [
    {
      "id": "league_nll_001",
      "name": "National Lacrosse League",
      "sport": "lacrosse",
      "tier": "2.1",
      "relevance_score": 0.96
    }
  ],
  "meta": {
    "total": 1,
    "api_version": "v1",
    "timestamp": "2026-03-07T21:00:00Z"
  }
}

On this page