- 快速开始
- API指南
- API文档
- 体育比分
- 基础数据
- 实时数据
- 指数数据
- 统计数据
- 高阶数据
- 历史数据
- 比赛对应接口
- 长链接推送
- 基础数据
- 电竞比分
- 体彩数据
- 媒体数据
- 动画直播
- 常见问题
- 更新日志
足球阵容数据接口
正式环境
https://api.esportsdata.cc
正式环境
https://api.esportsdata.cc
GET
/sport/api/v3/live/202/lineup
获取足球比赛的阵容数据-自定义参数查询（不同项目的路径不同）
该接口返回所请求参数的全量阵容数据（请求限制：前后30天的赛程）
更新数据：
方案1：有需求时请求指定足球比赛的阵容数据：
方案2：接推送，接收实时有变化的数据（长链接推送/实时数据增强版/比赛阵容数据推送）
频率限制：30次/min
请求参数
Query 参数
match_id
string
可选
示例值:
3647544
page
integer
页数
per_page
integer
每页数据条数
language
string
可选
recent_update
string
可选
Header 参数
app_id
string
用户ID
默认值:
marz2025
app_secret
string
用户秘钥
默认值:
d9b8eafc3b5a48b7a5f1c6d2e4f8a9e5b3d7c2a1f4e6b8a9d5f1c7e2b9d3a6f4
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.esportsdata.cc/sport/api/v3/live/202/lineup?match_id=3647544&page&per_page&language&recent_update' \
--header 'app_id;' \
--header 'app_secret;'返回响应
🟢200成功
application/json
Body
code
integer
错误码
data
object
必需
list
array [object {8}]
必需
total
integer
总条数
msg
string
接口响应信息
示例
{
"code": 0,
"data": {
"list": [
{
"sport_id": 202,
"match_id": 2703420,
"confirmed": 1,
"home_formation": "4-2-3-1",
"away_formation": "3-4-2-1",
"home": [
{
"player_id": 19068,
"name": "Unai Simon",
"team_id": 15871,
"first": 1,
"captain": 0,
"position": "G",
"x": 50,
"y": 12,
"rating": "6.51"
},
{
"player_id": 17423,
"name": "Daniel Carvajal",
"team_id": 15871,
"first": 1,
"captain": 0,
"position": "D",
"x": 13,
"y": 32,
"rating": "7.27"
},
{
"player_id": 18818,
"name": "Robin Le Normand",
"team_id": 15871,
"first": 1,
"captain": 0,
"position": "D",
"x": 36,
"y": 32,
"rating": "7.36",
"incidents": [
{
"type": 9,
"time": "83",
"belong": 1,
"home_score": 1,
"away_score": 1,
"reason_type": 0,
"in_player": {
"player_id": 17433,
"name": "Nacho Fernández"
},
"out_player": {
"player_id": 18818,
"name": "Robin Le Normand"
}
}
]
},
{
"player_id": 10381,
"name": "Aymeric Laporte",
"team_id": 15871,
"first": 1,
"captain": 0,
"position": "D",
"x": 64,
"y": 32,
"rating": "7.28"
},
{
"player_id": 15350,
"name": "Marc Cucurella",
"team_id": 15871,
"first": 1,
"captain": 0,
"position": "D",
"x": 87,
"y": 32,
"rating": "7.42",
"incidents": [
{
"type": 1,
"time": "86",
"belong": 1,
"home_score": 2,
"away_score": 1,
"reason_type": 0,
"assist1": {
"player_id": 15350,
"name": "Marc Cucurella"
}
}
]
},
{
"player_id": 10357,
"name": "Rodri Hernandez",
"team_id": 15871,
"first": 1,
"captain": 0,
"position": "M",
"x": 36,
"y": 50,
"rating": "6.97",
"incidents": [
{
"type": 9,
"time": "46",
"belong": 1,
"home_score": 0,
"away_score": 0,
"reason_type": 0,
"in_player": {
"player_id": 18798,
"name": "Martín Zubimendi"
},
"out_player": {
"player_id": 10357,
"name": "Rodri Hernandez"
}
}
]
},
{
"player_id": 15076,
"name": "Fabián Ruiz",
"team_id": 15871,
"first": 1,
"captain": 0,
"position": "M",
"x": 64,
"y": 50,
"rating": "7.12"
},
{
"player_id": 162862,
"name": "Lamine Yamal Nasraoui Ebana",
"team_id": 15871,
"first": 1,
"captain": 0,
"position": "F",
"x": 22,
"y": 70,
"rating": "7.92",
"incidents": [
{
"type": 1,
"time": "47",
"belong": 1,
"home_score": 1,
"away_score": 0,
"reason_type": 0,
"assist1": {
"player_id": 162862,
"name": "Lamine Yamal Nasraoui Ebana"
}
},
{
"type": 9,
"time": "89",
"belong": 1,
"home_score": 2,
"away_score": 1,
"reason_type": 0,
"in_player": {
"player_id": 18840,
"name": "Mikel Merino"
},
"out_player": {
"player_id": 162862,
"name": "Lamine Yamal Nasraoui Ebana"
}
}
]
},
{
"player_id": 16259,
"name": "Daniel Olmo Carvajal",
"team_id": 15871,
"first": 1,
"captain": 0,
"position": "F",
"x": 50,
"y": 70,
"rating": "5.74",
"incidents": [
{
"type": 3,
"time": "31",
"belong": 1,
"home_score": 0,
"away_score": 0,
"reason_type": 0
}
]
},
{
"player_id": 19058,
"name": "Nicholas Williams Arthuer",
"team_id": 15871,
"first": 1,
"captain": 0,
"position": "F",
"x": 78,
"y": 70,
"rating": "8.93",
"incidents": [
{
"type": 1,
"time": "47",
"belong": 1,
"home_score": 1,
"away_score": 0,
"reason_type": 0,
"assist1": {
"player_id": 162862,
"name": "Lamine Yamal Nasraoui Ebana"
}
}
]
},
{
"player_id": 19649,
"name": "Álvaro Morata",
"team_id": 15871,
"first": 1,
"captain": 1,
"position": "F",
"x": 50,
"y": 90,
"rating": "5.74",
"incidents": [
{
"type": 9,
"time": "68",
"belong": 1,
"home_score": 1,
"away_score": 0,
"reason_type": 0,
"in_player": {
"player_id": 18811,
"name": "Mikel Oyarzabal"
},
"out_player": {
"player_id": 19649,
"name": "Álvaro Morata"
}
}
]
},
{
"player_id": 21424,
"name": "Alejandro Baena",
"team_id": 15871,
"first": 0,
"captain": 0,
"position": "M",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 1057,
"name": "Alejandro Grimaldo",
"team_id": 15871,
"first": 0,
"captain": 0,
"position": "D",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 158700,
"name": "Fermín Marín",
"team_id": 15871,
"first": 0,
"captain": 0,
"position": "M",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 18798,
"name": "Martín Zubimendi",
"team_id": 15871,
"first": 0,
"captain": 0,
"position": "M",
"x": 0,
"y": 0,
"rating": "6.63",
"incidents": [
{
"type": 9,
"time": "46",
"belong": 1,
"home_score": 0,
"away_score": 0,
"reason_type": 0,
"in_player": {
"player_id": 18798,
"name": "Martín Zubimendi"
},
"out_player": {
"player_id": 10357,
"name": "Rodri Hernandez"
}
}
]
},
{
"player_id": 19071,
"name": "Daniel Vivian",
"team_id": 15871,
"first": 0,
"captain": 0,
"position": "D",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 19741,
"name": "Ferrán Torres",
"team_id": 15871,
"first": 0,
"captain": 0,
"position": "F",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 18811,
"name": "Mikel Oyarzabal",
"team_id": 15871,
"first": 0,
"captain": 0,
"position": "F",
"x": 0,
"y": 0,
"rating": "8.43",
"incidents": [
{
"type": 9,
"time": "68",
"belong": 1,
"home_score": 1,
"away_score": 0,
"reason_type": 0,
"in_player": {
"player_id": 18811,
"name": "Mikel Oyarzabal"
},
"out_player": {
"player_id": 19649,
"name": "Álvaro Morata"
}
},
{
"type": 1,
"time": "86",
"belong": 1,
"home_score": 2,
"away_score": 1,
"reason_type": 0,
"assist1": {
"player_id": 15350,
"name": "Marc Cucurella"
}
}
]
},
{
"player_id": 18816,
"name": "Álex Remiro",
"team_id": 15871,
"first": 0,
"captain": 0,
"position": "G",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 18840,
"name": "Mikel Merino",
"team_id": 15871,
"first": 0,
"captain": 0,
"position": "M",
"x": 0,
"y": 0,
"rating": "6.89",
"incidents": [
{
"type": 9,
"time": "89",
"belong": 1,
"home_score": 2,
"away_score": 1,
"reason_type": 0,
"in_player": {
"player_id": 18840,
"name": "Mikel Merino"
},
"out_player": {
"player_id": 162862,
"name": "Lamine Yamal Nasraoui Ebana"
}
}
]
},
{
"player_id": 7898,
"name": "David Raya",
"team_id": 15871,
"first": 0,
"captain": 0,
"position": "G",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 19726,
"name": "Joselu",
"team_id": 15871,
"first": 0,
"captain": 0,
"position": "F",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 17433,
"name": "Nacho Fernández",
"team_id": 15871,
"first": 0,
"captain": 0,
"position": "D",
"x": 0,
"y": 0,
"rating": "6.79",
"incidents": [
{
"type": 9,
"time": "83",
"belong": 1,
"home_score": 1,
"away_score": 1,
"reason_type": 0,
"in_player": {
"player_id": 17433,
"name": "Nacho Fernández"
},
"out_player": {
"player_id": 18818,
"name": "Robin Le Normand"
}
}
]
},
{
"player_id": 17274,
"name": "Jesús Navas",
"team_id": 15871,
"first": 0,
"captain": 0,
"position": "D",
"x": 0,
"y": 0,
"rating": "0.0"
}
],
"away": [
{
"player_id": 4523,
"name": "player",
"team_id": 15867,
"first": 1,
"captain": 0,
"position": "G",
"x": 50,
"y": 12,
"rating": "7.38"
},
{
"player_id": 10386,
"name": "player",
"team_id": 15867,
"first": 1,
"captain": 0,
"position": "D",
"x": 24,
"y": 32,
"rating": "6.71"
},
{
"player_id": 10370,
"name": "player",
"team_id": 15867,
"first": 1,
"captain": 0,
"position": "D",
"x": 50,
"y": 32,
"rating": "6.78",
"incidents": [
{
"type": 3,
"time": "53",
"belong": 2,
"home_score": 1,
"away_score": 0,
"reason_type": 0
}
]
},
{
"player_id": 15262,
"name": "player",
"team_id": 15867,
"first": 1,
"captain": 0,
"position": "D",
"x": 76,
"y": 32,
"rating": "6.71"
},
{
"player_id": 15166,
"name": "player",
"team_id": 15867,
"first": 1,
"captain": 0,
"position": "M",
"x": 13,
"y": 62,
"rating": "6.17"
},
{
"player_id": 95083,
"name": "player",
"team_id": 15867,
"first": 1,
"captain": 0,
"position": "M",
"x": 36,
"y": 62,
"rating": "5.94",
"incidents": [
{
"type": 9,
"time": "70",
"belong": 2,
"home_score": 1,
"away_score": 0,
"reason_type": 0,
"in_player": {
"player_id": 59719,
"name": "player"
},
"out_player": {
"player_id": 95083,
"name": "player"
}
}
]
},
{
"player_id": 7692,
"name": "player",
"team_id": 15867,
"first": 1,
"captain": 0,
"position": "M",
"x": 64,
"y": 62,
"rating": "6.79"
},
{
"player_id": 7678,
"name": "player",
"team_id": 15867,
"first": 1,
"captain": 0,
"position": "D",
"x": 87,
"y": 62,
"rating": "6.35"
},
{
"player_id": 10365,
"name": "player",
"team_id": 15867,
"first": 1,
"captain": 0,
"position": "M",
"x": 25,
"y": 80,
"rating": "5.54",
"incidents": [
{
"type": 9,
"time": "89",
"belong": 2,
"home_score": 2,
"away_score": 1,
"reason_type": 0,
"in_player": {
"player_id": 7886,
"name": "player"
},
"out_player": {
"player_id": 10365,
"name": "player"
}
}
]
},
{
"player_id": 7150,
"name": "player",
"team_id": 15867,
"first": 1,
"captain": 0,
"position": "M",
"x": 75,
"y": 80,
"rating": "7.31",
"incidents": [
{
"type": 1,
"time": "73",
"belong": 2,
"home_score": 1,
"away_score": 1,
"reason_type": 0,
"assist1": {
"player_id": 7150,
"name": "player"
}
}
]
},
{
"player_id": 21185,
"name": "player",
"team_id": 15867,
"first": 1,
"captain": 1,
"position": "F",
"x": 50,
"y": 90,
"rating": "6.83",
"incidents": [
{
"type": 3,
"time": "25",
"belong": 2,
"home_score": 0,
"away_score": 0,
"reason_type": 0
},
{
"type": 9,
"time": "61",
"belong": 2,
"home_score": 1,
"away_score": 0,
"reason_type": 0,
"in_player": {
"player_id": 4533,
"name": "player"
},
"out_player": {
"player_id": 21185,
"name": "player"
}
}
]
},
{
"player_id": 7886,
"name": "player",
"team_id": 15867,
"first": 0,
"captain": 0,
"position": "F",
"x": 0,
"y": 0,
"rating": "6.3",
"incidents": [
{
"type": 9,
"time": "89",
"belong": 2,
"home_score": 2,
"away_score": 1,
"reason_type": 0,
"in_player": {
"player_id": 7886,
"name": "player"
},
"out_player": {
"player_id": 10365,
"name": "player"
}
}
]
},
{
"player_id": 15246,
"name": "player",
"team_id": 15867,
"first": 0,
"captain": 0,
"position": "D",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 7709,
"name": "player",
"team_id": 15867,
"first": 0,
"captain": 0,
"position": "F",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 4533,
"name": "player",
"team_id": 15867,
"first": 0,
"captain": 0,
"position": "F",
"x": 0,
"y": 0,
"rating": "6.88",
"incidents": [
{
"type": 9,
"time": "61",
"belong": 2,
"home_score": 1,
"away_score": 0,
"reason_type": 0,
"in_player": {
"player_id": 4533,
"name": "player"
},
"out_player": {
"player_id": 21185,
"name": "player"
}
},
{
"type": 3,
"time": "90+2",
"belong": 2,
"home_score": 2,
"away_score": 1,
"reason_type": 0
}
]
},
{
"player_id": 15339,
"name": "player",
"team_id": 15867,
"first": 0,
"captain": 0,
"position": "D",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 7701,
"name": "player",
"team_id": 15867,
"first": 0,
"captain": 0,
"position": "G",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 15265,
"name": "player",
"team_id": 15867,
"first": 0,
"captain": 0,
"position": "D",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 4535,
"name": "player",
"team_id": 15867,
"first": 0,
"captain": 0,
"position": "D",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 15143,
"name": "player",
"team_id": 15867,
"first": 0,
"captain": 0,
"position": "G",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 8054,
"name": "player",
"team_id": 15867,
"first": 0,
"captain": 0,
"position": "D",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 15268,
"name": "player",
"team_id": 15867,
"first": 0,
"captain": 0,
"position": "M",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 22260,
"name": "player",
"team_id": 15867,
"first": 0,
"captain": 0,
"position": "M",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 59719,
"name": "player",
"team_id": 15867,
"first": 0,
"captain": 0,
"position": "M",
"x": 0,
"y": 0,
"rating": "8.62",
"incidents": [
{
"type": 9,
"time": "70",
"belong": 2,
"home_score": 1,
"away_score": 0,
"reason_type": 0,
"in_player": {
"player_id": 59719,
"name": "player"
},
"out_player": {
"player_id": 95083,
"name": "player"
}
},
{
"type": 1,
"time": "73",
"belong": 2,
"home_score": 1,
"away_score": 1,
"reason_type": 0,
"assist1": {
"player_id": 7150,
"name": "player"
}
}
]
},
{
"player_id": 4503,
"name": "player",
"team_id": 15867,
"first": 0,
"captain": 0,
"position": "M",
"x": 0,
"y": 0,
"rating": "0.0"
},
{
"player_id": 15240,
"name": "player",
"team_id": 15867,
"first": 0,
"captain": 0,
"position": "M",
"x": 0,
"y": 0,
"rating": "0.0"
}
],
"update_time": 1734333653
}
],
"total": 1
},
"msg": "success"
}修改于 2025-05-29 06:35:01