联赛列表 - AnySport

返回联赛/赛事目录，可按 country_id 或 league_id 过滤，is_cup 用于区分常规联赛与杯赛/国际赛事（如世界杯）。league_id 是下游绝大多数接口（赛程、积分榜、射手榜、赛季列表等）的必需过滤参数，接入时通常先调用本接口（或结合 01 国家列表）拿到目标联赛的 league_id，再用它去查赛季列表获取该联赛的可用 season。数据基本静态，可本地缓存。

接口路径

GET /v1/soccer/leagues

入参说明

参数	类型	必填	说明
`country_id`	string	否	按国家过滤（`asx_`）
`league_id`	string	否	按联赛过滤（`asl_`）
`lang`	string	否	`en` / `zh-CN`，非法值静默回退默认语言，可选值以 `GET /languages`（19）为准
`page` / `limit`	int	否	分页，limit 范围 1~100

出参说明（data: 数组）

字段	类型	说明
`league_id`	string	联赛 ID（`asl_` 前缀）
`name`	string	联赛名
`country`	string	所属国家/地区
`country_id`	string	国家 ID（`asx_`）
`is_cup`	boolean	是否杯赛

入参示例

GET /v1/soccer/leagues?league_id=asl_62db9cfc3ebf4b87a44570b16668b23e&lang=en

出参示例

HTTP

{
  "success": true,
  "data": [
    {
      "league_id": "asl_62db9cfc3ebf4b87a44570b16668b23e",
      "name": "World Cup",
      "country": "WorldCup",
      "country_id": "asx_ef78ccd2f0cc469f92a2fc4c1d93fa8b",
      "is_cup": true
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "limit": 50,
    "total_pages": 1,
    "timestamp": "2026-07-13T19:18:22.816896900Z"
  },
  "traceId": "6bfef83a-68e2-4106-8d93-f2f8991870db"
}