足球 API 比赛-统计列表接口文档

接口说明

建议每秒更新

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

请求头与鉴权

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

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

请求参数

Query 查询参数

无需额外查询参数。

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

调用示例

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

cURL

curl --get 'https://api.superscore.cn/football/change/statsList' \
  --header 'token: YOUR_MERCHANT_KEY'

JavaScript / Node.js

// 仅在服务端保存商户密钥；替换示例占位值。
const url = new URL("https://api.superscore.cn/football/change/statsList");
url.search = new URLSearchParams({});
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 = {}
headers = {
  "token": "YOUR_MERCHANT_KEY"
}
url = "https://api.superscore.cn/football/change/statsList"
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 均按接口定义列出。

字段路径	类型	说明与枚举
`success`	boolean	状态码
`code`	string	状态编号
`message`	string	描述
`data`	array	数据
`data[].minute`	string	分钟
`data[].second`	string	秒
`data[].overtime`	string	加时
`data[].startTime`	int64	上下半场开始时间
`data[].homeTeam`	object	主队
`data[].homeTeam.possession`	string	控球率
`data[].homeTeam.shotOn`	int32	射正
`data[].homeTeam.shotOff`	int32	射偏
`data[].homeTeam.corner`	int32	角球
`data[].homeTeam.yellow`	int32	黄牌
`data[].homeTeam.red`	int32	红牌
`data[].homeTeam.penalty`	int32	点球
`data[].homeTeam.attacks`	int32	进攻
`data[].homeTeam.dangerousAttacks`	int32	危险进攻
`data[].homeTeam.assists`	int32	助攻
`data[].homeTeam.headers`	int32	头球
`data[].homeTeam.turnovers`	int32	丟球
`data[].homeTeam.saves`	int32	救球
`data[].homeTeam.ownGoals`	int32	乌龙
`data[].homeTeam.throwIn`	int32	界外球
`data[].homeTeam.goalKick`	int32	球门球
`data[].homeTeam.tackles`	int32	成功抢断
`data[].homeTeam.blocks`	int32	阻截
`data[].homeTeam.longPasses`	int32	长传
`data[].homeTeam.shortPasses`	int32	短传
`data[].homeTeam.crosses`	int32	成功传中
`data[].homeTeam.fouls`	int32	犯规
`data[].homeTeam.offside`	int32	越位
`data[].homeTeam.goalkeeperSaves`	int32	守门员出击
`data[].awayTeam`	object	客队
`data[].awayTeam.possession`	string	控球率
`data[].awayTeam.shotOn`	int32	射正
`data[].awayTeam.shotOff`	int32	射偏
`data[].awayTeam.corner`	int32	角球
`data[].awayTeam.yellow`	int32	黄牌
`data[].awayTeam.red`	int32	红牌
`data[].awayTeam.penalty`	int32	点球
`data[].awayTeam.attacks`	int32	进攻
`data[].awayTeam.dangerousAttacks`	int32	危险进攻
`data[].awayTeam.assists`	int32	助攻
`data[].awayTeam.headers`	int32	头球
`data[].awayTeam.turnovers`	int32	丟球
`data[].awayTeam.saves`	int32	救球
`data[].awayTeam.ownGoals`	int32	乌龙
`data[].awayTeam.throwIn`	int32	界外球
`data[].awayTeam.goalKick`	int32	球门球
`data[].awayTeam.tackles`	int32	成功抢断
`data[].awayTeam.blocks`	int32	阻截
`data[].awayTeam.longPasses`	int32	长传
`data[].awayTeam.shortPasses`	int32	短传
`data[].awayTeam.crosses`	int32	成功传中
`data[].awayTeam.fouls`	int32	犯规
`data[].awayTeam.offside`	int32	越位
`data[].awayTeam.goalkeeperSaves`	int32	守门员出击
`data[].updateTime`	int64	更新时间
`data[].matchId`	int32	比赛ID
`data[].status`	int32	比赛状态
`data[].animationId`	int32	动画ID
`data[].homePlayer`	array	主队球员统计
`data[].homePlayer[].playerId`	int32	球员ID
`data[].homePlayer[].nameEn`	string	球员名称（英文）
`data[].homePlayer[].nameZh`	string	球员名称（中文）
`data[].homePlayer[].image`	string	球员图片
`data[].homePlayer[].number`	string	号码
`data[].homePlayer[].position`	int32	位置：1守门员,2后卫,3中场,4前锋
`data[].homePlayer[].goals`	int32	进球
`data[].homePlayer[].assists`	int32	助攻
`data[].homePlayer[].shots`	int32	射门
`data[].homePlayer[].shotsOnTarget`	int32	射正
`data[].homePlayer[].keyPasses`	int32	关键传球
`data[].homePlayer[].passes`	int32	传球
`data[].homePlayer[].passesSuccessful`	int32	传球成功
`data[].homePlayer[].tackles`	int32	抢断
`data[].homePlayer[].interceptions`	int32	拦截
`data[].homePlayer[].clearances`	int32	解围
`data[].homePlayer[].fouls`	int32	犯规
`data[].homePlayer[].foulsDrawn`	int32	被犯规
`data[].homePlayer[].yellowCards`	int32	黄牌
`data[].homePlayer[].redCards`	int32	红牌
`data[].homePlayer[].rating`	string	评分
`data[].awayPlayer`	array	客队球员统计
`data[].awayPlayer[].playerId`	int32	球员ID
`data[].awayPlayer[].nameEn`	string	球员名称（英文）
`data[].awayPlayer[].nameZh`	string	球员名称（中文）
`data[].awayPlayer[].image`	string	球员图片
`data[].awayPlayer[].number`	string	号码
`data[].awayPlayer[].position`	int32	位置：1守门员,2后卫,3中场,4前锋
`data[].awayPlayer[].goals`	int32	进球
`data[].awayPlayer[].assists`	int32	助攻
`data[].awayPlayer[].shots`	int32	射门
`data[].awayPlayer[].shotsOnTarget`	int32	射正
`data[].awayPlayer[].keyPasses`	int32	关键传球
`data[].awayPlayer[].passes`	int32	传球
`data[].awayPlayer[].passesSuccessful`	int32	传球成功
`data[].awayPlayer[].tackles`	int32	抢断
`data[].awayPlayer[].interceptions`	int32	拦截
`data[].awayPlayer[].clearances`	int32	解围
`data[].awayPlayer[].fouls`	int32	犯规
`data[].awayPlayer[].foulsDrawn`	int32	被犯规
`data[].awayPlayer[].yellowCards`	int32	黄牌
`data[].awayPlayer[].redCards`	int32	红牌
`data[].awayPlayer[].rating`	string	评分

