账户
浏览产品与网站导航

联赛-积分榜

GET https://api.superscore.cn/football/statistics/standings

接口说明

按需请求

请求方式
GET
请求地址
https://api.superscore.cn/football/statistics/standings
Content-Type
application/x-www-form-urlencoded;charset=UTF-8

请求头与鉴权

字段类型必填文档示例值说明
tokenstring是传商户KEYtoken(传商户KEY)仅供测试,正式站请设置IP

商户密钥仅保存在自己的服务端。测试 token 与正式 IP 授权的适用范围以本表及账户授权说明为准。

请求参数

Query 查询参数

字段类型必填文档示例值说明
leagueIdint32是0联赛ID
seasonstring否—赛季（可选，不填取当前赛季）
stageIdint32否0阶段ID（可选）

示例值用于说明字段；比赛、球队、联赛等 ID 应从实际接口取得，不能直接使用占位值。字段中的日期、枚举、分页范围与更新建议完整保留原始说明。

调用示例

替换 YOUR_MERCHANT_KEY、YOUR_MATCH_ID 等占位值后，在已授权的服务端调用。示例不会在本页面发起真实请求。

cURL

curl --get 'https://api.superscore.cn/football/statistics/standings' \
  --header 'token: YOUR_MERCHANT_KEY' \
  --data-urlencode 'leagueId=YOUR_LEAGUE_ID' \
  --data-urlencode 'season=YOUR_SEASON' \
  --data-urlencode 'stageId=YOUR_STAGE_ID'

JavaScript / Node.js

// 仅在服务端保存商户密钥；替换示例占位值。
const url = new URL("https://api.superscore.cn/football/statistics/standings");
url.search = new URLSearchParams({
  "leagueId": "YOUR_LEAGUE_ID",
  "season": "YOUR_SEASON",
  "stageId": "YOUR_STAGE_ID"
});
const response = await fetch(url, {
  method: "GET",
  headers: {
  "token": "YOUR_MERCHANT_KEY"
}
});
if (!response.ok) throw new Error('HTTP ' + response.status);
const result = await response.json();
if (result.success !== true) throw new Error(String(result.message || result.code));
console.log(result.data);
Python 标准库示例
# 标准库示例；商户密钥仅保存在服务端。
import json
from urllib.parse import urlencode
from urllib.request import Request, urlopen

parameters = {
  "leagueId": "YOUR_LEAGUE_ID",
  "season": "YOUR_SEASON",
  "stageId": "YOUR_STAGE_ID"
}
headers = {
  "token": "YOUR_MERCHANT_KEY"
}
url = "https://api.superscore.cn/football/statistics/standings"
if parameters:
    url += '?' + urlencode(parameters)
with urlopen(Request(url, headers=headers, method="GET"), timeout=15) as response:
    result = json.load(response)
if not result.get('success'):
    raise RuntimeError(result.get('message') or result.get('code'))
print(result.get('data'))

返回参数

字段路径保留完整层级；[] 表示数组元素，<key> 表示按数据内容变化的映射键。success、code、message 与 data 均按接口定义列出。

