Logo

排名

了解将返回联赛排名信息的接口端点。

概念

排名

了解将返回联赛排名信息的接口端点。

排名接口 返回某个联赛或球队的排名信息。该接口的基础 URI 为 https://v3.football.api-sports.io/standings。

查询参数

此接口的查询参数如下：

参数类型分类描述
league整数可选指定要获取排名的联赛 ID。可通过联赛接口获取该 ID。
season整数必需指定所需排名的年份。
team整数可选指定要获取统计数据的球队 ID。可通过球队接口获取该 ID。

使用此接口时，必须同时提供 season 参数，并与 league 或 team 参数之一配合使用。

使用场景

获取联赛/杯赛的排名

通过结合 league 和 season 参数调用排名接口，可获取指定赛季某联赛的完整排名情况。点击“运行”按钮即可调用该接口。

1import requests
2import json
3
4URL = ('https://v3.football.api-sports.io/standings?'
5       'league=39&'  # 39 是英格兰超级联赛的联赛 ID
6       'season=2019'
7      )
8
9header = {
10    'x-rapidapi-host': "v3.football.api-sports.io",
11    'x-rapidapi-key': "{{API_key}}"
12}
13
14response = requests.request("GET", URL, headers=header).json()
15print(json.dumps(response, indent=4))

您可以在第 5 行更改联赛 ID，在第 6 行更改年份，以获取其他联赛的排名数据。
您可以通过联赛接口获取联赛 ID，具体方法参见课程《后端接口》中的“联赛接口”部分。

获取某支球队的排名

通过结合 season 和 team 参数调用排名接口，可获取指定球队在其所属联赛中的排名情况。

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

您只需在第 6 行更改球队 ID，即可获取其他球队的排名数据。

端点：球队

端点：比赛数据