Logo
Section 1 / 4

球员接口

学习如何使用 API-Football 获取球员的详细信息。

导入

球员接口

学习如何使用 API-Football 获取球员的详细信息。

players 接口 返回具有可用资料和统计数据的球员信息。需要注意的是，由于球员转会的情况，同一赛季中一名球员可能拥有两支队伍的统计数据。该接口使用分页系统，可通过 page 参数在不同页面间导航。

查询参数

以下查询参数可用于 players 接口：

参数类型分类说明
id整数可选球员的 ID。可通过 players 接口获取球员 ID。
team整数可选球队的 ID。可通过 teams 接口获取球队 ID。
league整数可选联赛的 ID。可通过 leagues 接口获取该 ID。
season整数可选需要查询的赛季年份，格式为 "YYYY"。此参数需与 id、league 或 team 中至少一个字段同时使用。
search字符串可选球员姓名的首字母。至少需要四个字符。此参数需与 league 或 team 中至少一个字段同时使用。
page整数可选用户希望查看的页码。默认值为 1。

使用场景

根据球员姓名搜索球员信息

可以结合使用 team 和 search 参数来获取特定球员的信息。下方的代码块展示了如何进行搜索。点击“运行”按钮即可获取球员信息。

1import requests
2import json
3
4URL = ('https://v3.football.api-sports.io/players?'
5       'search=cavani&'
6       'team=85')  # 85 是巴黎圣日耳曼队的球队 ID
7
8header = {
9    'x-rapidapi-host': "v3.football.api-sports.io",
10    'x-rapidapi-key': "{{API_key}}"
11}
12
13response = requests.request("GET", URL, headers=header).json()
14print(json.dumps(response, indent=4))

我们可以在第 5 行更改球员姓名的首字母，以获取同一球队中其他球员的信息。通过同时修改第 5 行的姓名首字母和第 6 行的球队 ID，还可以获取其他球队球员的信息。

可通过本课程「球队信息」一课中介绍的方法，使用 teams 接口获取球队的 ID。

获取某位球员在一个赛季中的全部统计数据

可以使用 id 和 season 参数来获取某位球员在单个赛季中的详细数据。点击“运行”按钮即可获取球员信息。

1import requests
2import json
3
4URL = ('https://v3.football.api-sports.io/players?'
5       'id=19088&'  # 19088 是迪恩·亨德森的球员 ID
6       'season=2018')
7
8header = {
9    'x-rapidapi-host': "v3.football.api-sports.io",
10    'x-rapidapi-key': "{{API_key}}"
11}
12
13response = requests.request("GET", URL, headers=header).json()
14print(json.dumps(response, indent=4))

我们可以在第 5 行更改球员 ID，以获取其他球员的数据。

获取某支球队在一个赛季中的所有球员统计数据

可以使用 team 和 season 参数来获取某支球队在单个赛季中所有球员的数据。在第 5 行输入球队 ID，在第 6 行输入赛季年份。点击“运行”按钮即可获取球员信息。

1import requests
2import json
3
4URL = ('https://v3.football.api-sports.io/players?'
5       'team=85&'  # 85 是巴黎圣日耳曼队的球队 ID
6       'season=2018')
7
8header = {
9    'x-rapidapi-host': "v3.football.api-sports.io",
10    'x-rapidapi-key': "{{API_key}}"
11}
12
13response = requests.request("GET", URL, headers=header).json()
14print(json.dumps(response, indent=4))

通过修改第 6 行的年份，可以获取其他赛季的数据。

端点：比赛数据

球员：球队阵容