账户
浏览产品与网站导航

球队-球队统计、球员统计、联赛统计、荣誉、转会、伤病/停赛历史

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

接口说明

按需请求

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

请求头与鉴权

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

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

请求参数

Query 查询参数

字段类型必填文档示例值说明
teamIdint32是0球队ID

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

调用示例

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

cURL

curl --get 'https://api.superscore.cn/football/statistics/team' \
  --header 'token: YOUR_MERCHANT_KEY' \
  --data-urlencode 'teamId=YOUR_TEAM_ID'

JavaScript / Node.js

// 仅在服务端保存商户密钥；替换示例占位值。
const url = new URL("https://api.superscore.cn/football/statistics/team");
url.search = new URLSearchParams({
  "teamId": "YOUR_TEAM_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 = {
  "teamId": "YOUR_TEAM_ID"
}
headers = {
  "token": "YOUR_MERCHANT_KEY"
}
url = "https://api.superscore.cn/football/statistics/team"
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.teamobject球队基础信息
data.team.teamIdint32球队ID
data.team.typeint32类型：0俱乐部,1国家队
data.team.nameEnstring球队名称（英文）
data.team.nameShortEnstring球队短名称（英文）
data.team.nameZhstring球队名称（中文）
data.team.nameShortZhstring球队短名称（中文）
data.team.nameZhtstring球队名称（繁体中文）
data.team.nameShortZhtstring球队短名称（繁体中文）
data.team.countryIdstring国家ID
data.team.foundedstring成立时间
data.team.venueIdint32球场ID
data.team.imagestring球队图片
data.team.coachIdint32教练ID
data.statsobject球队统计
data.stats.playedint32场次
data.stats.wonint32胜
data.stats.drawnint32平
data.stats.lostint32负
data.stats.goalsForint32进球
data.stats.goalsAgainstint32失球
data.stats.avgGoalsFordouble场均进球
data.stats.avgGoalsAgainstdouble场均失球
data.stats.winRatedouble胜率
data.playersarray球员列表
data.players[].playerIdint32球员ID
data.players[].nameEnstring球员名称（英文）
data.players[].nameShortEnstring球员短名称（英文）
data.players[].nameZhstring球员名称（中文）
data.players[].nameShortZhstring球员短名称（中文）
data.players[].nameZhtstring球员名称（繁体中文）
data.players[].nameShortZhtstring球员短名称（繁体中文）
data.players[].firstNamestring名
data.players[].lastNamestring姓
data.players[].numberstring号码
data.players[].agestring年龄
data.players[].positionint32位置：0位置,1守门员,2后卫,3中场,4前锋
data.players[].countryIdstring国籍
data.players[].birthDatestring生日
data.players[].birthCountryIdstring出生国家
data.players[].birthPlacestring出生地
data.players[].heightstring身高
data.players[].weightstring体重
data.players[].preferredFootint32首选脚：0未知,1左脚,2右脚
data.players[].marketValueEurstring市值欧元
data.players[].imagestring球员图片
data.honorsarray荣誉列表
data.honors[].honorIdint32荣誉ID
data.honors[].namestring荣誉名称
data.honors[].seasonstring赛季
data.honors[].countint32次数
data.cupsarray杯赛列表
data.cups[].leagueIdint32联赛ID
data.cups[].nameZhstring中文名
data.cups[].nameZhtstring繁体名
data.cups[].nameEnstring英文名
data.cups[].seasonstring赛季
data.leagueStatsarray按联赛统计
data.leagueStats[].leagueIdint32联赛ID（0=全部）
data.leagueStats[].leagueNamestring联赛名称
data.leagueStats[].playedint32场次
data.leagueStats[].wonint32胜
data.leagueStats[].drawnint32平
data.leagueStats[].lostint32负
data.leagueStats[].goalsForint32进球
data.leagueStats[].goalsAgainstint32失球
data.leagueStats[].winRatedouble胜率
data.leagueStats[].avgRatingdouble场均评分
data.leagueStats[].avgGoalsFordouble场均进球
data.leagueStats[].avgGoalsAgainstdouble场均失球
data.recentMatchesarray近期比赛
data.recentMatches[].matchIdint32比赛ID
data.recentMatches[].leagueIdint32联赛ID
data.recentMatches[].leagueNamestring联赛名称
data.recentMatches[].dateTimestring比赛时间
data.recentMatches[].homeTeamIdint32主队ID
data.recentMatches[].homeNamestring主队名称
data.recentMatches[].awayTeamIdint32客队ID
data.recentMatches[].awayNamestring客队名称
data.recentMatches[].homeScoreint32主队得分
data.recentMatches[].awayScoreint32客队得分
data.recentMatches[].avgRatingdouble场均评分
data.charactersarray球队特点
data.characters[].categoryint32分类：1=进攻, 2=防守, 3=风格
data.characters[].levelint32等级：1=强/高, 2=弱/低
data.characters[].namestring特点名称
data.transfersarray转会列表
data.transfers[].transferIdint32转会ID
data.transfers[].playerIdint32球员ID
data.transfers[].playerobject球员数据
data.transfers[].player.playerIdint32球员ID
data.transfers[].player.nameEnstring球员名称（英文）
data.transfers[].player.nameShortEnstring球员短名称（英文）
data.transfers[].player.nameZhstring球员名称（中文）
data.transfers[].player.nameShortZhstring球员短名称（中文）
data.transfers[].player.nameZhtstring球员名称（繁体中文）
data.transfers[].player.nameShortZhtstring球员短名称（繁体中文）
data.transfers[].player.firstNamestring名
data.transfers[].player.lastNamestring姓
data.transfers[].player.numberstring号码
data.transfers[].player.agestring年龄
data.transfers[].player.positionint32位置：0位置,1守门员,2后卫,3中场,4前锋
data.transfers[].player.countryIdstring国籍
data.transfers[].player.birthDatestring生日
data.transfers[].player.birthCountryIdstring出生国家
data.transfers[].player.birthPlacestring出生地
data.transfers[].player.heightstring身高
data.transfers[].player.weightstring体重
data.transfers[].player.preferredFootint32首选脚：0未知,1左脚,2右脚
data.transfers[].player.marketValueEurstring市值欧元
data.transfers[].player.imagestring球员图片
data.transfers[].fromTeamIdint32原球队ID
data.transfers[].fromTeamobject原球队数据
data.transfers[].fromTeam.teamIdint32球队ID
data.transfers[].fromTeam.typeint32类型：0俱乐部,1国家队
data.transfers[].fromTeam.nameEnstring球队名称（英文）
data.transfers[].fromTeam.nameShortEnstring球队短名称（英文）
data.transfers[].fromTeam.nameZhstring球队名称（中文）
data.transfers[].fromTeam.nameShortZhstring球队短名称（中文）
data.transfers[].fromTeam.nameZhtstring球队名称（繁体中文）
data.transfers[].fromTeam.nameShortZhtstring球队短名称（繁体中文）
data.transfers[].fromTeam.countryIdstring国家ID
data.transfers[].fromTeam.foundedstring成立时间
data.transfers[].fromTeam.venueIdint32球场ID
data.transfers[].fromTeam.imagestring球队图片
data.transfers[].fromTeam.coachIdint32教练ID
data.transfers[].toTeamIdint32新球队ID
data.transfers[].toTeamobject新球队数据
data.transfers[].toTeam.teamIdint32球队ID
data.transfers[].toTeam.typeint32类型：0俱乐部,1国家队
data.transfers[].toTeam.nameEnstring球队名称（英文）
data.transfers[].toTeam.nameShortEnstring球队短名称（英文）
data.transfers[].toTeam.nameZhstring球队名称（中文）
data.transfers[].toTeam.nameShortZhstring球队短名称（中文）
data.transfers[].toTeam.nameZhtstring球队名称（繁体中文）
data.transfers[].toTeam.nameShortZhtstring球队短名称（繁体中文）
data.transfers[].toTeam.countryIdstring国家ID
data.transfers[].toTeam.foundedstring成立时间
data.transfers[].toTeam.venueIdint32球场ID
data.transfers[].toTeam.imagestring球队图片
data.transfers[].toTeam.coachIdint32教练ID
data.transfers[].typeint32转会类型
data.transfers[].feestring转会费
data.transfers[].datestring转会日期
data.injuriesarray伤病/停赛列表
data.injuries[].matchIdint32比赛ID
data.injuries[].playerIdint32球员ID
data.injuries[].playerNamestring球员名称
data.injuries[].playerImagestring球员图片
data.injuries[].teamIdint32球队ID
data.injuries[].teamobject球队数据
data.injuries[].team.teamIdint32球队ID
data.injuries[].team.typeint32类型：0俱乐部,1国家队
data.injuries[].team.nameEnstring球队名称（英文）
data.injuries[].team.nameShortEnstring球队短名称（英文）
data.injuries[].team.nameZhstring球队名称（中文）
data.injuries[].team.nameShortZhstring球队短名称（中文）
data.injuries[].team.nameZhtstring球队名称（繁体中文）
data.injuries[].team.nameShortZhtstring球队短名称（繁体中文）
data.injuries[].team.countryIdstring国家ID
data.injuries[].team.foundedstring成立时间
data.injuries[].team.venueIdint32球场ID
data.injuries[].team.imagestring球队图片
data.injuries[].team.coachIdint32教练ID
data.injuries[].typeint32类型 1伤病 2停赛
data.injuries[].reasonstring原因
data.injuries[].startDatestring开始日期
data.injuries[].endDatestring结束日期

响应结构示例

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

展开完整 JSON 结构
{
  "success": false,
  "code": "示例字符串",
  "message": "示例字符串",
  "data": {
    "team": {
      "teamId": 0,
      "type": 0,
      "nameEn": "示例字符串",
      "nameShortEn": "示例字符串",
      "nameZh": "示例字符串",
      "nameShortZh": "示例字符串",
      "nameZht": "示例字符串",
      "nameShortZht": "示例字符串",
      "countryId": "示例字符串",
      "founded": "示例字符串",
      "venueId": 0,
      "image": "示例字符串",
      "coachId": 0
    },
    "stats": {
      "played": 0,
      "won": 0,
      "drawn": 0,
      "lost": 0,
      "goalsFor": 0,
      "goalsAgainst": 0,
      "avgGoalsFor": 0,
      "avgGoalsAgainst": 0,
      "winRate": 0
    },
    "players": [
      {
        "playerId": 0,
        "nameEn": "示例字符串",
        "nameShortEn": "示例字符串",
        "nameZh": "示例字符串",
        "nameShortZh": "示例字符串",
        "nameZht": "示例字符串",
        "nameShortZht": "示例字符串",
        "firstName": "示例字符串",
        "lastName": "示例字符串",
        "number": "示例字符串",
        "age": "示例字符串",
        "position": 0,
        "countryId": "示例字符串",
        "birthDate": "示例字符串",
        "birthCountryId": "示例字符串",
        "birthPlace": "示例字符串",
        "height": "示例字符串",
        "weight": "示例字符串",
        "preferredFoot": 0,
        "marketValueEur": "示例字符串",
        "image": "示例字符串"
      }
    ],
    "honors": [
      {
        "honorId": 0,
        "name": "示例字符串",
        "season": "示例字符串",
        "count": 0
      }
    ],
    "cups": [
      {
        "leagueId": 0,
        "nameZh": "示例字符串",
        "nameZht": "示例字符串",
        "nameEn": "示例字符串",
        "season": "示例字符串"
      }
    ],
    "leagueStats": [
      {
        "leagueId": 0,
        "leagueName": "示例字符串",
        "played": 0,
        "won": 0,
        "drawn": 0,
        "lost": 0,
        "goalsFor": 0,
        "goalsAgainst": 0,
        "winRate": 0,
        "avgRating": 0,
        "avgGoalsFor": 0,
        "avgGoalsAgainst": 0
      }
    ],
    "recentMatches": [
      {
        "matchId": 0,
        "leagueId": 0,
        "leagueName": "示例字符串",
        "dateTime": "示例字符串",
        "homeTeamId": 0,
        "homeName": "示例字符串",
        "awayTeamId": 0,
        "awayName": "示例字符串",
        "homeScore": 0,
        "awayScore": 0,
        "avgRating": 0
      }
    ],
    "characters": [
      {
        "category": 0,
        "level": 0,
        "name": "示例字符串"
      }
    ],
    "transfers": [
      {
        "transferId": 0,
        "playerId": 0,
        "player": {
          "playerId": 0,
          "nameEn": "示例字符串",
          "nameShortEn": "示例字符串",
          "nameZh": "示例字符串",
          "nameShortZh": "示例字符串",
          "nameZht": "示例字符串",
          "nameShortZht": "示例字符串",
          "firstName": "示例字符串",
          "lastName": "示例字符串",
          "number": "示例字符串",
          "age": "示例字符串",
          "position": 0,
          "countryId": "示例字符串",
          "birthDate": "示例字符串",
          "birthCountryId": "示例字符串",
          "birthPlace": "示例字符串",
          "height": "示例字符串",
          "weight": "示例字符串",
          "preferredFoot": 0,
          "marketValueEur": "示例字符串",
          "image": "示例字符串"
        },
        "fromTeamId": 0,
        "fromTeam": {
          "teamId": 0,
          "type": 0,
          "nameEn": "示例字符串",
          "nameShortEn": "示例字符串",
          "nameZh": "示例字符串",
          "nameShortZh": "示例字符串",
          "nameZht": "示例字符串",
          "nameShortZht": "示例字符串",
          "countryId": "示例字符串",
          "founded": "示例字符串",
          "venueId": 0,
          "image": "示例字符串",
          "coachId": 0
        },
        "toTeamId": 0,
        "toTeam": {
          "teamId": 0,
          "type": 0,
          "nameEn": "示例字符串",
          "nameShortEn": "示例字符串",
          "nameZh": "示例字符串",
          "nameShortZh": "示例字符串",
          "nameZht": "示例字符串",
          "nameShortZht": "示例字符串",
          "countryId": "示例字符串",
          "founded": "示例字符串",
          "venueId": 0,
          "image": "示例字符串",
          "coachId": 0
        },
        "type": 0,
        "fee": "示例字符串",
        "date": "示例字符串"
      }
    ],
    "injuries": [
      {
        "matchId": 0,
        "playerId": 0,
        "playerName": "示例字符串",
        "playerImage": "示例字符串",
        "teamId": 0,
        "team": {
          "teamId": 0,
          "type": 0,
          "nameEn": "示例字符串",
          "nameShortEn": "示例字符串",
          "nameZh": "示例字符串",
          "nameShortZh": "示例字符串",
          "nameZht": "示例字符串",
          "nameShortZht": "示例字符串",
          "countryId": "示例字符串",
          "founded": "示例字符串",
          "venueId": 0,
          "image": "示例字符串",
          "coachId": 0
        },
        "type": 0,
        "reason": "示例字符串",
        "startDate": "示例字符串",
        "endDate": "示例字符串"
      }
    ]
  }
}

错误处理与使用说明

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