接口介绍
电竞比分网提供四类核心接口，覆盖电竞赛事数据查询的绝大多数场景。所有接口基于 RESTful 设计，统一返回 JSON 数据结构，字段命名规范一致，便于快速解析与二次开发。
GET
实时比分接口
获取指定游戏当前进行中赛事的实时比分、比赛状态与双方战队数据。
/v1/match/live
GET
赛程查询接口
按游戏、联赛或日期范围查询即将开始与已结束的赛事赛程。
/v1/match/schedule
GET
战队排名接口
获取指定游戏或联赛的战队积分、胜率、排名趋势等数据。
/v1/team/ranking
GET
赛事数据接口
获取单场比赛的击杀、经济、推塔、视野等详细数据维度。
/v1/match/stats
调用说明
认证方式
开发者在请求头中携带 API Key 即可完成认证，每个 Key 绑定独立调用配额。
# 请求头示例
Authorization: Bearer YOUR_API_KEY
Accept: application/json
请求参数规范
公共参数使用 query string 传递，时间参数采用 ISO 8601 格式，分页通过 page 与 size 控制。
| 参数 | 类型 | 说明 |
|---|---|---|
| game | string | 游戏标识，如 lol、dota2、cs2 |
| league | string | 联赛标识，如 lpl、major |
| page | integer | 页码，默认 1 |
| size | integer | 每页条数，默认 20，最大 100 |
响应格式
所有接口返回统一 JSON 结构，包含状态码、数据体与错误信息字段。
{
"code": 200,
"message": "success",
"data": {
"list": [],
"total": 0
}
}
示例代码块
以下示例展示如何通过电竞比分网接口获取实时比分与战队排名数据，可使用主流 HTTP 客户端或编程语言快速集成。
Python 调用示例
import requests
# 电竞比分网实时比分接口
url = "https://api.escorewang.com.cn/v1/match/live"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json"
}
params = {
"game": "lol",
"size": "10"
}
response = requests.get(url, headers=headers, params=params)
data = response.json()
for match in data["data"]["list"]:
print(match["team_a"], match["score_a"], "-", match["score_b"], match["team_b"])
JavaScript 调用示例
const fetchRanking = async () => {
const res = await fetch(
"https://api.escorewang.com.cn/v1/team/ranking?game=dota2&league=ti",
{
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json"
}
}
);
const data = await res.json();
console.log(data.data.list);
};
fetchRanking();
接口更新记录
v2.4.0
2026-03-18
新增 CS2 赛事击杀与回合经济数据接口，支持按地图拆分的详细数据维度，响应字段新增 map_stats 节点。
v2.3.2
2026-02-28
优化战队排名接口查询性能，热门联赛响应时间降低 35%，新增战队近期胜率走势字段 trend。
v2.2.0
2026-01-15
实时比分接口新增王者荣耀与和平精英项目支持，统一返回结构中新增 game_code 字段用于快速识别游戏类型。
