List leagues

GET /v1/leagues

Competitions, filterable by popularity, country or search.

Parameters

popular	optional	Set to 1 for popular leagues only.
country	optional	Filter by country id.
search	optional	Match on league name.
esports	optional	true \| false. Defaults to false (real football only); true returns the curated list of active esoccer (e-football) competitions instead.
lang	optional	Localize team & league names (21 languages besides English, e.g. zh-cn, ja, es, de, pt). Missing translations fall back to English.
page, per_page	optional	Pagination.

Example

GET /v1/leagues

curl https://api.5dollarfootballapi.com/v1/leagues
  -H "Authorization: Bearer fb_live_your_key"

{
  "success": 1,
  "data": [
    { "id": 39, "name": "Premier League", "short_name": "EPL", "country_id": 14, "is_popular": true, "has_standings": true },
    { "id": 61, "name": "La Liga", "short_name": "LL", "country_id": 26, "is_popular": true, "has_standings": true }
  ],
  "pagination": { "page": 1, "per_page": 50, "count": 2, "has_more": true }
}

Need a key? Create a free account — a working key is issued instantly, no card required.

← All documentation Pricing →