响应结构示例

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

展开完整 JSON 结构

{
  "success": false,
  "code": "示例字符串",
  "message": "示例字符串",
  "data": [
    {
      "minute": "示例字符串",
      "second": "示例字符串",
      "overtime": "示例字符串",
      "startTime": 0,
      "homeTeam": {
        "possession": "示例字符串",
        "shotOn": 0,
        "shotOff": 0,
        "corner": 0,
        "yellow": 0,
        "red": 0,
        "penalty": 0,
        "attacks": 0,
        "dangerousAttacks": 0,
        "assists": 0,
        "headers": 0,
        "turnovers": 0,
        "saves": 0,
        "ownGoals": 0,
        "throwIn": 0,
        "goalKick": 0,
        "tackles": 0,
        "blocks": 0,
        "longPasses": 0,
        "shortPasses": 0,
        "crosses": 0,
        "fouls": 0,
        "offside": 0,
        "goalkeeperSaves": 0
      },
      "awayTeam": {
        "possession": "示例字符串",
        "shotOn": 0,
        "shotOff": 0,
        "corner": 0,
        "yellow": 0,
        "red": 0,
        "penalty": 0,
        "attacks": 0,
        "dangerousAttacks": 0,
        "assists": 0,
        "headers": 0,
        "turnovers": 0,
        "saves": 0,
        "ownGoals": 0,
        "throwIn": 0,
        "goalKick": 0,
        "tackles": 0,
        "blocks": 0,
        "longPasses": 0,
        "shortPasses": 0,
        "crosses": 0,
        "fouls": 0,
        "offside": 0,
        "goalkeeperSaves": 0
      },
      "updateTime": 0,
      "matchId": 0,
      "status": 0,
      "animationId": 0,
      "homePlayer": [
        {
          "playerId": 0,
          "nameEn": "示例字符串",
          "nameZh": "示例字符串",
          "image": "示例字符串",
          "number": "示例字符串",
          "position": 0,
          "goals": 0,
          "assists": 0,
          "shots": 0,
          "shotsOnTarget": 0,
          "keyPasses": 0,
          "passes": 0,
          "passesSuccessful": 0,
          "tackles": 0,
          "interceptions": 0,
          "clearances": 0,
          "fouls": 0,
          "foulsDrawn": 0,
          "yellowCards": 0,
          "redCards": 0,
          "rating": "示例字符串"
        }
      ],
      "awayPlayer": [
        {
          "playerId": 0,
          "nameEn": "示例字符串",
          "nameZh": "示例字符串",
          "image": "示例字符串",
          "number": "示例字符串",
          "position": 0,
          "goals": 0,
          "assists": 0,
          "shots": 0,
          "shotsOnTarget": 0,
          "keyPasses": 0,
          "passes": 0,
          "passesSuccessful": 0,
          "tackles": 0,
          "interceptions": 0,
          "clearances": 0,
          "fouls": 0,
          "foulsDrawn": 0,
          "yellowCards": 0,
          "redCards": 0,
          "rating": "示例字符串"
        }
      ]
    }
  ]
}

错误处理与使用说明

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