球员资料 - AnySport

返回球员基础资料（当前所属球队、号码、年龄、位置等当前快照），支持按 player_id 查单人、按 team_id 查全队阵容、或按 player_name 模糊搜索，三选一即可。适合用于球队详情页的”球员名单”板块或球员搜索框。若额外带上 league_id，会附带返回该球员在该联赛的当季累计技术统计 season_stats（出场/进球/助攻/评分等），可用于球员卡片展示技术数据；不传则只返回基础资料。

接口路径

GET /v1/soccer/players

入参说明

player_id / team_id / player_name 至少传一个。

参数	类型	必填	说明
`player_id`	string	条件之一	球员 ID（`asp_`）
`team_id`	string	条件之一	按球队查阵容（`ast_`）
`player_name`	string	条件之一	按名称模糊查
`league_id`	string	否	叠加联赛过滤；同时用于填充 `season_stats`（见出参）
`season`	string	否	当前无效果（球员基础资料与赛季统计均无赛季维度，该参数被忽略），预留
`lang`	string	否	`en` / `zh-CN`，非法值静默回退默认语言，可选值以 `GET /languages`（19）为准

球员基础资料为当前快照（球员当前所属球队/号码/年龄）。传 league_id 时额外返回该联赛的当季累计统计 season_stats。

出参说明（data: 数组）

字段	类型	说明
`player_id`	string	球员 ID（`asp_` 前缀）
`name`	string	姓名
`nationality`	string	国籍
`position`	string	位置，枚举见下方「枚举说明：position」
`number`	string	球衣号
`age`	string	年龄
`team_id`	string	所属球队 ID
`team_name`	string	所属球队名
`season_stats`	object	当季累计统计，仅传 `league_id` 且有数据时返回：`{ league_id, appearances, minutes, goals, assists, yellow_cards, red_cards, rating }`

枚举说明：position（位置）

枚举值	含义
`G`	门将（Goalkeeper）
`D`	后卫（Defender）
`M`	中场（Midfielder）
`F`	前锋（Forward）

入参示例

GET /v1/soccer/players?team_id=ast_9137ee449e3b40a68149ca319373adaf&lang=en

出参示例

球员资料接口响应示例（节选）

{
  "success": true,
  "data": [
    {
      "player_id": "asp_1dca6c7e13f44cceae622530c551ad15",
      "name": "Alexis Mac Allister",
      "position": "M",
      "number": "20",
      "age": "27",
      "team_id": "ast_9137ee449e3b40a68149ca319373adaf",
      "team_name": "Argentina"
    },
    {
      "player_id": "asp_6f890f89feb54c82b38c46ddd89b8a1e",
      "name": "Emiliano Martinez",
      "position": "G",
      "number": "23",
      "age": "33",
      "team_id": "ast_9137ee449e3b40a68149ca319373adaf",
      "team_name": "Argentina"
    }
  ],
  "meta": {
    "total": 13,
    "timestamp": "2026-07-13T19:18:23.402122900Z"
  },
  "traceId": "3c7c05ec-c4c8-44ed-ac01-9f7e3367c3fe"
}