字段路径类型说明与枚举
successboolean状态码
codestring状态编号
messagestring描述
dataobject数据
data.leagueIdint32联赛ID
data.seasonstring赛季
data.stageIdint32阶段/分组数据库ID (子联赛分组标识，0=主积分榜)
data.scoreColorarray颜色标签列表 (格式: #color|nameZh|nameZht|nameEn)
data.totalarray总积分榜 (type=1)
data.total[].rankint32排名
data.total[].teamIdint32球队ID
data.total[].teamobject球队数据
data.total[].team.teamIdint32球队ID
data.total[].team.typeint32类型：0俱乐部,1国家队
data.total[].team.nameEnstring球队名称（英文）
data.total[].team.nameShortEnstring球队短名称（英文）
data.total[].team.nameZhstring球队名称（中文）
data.total[].team.nameShortZhstring球队短名称（中文）
data.total[].team.nameZhtstring球队名称（繁体中文）
data.total[].team.nameShortZhtstring球队短名称（繁体中文）
data.total[].team.countryIdstring国家ID
data.total[].team.foundedstring成立时间
data.total[].team.venueIdint32球场ID
data.total[].team.imagestring球队图片
data.total[].team.coachIdint32教练ID
data.total[].playedint32场次
data.total[].wonint32胜
data.total[].drawnint32平
data.total[].lostint32负
data.total[].goalsForint32进球
data.total[].goalsAgainstint32失球
data.total[].goalDifferenceint32净胜球
data.total[].pointsint32积分
data.total[].colorIndexint32颜色索引 (对应scoreColor数组下标, 仅totalScore有)
data.total[].recentFormstring近6场战绩
data.homearray主场积分榜 (type=2)
data.home[].rankint32排名
data.home[].teamIdint32球队ID
data.home[].teamobject球队数据
data.home[].team.teamIdint32球队ID
data.home[].team.typeint32类型：0俱乐部,1国家队
data.home[].team.nameEnstring球队名称（英文）
data.home[].team.nameShortEnstring球队短名称（英文）
data.home[].team.nameZhstring球队名称（中文）
data.home[].team.nameShortZhstring球队短名称（中文）
data.home[].team.nameZhtstring球队名称（繁体中文）
data.home[].team.nameShortZhtstring球队短名称（繁体中文）
data.home[].team.countryIdstring国家ID
data.home[].team.foundedstring成立时间
data.home[].team.venueIdint32球场ID
data.home[].team.imagestring球队图片
data.home[].team.coachIdint32教练ID
data.home[].playedint32场次
data.home[].wonint32胜
data.home[].drawnint32平
data.home[].lostint32负
data.home[].goalsForint32进球
data.home[].goalsAgainstint32失球
data.home[].goalDifferenceint32净胜球
data.home[].pointsint32积分
data.home[].colorIndexint32颜色索引 (对应scoreColor数组下标, 仅totalScore有)
data.home[].recentFormstring近6场战绩
data.guestarray客场积分榜 (type=3)
data.guest[].rankint32排名
data.guest[].teamIdint32球队ID
data.guest[].teamobject球队数据
data.guest[].team.teamIdint32球队ID
data.guest[].team.typeint32类型：0俱乐部,1国家队
data.guest[].team.nameEnstring球队名称（英文）
data.guest[].team.nameShortEnstring球队短名称（英文）
data.guest[].team.nameZhstring球队名称（中文）
data.guest[].team.nameShortZhstring球队短名称（中文）
data.guest[].team.nameZhtstring球队名称（繁体中文）
data.guest[].team.nameShortZhtstring球队短名称（繁体中文）
data.guest[].team.countryIdstring国家ID
data.guest[].team.foundedstring成立时间
data.guest[].team.venueIdint32球场ID
data.guest[].team.imagestring球队图片
data.guest[].team.coachIdint32教练ID
data.guest[].playedint32场次
data.guest[].wonint32胜
data.guest[].drawnint32平
data.guest[].lostint32负
data.guest[].goalsForint32进球
data.guest[].goalsAgainstint32失球
data.guest[].goalDifferenceint32净胜球
data.guest[].pointsint32积分
data.guest[].colorIndexint32颜色索引 (对应scoreColor数组下标, 仅totalScore有)
data.guest[].recentFormstring近6场战绩
data.halfTotalarray半场总积分榜 (type=4)
data.halfTotal[].rankint32排名
data.halfTotal[].teamIdint32球队ID
data.halfTotal[].teamobject球队数据
data.halfTotal[].team.teamIdint32球队ID
data.halfTotal[].team.typeint32类型：0俱乐部,1国家队
data.halfTotal[].team.nameEnstring球队名称（英文）
data.halfTotal[].team.nameShortEnstring球队短名称（英文）
data.halfTotal[].team.nameZhstring球队名称（中文）
data.halfTotal[].team.nameShortZhstring球队短名称（中文）
data.halfTotal[].team.nameZhtstring球队名称（繁体中文）
data.halfTotal[].team.nameShortZhtstring球队短名称（繁体中文）
data.halfTotal[].team.countryIdstring国家ID
data.halfTotal[].team.foundedstring成立时间
data.halfTotal[].team.venueIdint32球场ID
data.halfTotal[].team.imagestring球队图片
data.halfTotal[].team.coachIdint32教练ID
data.halfTotal[].playedint32场次
data.halfTotal[].wonint32胜
data.halfTotal[].drawnint32平
data.halfTotal[].lostint32负
data.halfTotal[].goalsForint32进球
data.halfTotal[].goalsAgainstint32失球
data.halfTotal[].goalDifferenceint32净胜球
data.halfTotal[].pointsint32积分
data.halfTotal[].colorIndexint32颜色索引 (对应scoreColor数组下标, 仅totalScore有)
data.halfTotal[].recentFormstring近6场战绩
data.homeHalfarray半场主场积分榜 (type=5)
data.homeHalf[].rankint32排名
data.homeHalf[].teamIdint32球队ID
data.homeHalf[].teamobject球队数据
data.homeHalf[].team.teamIdint32球队ID
data.homeHalf[].team.typeint32类型：0俱乐部,1国家队
data.homeHalf[].team.nameEnstring球队名称（英文）
data.homeHalf[].team.nameShortEnstring球队短名称（英文）
data.homeHalf[].team.nameZhstring球队名称（中文）
data.homeHalf[].team.nameShortZhstring球队短名称（中文）
data.homeHalf[].team.nameZhtstring球队名称（繁体中文）
data.homeHalf[].team.nameShortZhtstring球队短名称（繁体中文）
data.homeHalf[].team.countryIdstring国家ID
data.homeHalf[].team.foundedstring成立时间
data.homeHalf[].team.venueIdint32球场ID
data.homeHalf[].team.imagestring球队图片
data.homeHalf[].team.coachIdint32教练ID
data.homeHalf[].playedint32场次
data.homeHalf[].wonint32胜
data.homeHalf[].drawnint32平
data.homeHalf[].lostint32负
data.homeHalf[].goalsForint32进球
data.homeHalf[].goalsAgainstint32失球
data.homeHalf[].goalDifferenceint32净胜球
data.homeHalf[].pointsint32积分
data.homeHalf[].colorIndexint32颜色索引 (对应scoreColor数组下标, 仅totalScore有)
data.homeHalf[].recentFormstring近6场战绩
data.guestHalfarray半场客场积分榜 (type=6)
data.guestHalf[].rankint32排名
data.guestHalf[].teamIdint32球队ID
data.guestHalf[].teamobject球队数据
data.guestHalf[].team.teamIdint32球队ID
data.guestHalf[].team.typeint32类型：0俱乐部,1国家队
data.guestHalf[].team.nameEnstring球队名称（英文）
data.guestHalf[].team.nameShortEnstring球队短名称（英文）
data.guestHalf[].team.nameZhstring球队名称（中文）
data.guestHalf[].team.nameShortZhstring球队短名称（中文）
data.guestHalf[].team.nameZhtstring球队名称（繁体中文）
data.guestHalf[].team.nameShortZhtstring球队短名称（繁体中文）
data.guestHalf[].team.countryIdstring国家ID
data.guestHalf[].team.foundedstring成立时间
data.guestHalf[].team.venueIdint32球场ID
data.guestHalf[].team.imagestring球队图片
data.guestHalf[].team.coachIdint32教练ID
data.guestHalf[].playedint32场次
data.guestHalf[].wonint32胜
data.guestHalf[].drawnint32平
data.guestHalf[].lostint32负
data.guestHalf[].goalsForint32进球
data.guestHalf[].goalsAgainstint32失球
data.guestHalf[].goalDifferenceint32净胜球
data.guestHalf[].pointsint32积分
data.guestHalf[].colorIndexint32颜色索引 (对应scoreColor数组下标, 仅totalScore有)
data.guestHalf[].recentFormstring近6场战绩

响应结构示例

下面的值仅展示字段类型，不是实时数据或真实调用结果。动态 map 的键取决于实际返回，不编造固定字段。

展开完整 JSON 结构
{
  "success": false,
  "code": "示例字符串",
  "message": "示例字符串",
  "data": {
    "leagueId": 0,
    "season": "示例字符串",
    "stageId": 0,
    "scoreColor": [],
    "total": [
      {
        "rank": 0,
        "teamId": 0,
        "team": {
          "teamId": 0,
          "type": 0,
          "nameEn": "示例字符串",
          "nameShortEn": "示例字符串",
          "nameZh": "示例字符串",
          "nameShortZh": "示例字符串",
          "nameZht": "示例字符串",
          "nameShortZht": "示例字符串",
          "countryId": "示例字符串",
          "founded": "示例字符串",
          "venueId": 0,
          "image": "示例字符串",
          "coachId": 0
        },
        "played": 0,
        "won": 0,
        "drawn": 0,
        "lost": 0,
        "goalsFor": 0,
        "goalsAgainst": 0,
        "goalDifference": 0,
        "points": 0,
        "colorIndex": 0,
        "recentForm": "示例字符串"
      }
    ],
    "home": [
      {
        "rank": 0,
        "teamId": 0,
        "team": {
          "teamId": 0,
          "type": 0,
          "nameEn": "示例字符串",
          "nameShortEn": "示例字符串",
          "nameZh": "示例字符串",
          "nameShortZh": "示例字符串",
          "nameZht": "示例字符串",
          "nameShortZht": "示例字符串",
          "countryId": "示例字符串",
          "founded": "示例字符串",
          "venueId": 0,
          "image": "示例字符串",
          "coachId": 0
        },
        "played": 0,
        "won": 0,
        "drawn": 0,
        "lost": 0,
        "goalsFor": 0,
        "goalsAgainst": 0,
        "goalDifference": 0,
        "points": 0,
        "colorIndex": 0,
        "recentForm": "示例字符串"
      }
    ],
    "guest": [
      {
        "rank": 0,
        "teamId": 0,
        "team": {
          "teamId": 0,
          "type": 0,
          "nameEn": "示例字符串",
          "nameShortEn": "示例字符串",
          "nameZh": "示例字符串",
          "nameShortZh": "示例字符串",
          "nameZht": "示例字符串",
          "nameShortZht": "示例字符串",
          "countryId": "示例字符串",
          "founded": "示例字符串",
          "venueId": 0,
          "image": "示例字符串",
          "coachId": 0
        },
        "played": 0,
        "won": 0,
        "drawn": 0,
        "lost": 0,
        "goalsFor": 0,
        "goalsAgainst": 0,
        "goalDifference": 0,
        "points": 0,
        "colorIndex": 0,
        "recentForm": "示例字符串"
      }
    ],
    "halfTotal": [
      {
        "rank": 0,
        "teamId": 0,
        "team": {
          "teamId": 0,
          "type": 0,
          "nameEn": "示例字符串",
          "nameShortEn": "示例字符串",
          "nameZh": "示例字符串",
          "nameShortZh": "示例字符串",
          "nameZht": "示例字符串",
          "nameShortZht": "示例字符串",
          "countryId": "示例字符串",
          "founded": "示例字符串",
          "venueId": 0,
          "image": "示例字符串",
          "coachId": 0
        },
        "played": 0,
        "won": 0,
        "drawn": 0,
        "lost": 0,
        "goalsFor": 0,
        "goalsAgainst": 0,
        "goalDifference": 0,
        "points": 0,
        "colorIndex": 0,
        "recentForm": "示例字符串"
      }
    ],
    "homeHalf": [
      {
        "rank": 0,
        "teamId": 0,
        "team": {
          "teamId": 0,
          "type": 0,
          "nameEn": "示例字符串",
          "nameShortEn": "示例字符串",
          "nameZh": "示例字符串",
          "nameShortZh": "示例字符串",
          "nameZht": "示例字符串",
          "nameShortZht": "示例字符串",
          "countryId": "示例字符串",
          "founded": "示例字符串",
          "venueId": 0,
          "image": "示例字符串",
          "coachId": 0
        },
        "played": 0,
        "won": 0,
        "drawn": 0,
        "lost": 0,
        "goalsFor": 0,
        "goalsAgainst": 0,
        "goalDifference": 0,
        "points": 0,
        "colorIndex": 0,
        "recentForm": "示例字符串"
      }
    ],
    "guestHalf": [
      {
        "rank": 0,
        "teamId": 0,
        "team": {
          "teamId": 0,
          "type": 0,
          "nameEn": "示例字符串",
          "nameShortEn": "示例字符串",
          "nameZh": "示例字符串",
          "nameShortZh": "示例字符串",
          "nameZht": "示例字符串",
          "nameShortZht": "示例字符串",
          "countryId": "示例字符串",
          "founded": "示例字符串",
          "venueId": 0,
          "image": "示例字符串",
          "coachId": 0
        },
        "played": 0,
        "won": 0,
        "drawn": 0,
        "lost": 0,
        "goalsFor": 0,
        "goalsAgainst": 0,
        "goalDifference": 0,
        "points": 0,
        "colorIndex": 0,
        "recentForm": "示例字符串"
      }
    ]
  }
}

错误处理与使用说明

  1. 先检查 HTTP 状态，再解析 JSON；网络失败或非 JSON 响应不能当作成功。
  2. 业务响应 success 为 false 时，读取 code 和 message；不要把业务错误与 HTTP 状态混为一谈。
  3. 保存原始错误码、请求时间及接口路径用于排查，日志中移除商户密钥。
  4. 按该接口的数据更新建议、账户授权和调用频率请求；日期和时间戳单位以字段说明为准。
  5. 允许字段缺失或数据为空，按接口中的稳定 ID 关联资料，不依赖数组顺序。