DocsAPI ReferenceMCPSDKs
AltSportsData
Discovery
Route Guide

Search Leagues

Search leagues by name, sport, or attributes

Route Reference

Method, path, and environment

GETAuthenticate with X-API-Key
Full route
https://api.altsportsdata.com/api/v1/public/discovery/search
Base URL
https://api.altsportsdata.com
Testing Flow

Use the right pane to validate the route

01

Choose a language and confirm the environment or base URL.

02

Paste your API key, then fill in path or query parameters.

03

Run the request and inspect the live response without leaving this page.

Query Parameters

qstringrequired

Search query

soccer
limitinteger

Max results (default: 20)

20

Responses

200

OK

Response body

{"data": [{"id": "premier-league", "name": "Premier League", "sport": "Soccer", "relevance": 0.98}]}
400

One of the request parameters is invalid. See the returned message for details.

401

Authentication headers are missing or invalid. Make sure you authenticate your request with a valid API key.

403

The requested resource is forbidden.

429

Too many requests. You hit the rate limit. Use the X-RateLimit headers to confirm when you can retry.

500

Internal server error. Retry later, and contact support if the issue persists.