账户
浏览产品与网站导航

比赛-交战统计

GET https://api.superscore.cn/basketball/statistics/match

接口说明

建议每天更新

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

请求头与鉴权

字段类型必填文档示例值说明
tokenstring是testtoken仅供测试，正式站请设置IP

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

请求参数

Query 查询参数

字段类型必填文档示例值说明
languageIdstring否zh多语言 默认zh
matchIdint32是0No comments found.

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

调用示例

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

cURL

curl --get 'https://api.superscore.cn/basketball/statistics/match' \
  --header 'token: YOUR_MERCHANT_KEY' \
  --data-urlencode 'languageId=YOUR_LANGUAGE_ID' \
  --data-urlencode 'matchId=YOUR_MATCH_ID'

JavaScript / Node.js

// 仅在服务端保存商户密钥；替换示例占位值。
const url = new URL("https://api.superscore.cn/basketball/statistics/match");
url.search = new URLSearchParams({
  "languageId": "YOUR_LANGUAGE_ID",
  "matchId": "YOUR_MATCH_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 = {
  "languageId": "YOUR_LANGUAGE_ID",
  "matchId": "YOUR_MATCH_ID"
}
headers = {
  "token": "YOUR_MERCHANT_KEY"
}
url = "https://api.superscore.cn/basketball/statistics/match"
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是否成功
messagestring提示信息
dataobject数据
data.teamId1string主队
data.teamId2string客队
data.top50Listarray最近五十场比赛
data.top50List[].leagueIdint32联赛id
data.top50List[].matchIdint32比赛id
data.top50List[].teamId1string主队id
data.top50List[].teamId2string客队id
data.top50List[].datestring日期
data.top50List[].team1Scorestring主队进球
data.top50List[].team2Scorestring客队进球
data.overallobject交战胜平负统计
data.overall.totalobject总进球
data.overall.total.gamesint32比赛场次
data.overall.total.team1Wonint32主队赢得比赛场次
data.overall.total.team2Wonint32客队赢得比赛场次
data.overall.total.drawsint32平局比赛场次
data.overall.homeobject主队
data.overall.home.team1object主队
data.overall.home.team1.gamesint32比赛场次
data.overall.home.team1.wonint32赢球场次
data.overall.home.team1.lostint32输球场次
data.overall.home.team1.drawsint32平局场次
data.overall.home.team2object客队
data.overall.home.team2.gamesint32比赛场次
data.overall.home.team2.wonint32赢球场次
data.overall.home.team2.lostint32输球场次
data.overall.home.team2.drawsint32平局场次
data.overall.awayobject客队
data.overall.away.team1object
data.overall.away.team1.gamesint32比赛场次
data.overall.away.team1.wonint32赢球场次
data.overall.away.team1.lostint32输球场次
data.overall.away.team1.drawsint32平局场次
data.overall.away.team2object
data.overall.away.team2.gamesint32比赛场次
data.overall.away.team2.wonint32赢球场次
data.overall.away.team2.lostint32输球场次
data.overall.away.team2.drawsint32平局场次
data.leagueListarray联赛交战统计
data.leagueList[].leagueIdint32联赛id
data.leagueList[].gamesint32比赛场次
data.leagueList[].team1Wonint32主队赢球场次
data.leagueList[].team2Wonint32客队赢球场次
data.leagueList[].drawint32平局
data.biggestVictoryobject最大的胜利
data.biggestVictory.team1object主队
data.biggestVictory.team1.categorystring国家
data.biggestVictory.team1.leagueIdint32联赛id
data.biggestVictory.team1.id1int32主队
data.biggestVictory.team1.id2int32客队
data.biggestVictory.team1.datestring日期
data.biggestVictory.team1.team1Scorestring主队比分
data.biggestVictory.team1.team2Scorestring主队比分
data.biggestVictory.team1.matchIdint32比赛id
data.biggestVictory.team2object客队
data.biggestVictory.team2.categorystring国家
data.biggestVictory.team2.leagueIdint32联赛id
data.biggestVictory.team2.id1int32主队
data.biggestVictory.team2.id2int32客队
data.biggestVictory.team2.datestring日期
data.biggestVictory.team2.team1Scorestring主队比分
data.biggestVictory.team2.team2Scorestring主队比分
data.biggestVictory.team2.matchIdint32比赛id
data.biggestDefeatobject最大的失利
data.biggestDefeat.team1object主队
data.biggestDefeat.team1.categorystring国家
data.biggestDefeat.team1.leagueIdint32联赛id
data.biggestDefeat.team1.id1int32主队
data.biggestDefeat.team1.id2int32客队
data.biggestDefeat.team1.datestring日期
data.biggestDefeat.team1.team1Scorestring主队比分
data.biggestDefeat.team1.team2Scorestring主队比分
data.biggestDefeat.team1.matchIdint32比赛id
data.biggestDefeat.team2object客队
data.biggestDefeat.team2.categorystring国家
data.biggestDefeat.team2.leagueIdint32联赛id
data.biggestDefeat.team2.id1int32主队
data.biggestDefeat.team2.id2int32客队
data.biggestDefeat.team2.datestring日期
data.biggestDefeat.team2.team1Scorestring主队比分
data.biggestDefeat.team2.team2Scorestring主队比分
data.biggestDefeat.team2.matchIdint32比赛id
data.last5Homeobject最近五场主场比赛
data.last5Home.teamList1array主队
data.last5Home.teamList1[].categorystring国家
data.last5Home.teamList1[].leagueIdint32联赛id
data.last5Home.teamList1[].id1int32主队
data.last5Home.teamList1[].id2int32客队
data.last5Home.teamList1[].datestring日期
data.last5Home.teamList1[].team1Scorestring主队比分
data.last5Home.teamList1[].team2Scorestring主队比分
data.last5Home.teamList1[].matchIdint32比赛id
data.last5Home.teamList2array客队
data.last5Home.teamList2[].categorystring国家
data.last5Home.teamList2[].leagueIdint32联赛id
data.last5Home.teamList2[].id1int32主队
data.last5Home.teamList2[].id2int32客队
data.last5Home.teamList2[].datestring日期
data.last5Home.teamList2[].team1Scorestring主队比分
data.last5Home.teamList2[].team2Scorestring主队比分
data.last5Home.teamList2[].matchIdint32比赛id
data.last5Awayobject最近五场客场比赛
data.last5Away.teamList1array主队
data.last5Away.teamList1[].categorystring国家
data.last5Away.teamList1[].leagueIdint32联赛id
data.last5Away.teamList1[].id1int32主队
data.last5Away.teamList1[].id2int32客队
data.last5Away.teamList1[].datestring日期
data.last5Away.teamList1[].team1Scorestring主队比分
data.last5Away.teamList1[].team2Scorestring主队比分
data.last5Away.teamList1[].matchIdint32比赛id
data.last5Away.teamList2array客队
data.last5Away.teamList2[].categorystring国家
data.last5Away.teamList2[].leagueIdint32联赛id
data.last5Away.teamList2[].id1int32主队
data.last5Away.teamList2[].id2int32客队
data.last5Away.teamList2[].datestring日期
data.last5Away.teamList2[].team1Scorestring主队比分
data.last5Away.teamList2[].team2Scorestring主队比分
data.last5Away.teamList2[].matchIdint32比赛id
codestring编码
timestampint64时间

响应结构示例

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

展开完整 JSON 结构
{
  "success": false,
  "message": "示例字符串",
  "data": {
    "teamId1": "示例字符串",
    "teamId2": "示例字符串",
    "top50List": [
      {
        "leagueId": 0,
        "matchId": 0,
        "teamId1": "示例字符串",
        "teamId2": "示例字符串",
        "date": "示例字符串",
        "team1Score": "示例字符串",
        "team2Score": "示例字符串"
      }
    ],
    "overall": {
      "total": {
        "games": 0,
        "team1Won": 0,
        "team2Won": 0,
        "draws": 0
      },
      "home": {
        "team1": {
          "games": 0,
          "won": 0,
          "lost": 0,
          "draws": 0
        },
        "team2": {
          "games": 0,
          "won": 0,
          "lost": 0,
          "draws": 0
        }
      },
      "away": {
        "team1": {
          "games": 0,
          "won": 0,
          "lost": 0,
          "draws": 0
        },
        "team2": {
          "games": 0,
          "won": 0,
          "lost": 0,
          "draws": 0
        }
      }
    },
    "leagueList": [
      {
        "leagueId": 0,
        "games": 0,
        "team1Won": 0,
        "team2Won": 0,
        "draw": 0
      }
    ],
    "biggestVictory": {
      "team1": {
        "category": "示例字符串",
        "leagueId": 0,
        "id1": 0,
        "id2": 0,
        "date": "示例字符串",
        "team1Score": "示例字符串",
        "team2Score": "示例字符串",
        "matchId": 0
      },
      "team2": {
        "category": "示例字符串",
        "leagueId": 0,
        "id1": 0,
        "id2": 0,
        "date": "示例字符串",
        "team1Score": "示例字符串",
        "team2Score": "示例字符串",
        "matchId": 0
      }
    },
    "biggestDefeat": {
      "team1": {
        "category": "示例字符串",
        "leagueId": 0,
        "id1": 0,
        "id2": 0,
        "date": "示例字符串",
        "team1Score": "示例字符串",
        "team2Score": "示例字符串",
        "matchId": 0
      },
      "team2": {
        "category": "示例字符串",
        "leagueId": 0,
        "id1": 0,
        "id2": 0,
        "date": "示例字符串",
        "team1Score": "示例字符串",
        "team2Score": "示例字符串",
        "matchId": 0
      }
    },
    "last5Home": {
      "teamList1": [
        {
          "category": "示例字符串",
          "leagueId": 0,
          "id1": 0,
          "id2": 0,
          "date": "示例字符串",
          "team1Score": "示例字符串",
          "team2Score": "示例字符串",
          "matchId": 0
        }
      ],
      "teamList2": [
        {
          "category": "示例字符串",
          "leagueId": 0,
          "id1": 0,
          "id2": 0,
          "date": "示例字符串",
          "team1Score": "示例字符串",
          "team2Score": "示例字符串",
          "matchId": 0
        }
      ]
    },
    "last5Away": {
      "teamList1": [
        {
          "category": "示例字符串",
          "leagueId": 0,
          "id1": 0,
          "id2": 0,
          "date": "示例字符串",
          "team1Score": "示例字符串",
          "team2Score": "示例字符串",
          "matchId": 0
        }
      ],
      "teamList2": [
        {
          "category": "示例字符串",
          "leagueId": 0,
          "id1": 0,
          "id2": 0,
          "date": "示例字符串",
          "team1Score": "示例字符串",
          "team2Score": "示例字符串",
          "matchId": 0
        }
      ]
    }
  },
  "code": "示例字符串",
  "timestamp": 0
}

错误处理与使用说明

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